Interroger l'agent

L’éditeur intègre un agent capable de modifier des pages, de réorganiser la navigation, de mettre à jour docs.json, de faire des recherches dans tout votre dépôt et de gérer les paramètres du dashboard. L’agent est aussi disponible sur les pages de paramètres du dashboard.

L’agent de l’éditeur applique ses modifications directement sur votre branch actuelle. Comme vos propres modifications, celles de l’agent sont enregistrées automatiquement, mais elles n’atteignent votre site publié que lorsque vous les publiez.

Cliquez sur Ask agent dans la barre d’outils de l’éditeur, ou appuyez sur Cmd + I (macOS) ou Ctrl + I (Windows) lorsqu’aucun texte n’est sélectionné. Vous pouvez aussi ouvrir l’agent sur les pages de paramètres du dashboard. Votre session de chat reste ouverte lorsque vous passez de l’éditeur aux paramètres.

Saisissez @ pour mentionner une page précise dans un prompt et l’agent se concentre dessus. Sans mention, l’agent utilise la page que vous avez ouverte comme contexte initial. Dans votre dashboard, l’agent sait quelle page vous consultez, ce qui vous permet de l’interroger sur la page actuelle sans la nommer.

Exemples de prompts :

• simplify the introduction page
• fix all grammar errors across my content
• add a new page that explains authentication
• rename every mention of "Acme Pro" to "Acme Team" across all pages
• update docs.json to add a new group called "Guides"

Cliquez sur l’icône du trombone dans la zone de chat, ou faites glisser des fichiers sur le panneau. L’agent lit les fichiers joints comme contexte pour votre demande.

Types de fichiers pris en charge :

• Images : JPG, PNG, GIF, WebP, SVG
• Documents : PDF
• Code et texte : .js, .ts, .jsx, .tsx, .mdx, .md, .json, .yaml, .html, .css, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts shell et plus encore

Taille maximale : 5 Mo par fichier, sauf pour les fichiers SVG, limités à 256 Ko par Mintlify. Maximum : 10 fichiers par message.

Mintlify retire les scripts et les autres contenus actifs des fichiers SVG avant que l’agent ne les lise.

En mode visuel, sélectionnez du texte et cliquez sur Add to agent dans la barre d’outils flottante pour l’envoyer à l’agent comme contexte.

Par défaut, l’agent modifie le contenu directement. Pour obtenir un retour sans modifier la page tout de suite, demandez-lui explicitement de relire la page, de laisser des commentaires ou de faire des suggestions.

• Les suggestions proposent un remplacement précis que vous pouvez accepter ou refuser. Le texte d’origine reste visible barré jusqu’à votre décision, et l’agent peut joindre une explication au fil de la suggestion.
• Les commentaires laissent un retour ou une question ancrée à un texte précis sans modifier la page.

Exemples de prompts :

• review this page and leave suggestions
• comment on anything that needs more context
• suggest ways to make the introduction more concise

L’agent utilise la page que vous avez ouverte, sauf si vous en nommez une autre. Il peut annoter le texte rendu de la page, y compris la prose à l’intérieur des composants. Il ne peut pas annoter le frontmatter, les métadonnées de page, la configuration, ni les balises et attributs MDX bruts.

Une liste des fichiers modifiés apparaît dans le chat pendant que l’agent travaille. Développez-la pour voir tous les fichiers modifiés au cours de la session, et cliquez sur l’un d’eux pour comparer les modifications à l’original en vue diff.

Pour annuler les modifications de l’agent, cliquez sur Discard changes à côté d’un fichier, ou sur Discard all pour annuler toutes les modifications de la session. Pour annuler les modifications d’une seule réponse, cliquez sur Undo changes sur ce message. Cliquez sur Redo changes pour les rétablir.

L’agent peut rédiger, réécrire, développer et réorganiser le contenu de n’importe quelle page. Il lit votre contenu existant pour s’aligner sur votre style et votre structure.

L’agent peut faire des recherches dans tout votre dépôt, pas seulement dans la page ouverte. Utilisez-le pour trouver une information, repérer des incohérences ou vérifier qu’un contenu existe déjà avant d’en ajouter.

