> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cas d’usage de l’agent Mintlify et exemples

> Explorez des exemples d’utilisation de l’agent Mintlify pour automatiser les mises à jour, capturer le savoir et maintenir une documentation précise.

L’agent vous aide dans de nombreuses tâches liées à la documentation. Ces exemples illustrent plusieurs façons d’intégrer l’agent à votre processus de documentation. Essayez une approche qui corresponde à la façon dont votre équipe travaille aujourd’hui, puis adaptez-la à vos besoins spécifiques.

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

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

Par exemple : `@mintlify Our quickstart page needs a new section on inviting collaborators`. Puis : `@mintlify The new section should be called "Inviting collaborators"`. Effectuez ensuite toute autre itération nécessaire.

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

Demandez à l'agent de lancer un projet, puis récupérez la branche qu'il crée et terminez la tâche dans votre environnement local ou dans l'éditeur en ligne. L'agent peut vous aider à démarrer, puis vous pouvez prendre le relais pour la mener à bien.

Par exemple : `@mintlify Update the quickstart page to include information about inviting collaborators` puis récupérez la branche pour effectuer des modifications supplémentaires par la méthode de votre choix.

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

Lorsque vous fusionnez une pull request (demande de fusion) de fonctionnalité, partagez le lien de la PR avec l’agent pour mettre à jour la documentation correspondante.

Par exemple : `@mintlify This PR adds a new authentication method. Update the docs to include the new auth flow: [PR link]`.

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

Indiquez à l'agent une pull request spécifique. Il générera des notes de version ou des mises à jour du journal des modifications à partir de l'historique des commits.

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

<div id="address-pull-request-review-feedback">
  ## Traiter les retours de revue de pull request
</div>

Partagez le lien de la pull request avec l’agent pour traiter les commentaires des reviewers et les retours de revue de code sur les pull requests de documentation.

Par exemple : `@mintlify Address the review comments on 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 Generate a code example to make the authentication method easier to understand`.

<div id="add-images-or-files-to-your-docs">
  ## Ajouter des images ou des fichiers à votre documentation
</div>

Joignez des fichiers ou des images directement à votre message Slack lorsque vous envoyez une demande à l’agent. L’agent traite la pièce jointe et l’ajoute à la documentation. Les pièces jointes prises en charge incluent les images, les PDF, les SVG et d’autres documents.

Par exemple : `@mintlify Add this diagram to the architecture overview page` avec l’image jointe au message.

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

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

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>

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

Par exemple : `@mintlify Users are getting confused by step 3 in the setup guide. What might be making it unclear?`.

<div id="automate-with-automations">
  ## Automatiser les tâches récurrentes
</div>

Créez des automatisations pour les tâches récurrentes et la maintenance réactive. Elles peuvent rédiger des journaux des modifications ou mettre à jour le contenu lorsque vous ajoutez de nouvelles fonctionnalités à votre produit.

Consultez [Vue d'ensemble des automatisations](/docs/fr/automations/index) pour plus d'informations.

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

Intégrez l'agent à vos outils d'automatisation existants pour mettre automatiquement à jour la documentation lorsque le code change. Vous pouvez également déclencher des revues de contenu ou synchroniser les mises à jour de la documentation sur plusieurs dépôts.

Utilisez les endpoints de l'agent pour [créer des jobs](/docs/fr/api/agent/v2/create-agent-job), [obtenir le statut d'un job](/docs/fr/api/agent/v2/get-agent-job) et [envoyer des messages](/docs/fr/api/agent/v2/send-message).

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


## Related topics

- [Vue d'ensemble des automatisations](/docs/fr/automations/index.md)
- [Exemples](/docs/fr/components/examples.md)
- [Introduction à l'API REST Mintlify](/docs/fr/api/introduction.md)