Skip to main content
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 de l’éditeur applique ses modifications directement sur votre branch actuelle.

​
Ouvrir l’agent

Cliquez sur Ask agent dans la barre d’outils de l’éditeur, ou appuyez sur Cmd + I (macOS) ou Ctrl + I (Windows). L’agent est disponible pour les editors et les admins. Les viewers ne voient pas le bouton Ask agent. Saisissez @ pour mentionner une page précise et l’agent se concentre dessus. Sans mention, il utilise la page que vous avez ouverte. 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"

​
Joindre des fichiers

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. Maximum : 10 fichiers par message. Mintlify retire les scripts et les autres contenus actifs des fichiers SVG avant que l’agent ne les lise.

​
Ajouter une sélection à l’agent

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.

​
Demander des commentaires et des suggestions

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.

​
Vérifier ce que l’agent a modifié

Un panneau Changed files apparaît dans le chat pendant que l’agent travaille. Développez-le 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 le bouton d’abandon à côté d’un fichier dans le panneau Changed files, ou abandonnez toutes les modifications de la session.

​
Ce que l’agent peut faire

​
Modifier des pages

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.

​
Rechercher et parcourir votre contenu

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.

​
Mettre à jour la navigation et docs.json

L’agent peut ajouter, renommer, réordonner et supprimer des éléments de navigation, 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 des 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

​
Exécuter des commandes bash

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

​
Configurer votre site (code mode)

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

​
Poursuivre une exécution d’automatisation

Lorsque vous ouvrez l’éditeur depuis un résultat d’automatisation en cliquant sur Preview, le panneau de l’agent s’ouvre automatiquement avec le contexte de ce qu’a fait l’automatisation. Une carte Changed 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.

​
Historique des sessions

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é.

​
Instructions d’IA

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.

Sujets connexes

Ajouter l'agent à SlackCollaborer dans l'éditeurPersonnaliser le comportement de l'agent