Demander à l'agent

L’éditeur inclut un agent intégré qui peut modifier des pages, réorganiser la navigation, mettre à jour docs.json, effectuer des recherches dans l’ensemble de votre référentiel et gérer les paramètres du tableau de bord. L’agent de l’éditeur effectue les modifications directement sur votre branche 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). Pour fermer le panneau, cliquez sur le bouton X dans l’en-tête du panneau ou appuyez à nouveau sur Cmd + I.

Envoyer un message

Saisissez votre requête dans la zone de chat en bas du panneau et appuyez sur Enter ou cliquez sur le bouton d’envoi . Tapez @ pour mentionner une page spécifique. L’agent se concentre sur cette page lors du traitement de votre requête. Si vous ne mentionnez pas de page, l’agent utilise la page actuellement 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 en forme de trombone dans la zone de chat, ou faites glisser-déposer des fichiers dans le panneau. L’agent lit les fichiers joints comme contexte pour votre requête. 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. Maximum : 10 fichiers par message.

Ajouter une sélection à l’agent

En mode visuel, sélectionnez du texte sur une page. Une barre d’outils flottante apparaît au-dessus de la sélection. Cliquez sur Add to agent pour envoyer le texte sélectionné à l’agent comme contexte.

Examiner ce que l’agent a modifié

À mesure que l’agent modifie vos pages, un panneau Changed files apparaît dans le chat. Développez-le pour voir la liste de tous les fichiers modifiés au cours de la session. Cliquez sur n’importe quel fichier pour l’ouvrir en vue de comparaison et comparer les modifications de l’agent à l’original.

Ce que l’agent peut faire

Modifier des pages

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

Rechercher et naviguer dans votre contenu

L’agent peut effectuer une recherche dans l’ensemble de votre référentiel, et pas seulement sur la page ouverte. Utilisez-le pour trouver des informations, repérer des incohérences ou vérifier qu’un contenu existe avant de l’ajouter. 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 la configuration docs.json directement, y compris en ajoutant de nouveaux groupes, en ajustant des paramètres et en configurant 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 référentiel. Utilisez cette fonction pour des opérations en masse sur de nombreux fichiers. Exemple : find every page that mentions the deprecated /v1/auth endpoint

Configurer votre site (mode code)

Pour les requêtes qui vont au-delà de la modification de pages (configurer l’authentification, gérer des workflows ou modifier les paramètres de déploiement), l’agent passe en mode code. Il écrit et exécute un script sur votre tableau de bord Mintlify en votre nom. Le mode code respecte vos permissions du tableau de bord. Si vous n’avez pas accès à un paramètre dans le tableau de bord, l’agent ne peut pas non plus le modifier. Exemples de prompts qui utilisent le mode code :

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

Historique des sessions

Cliquez sur l’icône d’horloge dans l’en-tête du panneau pour voir vos précédentes sessions de chat. 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 telles que des règles de voix, de 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 requête sans que vous ayez besoin de les répéter.

​Ouvrir l’agent

​Envoyer un message

​Joindre des fichiers

​Ajouter une sélection à l’agent

​Examiner ce que l’agent a modifié

​Ce que l’agent peut faire

​Modifier des pages

​Rechercher et naviguer dans votre contenu

​Mettre à jour la navigation et docs.json

​Exécuter des commandes bash

​Configurer votre site (mode code)

​Historique des sessions

​Instructions d’IA