> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent

> Automatisez les mises à jour de la documentation avec l'agent. Créez des mises à jour à partir de messages Slack, de pull requests ou d'appels API.

<Info>
  L'agent est disponible sur les [offres Pro et Custom](https://mintlify.com/pricing?ref=agent) pour toute personne disposant d'un accès à votre Dashboard.
</Info>

L'agent crée des pull requests (demandes de fusion) avec des modifications proposées pour votre documentation à partir de vos instructions. Lorsque vous envoyez une requête à l'agent, il consulte votre documentation, les dépôts connectés et les messages Slack pour créer du contenu qui suit les bonnes pratiques de rédaction technique et respecte le schéma Mintlify. Accédez à l'agent directement depuis votre Dashboard, dans votre espace de travail Slack, ou intégrez-le dans des applications personnalisées avec l'API.

Utilisez l'agent pour :

* Rédiger du nouveau contenu à partir de vos instructions, de liens vers des pull requests ou de fils de discussion Slack
* Réviser des exemples de code obsolètes et des références d'API
* Rechercher et mettre à jour le contenu existant
* Répondre à des questions sur votre documentation et des sujets de rédaction technique

<div id="use-the-agent-in-the-dashboard">
  ## Utiliser l'agent dans le Dashboard
</div>

Accédez à l'agent depuis votre Dashboard à l'aide du raccourci clavier <kbd>⌘</kbd>+<kbd>I</kbd> (macOS) ou <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux), ou en cliquant sur le bouton **Ask agent**. Le panneau de l'agent est redimensionnable sur ordinateur. Sur les appareils mobiles, l'agent s'ouvre en plein écran.

Le panneau de l'agent comporte trois vues.

* **Chat** : Envoyez des requêtes à l'agent pour mettre à jour votre documentation. L'agent crée des pull requests (demandes de fusion) en fonction de vos instructions et affiche des liens pour consulter les pull requests ou ouvrir les modifications dans l'éditeur web.
* **History** : Parcourez les conversations passées et continuez à travailler sur des demandes précédentes. Cliquez sur une conversation pour la charger dans la vue Chat.
* **Settings** : Configurez les intégrations de l'agent et l'accès au référentiel.

<Tip>
  Démarrez une nouvelle conversation avec l'agent pour chaque tâche. Cela permet de garder le contexte de l'agent ciblé et vous aide à associer les conversations à des projets spécifiques.
</Tip>

<div id="add-the-agent-to-your-slack-workspace">
  ## Ajouter l’agent à votre espace de travail Slack
</div>

Utilisez l’agent dans Slack pour collaborer avec votre équipe sur les mises à jour de la documentation.

<Note>
  Si le propriétaire de votre espace de travail Slack exige l’approbation d’un administrateur pour installer des applications, demandez-lui d’approuver l’application Mintlify avant de la connecter.
</Note>

1. Ouvrez le panneau de l’agent dans votre Dashboard.
2. Cliquez sur le bouton **Settings**.

   <Frame>
     <img src="https://mintcdn.com/anotherhorizon/J4BH3chw5X4BWXwI/images/agent/dashboard-settings-light.png?fit=max&auto=format&n=J4BH3chw5X4BWXwI&q=85&s=b38d93419f324772150682405feed0e9" alt="Le bouton des paramètres en mode clair." className="block dark:hidden" width="668" height="112" data-path="images/agent/dashboard-settings-light.png" />

     <img src="https://mintcdn.com/anotherhorizon/J4BH3chw5X4BWXwI/images/agent/dashboard-settings-dark.png?fit=max&auto=format&n=J4BH3chw5X4BWXwI&q=85&s=a773c798a5c8a4a4d1621e93229ee7d1" alt="Le bouton des paramètres en mode sombre." className="hidden dark:block" width="670" height="112" data-path="images/agent/dashboard-settings-dark.png" />
   </Frame>
3. Dans la section d’intégration à Slack, cliquez sur **Connect**.
4. Suivez les invites Slack pour ajouter l’application `mintlify` à votre espace de travail.
5. Suivez les invites Slack pour lier votre compte Mintlify à votre espace de travail Slack.
6. Vérifiez que l’agent fonctionne correctement et répond lorsque :
   * Vous lui envoyez un message direct.
   * Vous le mentionnez avec `@mintlify` dans un canal.

<div id="connect-your-github-account">
  ## Connectez votre compte GitHub
</div>