L’agent peut ajouter, renommer, réordonner et supprimer des éléments de navigation. Ce sont les mêmes modifications que vous feriez manuellement dans le panneau de navigation. Il peut aussi mettre à jour directement la configuration de docs.json, y compris ajouter de nouveaux groups, ajuster des paramètres et configurer des redirections.

Exemple : add a "Quickstart" group under the Getting Started tab and move the quickstart page into it

L’agent peut exécuter grep, rg et d’autres commandes bash sur votre dépôt. Utilisez-le pour des opérations en masse qui couvrent de nombreux fichiers.

Exemple : find every page that mentions the deprecated /v1/auth endpoint

Pour les demandes qui vont au-delà de la modification de pages (configurer l’authentification, gérer des workflows ou modifier les paramètres du deployment), l’agent passe en code mode. Il écrit et exécute un script sur votre dashboard Mintlify en votre nom.

Le code mode respecte vos permissions sur le dashboard. Si vous n’avez pas accès à un paramètre dans le dashboard, l’agent ne peut pas le modifier non plus.

Exemples de prompts qui utilisent le code mode :

• enable JWT authentication for my site
• create a workflow that updates my site when I merge a PR
• add a custom domain

L’agent de l’éditeur peut utiliser les applications tierces connectées via Intégrations comme outils en lecture seule pendant qu’il recherche, modifie des pages ou répond à vos questions.

• Intégrations partagées sont disponibles pour toute votre organisation.
• Intégrations personnelles utilisent le compte connecté par la personne qui discute avec l’agent. Par exemple, une recherche Google Drive utilise votre propre connexion Drive.

Demandez à l’agent d’utiliser une application connectée naturellement dans votre requête, par exemple :

• update the migration guide based on the latest Jira issue
• check what the Notion launch brief says about availability and add it to the release notes page

Si l’intégration dont vous avez besoin n’est pas encore connectée, demandez à l’agent de la connecter. L’agent renvoie un lien d’autorisation. Suivez le flux, puis envoyez un autre message pour que l’agent confirme la connexion et poursuive.

L’agent peut répondre à des questions sur les données de trafic, de recherche, d’assistant et de retours de votre documentation. L’agent renvoie les informations sous forme de texte, de graphique ou de liste classée. Utilisez l’agent pour demander des explications précises, comparer les performances des pages ou analyser les évolutions du trafic.

Exemples de prompts :

• what are the top 5 user agents hitting my site?
• which pages do AI agents visit more often than humans?
• what are people searching for and not finding results for?
• graph traffic for the REST API introduction page over the last month

Si vous installez l’application Slack Mintlify, l’agent de l’éditeur peut lire votre espace de travail Slack comme contexte pendant qu’il effectue des recherches ou répond à vos questions. L’agent de l’éditeur dispose d’un accès en lecture seule. Il ne peut pas publier de messages, ajouter de réactions ni effectuer d’autres actions dans Slack.

Demandez à l’agent d’utiliser Slack dans une requête. Par exemple :

• check the #engineering channel for context on the new auth flow
• summarize what the team decided about rate limiting yesterday

Si vous n’avez pas installé l’application Slack, demandez à l’agent de la connecter pour vous. L’agent renvoie un lien d’autorisation et vous guide tout au long du processus d’installation.

Lorsque vous ouvrez l’éditeur depuis la notification Slack ou l’e-mail d’une automatisation, le panneau de l’agent s’ouvre automatiquement avec le contexte de ce qu’a fait l’automatisation. Une carte Updated pages en haut du chat liste toutes les pages modifiées par l’automatisation. Cliquez sur une page pour ouvrir une vue diff.

L’agent dispose du prompt de l’automatisation, d’un résumé des modifications effectuées et de la liste des pages concernées. Vous pouvez lui demander d’affiner ou de prolonger son travail sans avoir à réexpliquer le contexte.

Par exemple : The new section on rate limits is too long. Trim it to three sentences.

Cliquez sur l’icône d’horloge dans l’en-tête du panneau pour voir vos sessions de chat précédentes. Cliquez sur une session pour la rouvrir et voir ce que l’agent a modifié. Pour recommencer, cliquez sur New chat.

Pour donner à l’agent des consignes persistantes, comme des règles de voix, une terminologie ou des conventions de mise en forme, configurez des instructions d’IA dans les paramètres de l’éditeur. L’agent suit ces instructions à chaque demande sans que vous ayez à les répéter.