Par défaut, l’agent ouvre des pull requests au nom du bot Mintlify. Pour que les pull requests vous soient attribuées, connectez votre compte GitHub sur la page [My profile](https://dashboard.mintlify.com/settings/account) du Dashboard.

<div id="connect-repositories-as-context">
  ## Connecter des dépôts comme contexte
</div>

L’agent ne peut accéder qu’aux dépôts que vous connectez via l’application GitHub Mintlify. Configurez les dépôts auxquels l’agent peut accéder dans le panneau **Settings** de l’agent ou dans les [paramètres de la GitHub App](https://github.com/apps/mintlify/installations/new).

<div id="customize-agent-behavior">
  ## Personnaliser le comportement de l’agent
</div>

Créez un fichier `AGENTS.md` dans votre référentiel pour personnaliser le comportement de l’agent (`Agents.md` est également accepté). L’agent lit ce fichier et suit toutes les instructions que vous y fournissez.

L’agent recherche les fichiers `AGENTS.md` à deux endroits. Il vérifie d’abord le répertoire de documentation, puis la racine du référentiel. Si vous avez des fichiers `AGENTS.md` aux deux emplacements, l’agent utilise le fichier de votre répertoire de documentation.

Ajoutez toutes les instructions que vous souhaitez que l’agent suive. L’agent ajoute ces instructions à son prompt système, de sorte qu’elles s’appliquent à toutes les tâches, que vous utilisiez l’agent dans votre Dashboard, sur Slack ou via l’API.

```markdown Example AGENTS.md file theme={null}
# Documentation agent instructions

## Code examples
- Use TypeScript for all code examples. Our users are primarily TypeScript developers.
- Always include error handling in API call examples.
- Show both success and error response examples for all endpoints.
- Include import statements at the top of code examples.

## API documentation standards
- Every endpoint must document: authentication requirements, rate limits, and common error codes.
- Use real-world parameter values in examples (not foo/bar placeholders).
- Include a complete request/response cycle for each endpoint.

## Style and formatting
- Write for developers with 2-5 years of experience. Don't oversimplify, but explain non-obvious concepts.
- Use active voice and second person ("you").
- Date format: ISO 8601 (YYYY-MM-DD).
- When referencing UI elements, use bold: **Settings** button.

## What to include
- Add prerequisite sections to guides when users need API keys, environment setup, or dependencies.
- Include "Next steps" sections linking to related documentation.
- Add troubleshooting sections for common issues we see in support tickets.
```

<div id="embed-the-agent-via-api">
  ## Intégrer l’agent via l’API
</div>

Utilisez les endpoints de l’agent pour [créer des tâches](/fr/api-reference/agent/create-agent-job), [récupérer une tâche spécifique](/fr/api-reference/agent/get-agent-job) et [récupérer toutes les tâches](/fr/api-reference/agent/get-all-jobs).

Lors de la création de tâches via l’API, vous pouvez contrôler si des pull requests (demandes de fusion) sont créées en mode brouillon à l’aide du paramètre `asDraft` (dont la valeur par défaut est `true`). Définissez `asDraft: false` pour créer des pull requests (demandes de fusion) non brouillon, prêtes pour une revue immédiate et une fusion immédiates dans des workflows automatisés.

<div id="write-effective-prompts">
  ## Rédiger des prompts efficaces
</div>

Considérez l’agent comme un assistant utile qui a besoin de vos indications pour accomplir des tâches. Donnez-lui des instructions claires et du contexte. Les tâches plus ciblées sont plus faciles à réaliser : décomposez donc les projets complexes en étapes plus petites.

Formulez des prompts spécifiques et orientés vers les résultats. Des prompts génériques comme `@mintlify Improve the onboarding page` appliquent les bonnes pratiques générales, mais peuvent ne pas améliorer le contenu de la manière précise que vous aviez en tête.

Essayez des prompts fondés sur les résultats que vous souhaitez que vos utilisateurs atteignent ou sur les problèmes qu’ils rencontrent. Par exemple :

* `@mintlify A lot of users have trouble installing the CLI. Review the onboarding page and update the docs so that users can easily install the CLI`
* `@mintlify Developers keep getting 401 errors when following our authentication guide. Review the auth docs and add clearer examples showing how to properly format the API key`

Utilisez des prompts plus larges pour la maintenance générale du contenu, comme corriger les fautes de frappe, mettre à jour les redirections ou renommer une fonctionnalité dans l’ensemble de votre documentation. Par exemple :

* `@mintlify Find and fix all typos in the docs`
* `@mintlify change all unordered lists to use * instead of -`

<div id="specify-a-domain-name">
  ## Spécifier un nom de domaine
</div>

Si vous avez plusieurs sites de documentation, incluez le paramètre `subdomain` dans votre message pour indiquer sur quel ensemble de documentation l’agent doit travailler.

Pour trouver votre nom de domaine, regardez l’URL de votre tableau de bord pour l’ensemble de documentation que vous souhaitez mettre à jour. Le nom de domaine est la dernière partie après le nom de votre organisation. Par exemple, si l’URL de votre tableau de bord est `https://dashboard.mintlify.com/org-name/domain-name`, votre nom de domaine est `domain-name`.

Utilisez le format `@mintlify subdomain=<your-domain-name> <your-prompt>` pour demander à l’agent de travailler sur un ensemble de documentation spécifique.

Exemples :

* `@mintlify subdomain=public-docs Add a new section to the quickstart about inviting collaborators based on this PR` : demande à l’agent de mettre à jour le quickstart uniquement sur le site `public-docs`.
* `@mintlify subdomain=customer-docs Update the auth docs for the new authentication method` : demande à l’agent de mettre à jour la documentation d’authentification uniquement sur le site `customer-docs`.

<div id="agent-workflows">
  ## Workflows de l’agent
</div>

L’agent prend en charge de nombreuses tâches liées à la documentation. Ces workflows illustrent différentes manières d’intégrer l’agent à votre processus de documentation. Adoptez une approche qui correspond au fonctionnement actuel de votre équipe et adaptez-la à vos besoins spécifiques.

<div id="iterate-on-a-prompt-in-a-slack-thread">
  ### Itérer sur une invite dans un fil Slack
</div>

Envoyez une invite à l’agent, puis continuez à le mentionner avec `@mintlify` dans le même fil pour affiner et itérer sur la pull request (demande de fusion) qu’il crée.

Par exemple : `@mintlify Notre page de démarrage rapide a besoin d’une nouvelle section sur l’invitation de collaborateurs`. Puis : `@mintlify La nouvelle section devrait s’appeler "Inviter des collaborateurs"`. Suivi de toute autre itération.

<div id="start-with-the-agent-finish-manually">
  ### Commencez avec l’agent, terminez manuellement
</div>

Demandez à l’agent de lancer un projet, puis basculez vers la branche qu’il crée et terminez la tâche dans votre environnement local ou dans l’éditeur web. L’agent peut vous aider à démarrer, puis vous pouvez prendre le relais pour finaliser la tâche.

Par exemple : `@mintlify Update the quickstart page to include information about inviting collaborators` puis basculez sur la branche pour apporter des modifications supplémentaires avec votre méthode préférée.

<div id="update-docs-when-merging-feature-changes">
  ### Mettre à jour la documentation lors de la fusion de changements de fonctionnalité
</div>

Lorsque vous fusionnez une pull request de fonctionnalité, partagez le lien de la PR avec l’agent pour mettre à jour la documentation concernée.

Par exemple : `@mintlify Cette PR ajoute une nouvelle méthode d’authentification. Mettez à jour la doc pour inclure le nouveau flux d’authentification : [lien de la PR]`.

<div id="generate-release-notes-from-a-pull-request">
  ### Générer des notes de version à partir d’une pull request (demande de fusion)
</div>

Demandez à l’agent de générer, à partir d’une pull request donnée, des notes de version ou de mettre à jour le journal des modifications en se basant sur l’historique des commits.

Par exemple : `@mintlify Generate release notes for this PR: [PR link]`.

<div id="generate-code-examples">
  ### Générer des exemples de code
</div>

Demandez à l’agent de générer des exemples de code pour des fonctionnalités dans toute votre documentation ou sur des pages spécifiques.

Par exemple : `@mintlify Génère un exemple de code pour rendre la méthode d’authentification plus facile à comprendre`.

<div id="review-existing-content">
  ### Passer en revue le contenu existant
</div>

Demandez à l’agent de vérifier le contenu existant pour en évaluer l’exactitude technique, le style, la grammaire ou d’autres problèmes.

Par exemple : `@mintlify Review the API rate limiting section. We changed limits last month`.

<div id="respond-to-user-feedback">
  ### Répondre aux retours des utilisateurs
</div>

Transmettez à l’agent les retours de vos utilisateurs pour apporter des mises à jour ciblées à votre documentation.

Par exemple : `@mintlify Les utilisateurs se perdent à l’étape 3 du guide d’installation. Qu’est-ce qui pourrait la rendre peu claire ?`.

<div id="automate-with-the-api">
  ### Automatisez avec l'API
</div>

Intégrez l'agent à vos outils d'automatisation existants pour mettre automatiquement à jour la documentation lors de modifications du code, déclencher des relectures de contenu ou synchroniser les mises à jour de la documentation entre plusieurs dépôts.

Découvrez comment faire dans le tutoriel [Mettre à jour automatiquement la documentation lorsque du code est fusionné](/fr/guides/automate-agent).