mintlify__docs/fr/agent/use-cases.mdx

---
title: "Cas d’usage"
description: "Explorez des exemples concrets d’utilisation de l’agent Mintlify pour automatiser les mises à jour de documentation, capturer des connaissances et maintenir une documentation précise."
keywords: ["workflows de l'agent", "workflows de documentation", "exemples d'automatisation"]
---

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"`. Puis toute autre itération nécessaire.

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

Demandez à l&#39;agent de lancer un projet, puis récupérez la branche qu&#39;il crée et terminez la tâche dans votre environnement local ou dans l&#39;éditeur en ligne. L&#39;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&#39;une pull request (demande de fusion)
</div>

Indiquez à l&#39;agent une pull request spécifique pour générer des notes de version ou des mises à jour du journal des modifications à partir de l&#39;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.

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&#39;agent de passer en revue le contenu existant pour vérifier l&#39;exactitude technique, le style, la grammaire ou d&#39;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-workflows">
  ## Automatiser avec des workflows
</div>

Créez des workflows pour automatiser les tâches récurrentes et les tâches de maintenance réactive, comme la rédaction de journaux des modifications ou la mise à jour du contenu lorsque vous ajoutez de nouvelles fonctionnalités à votre produit.

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

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

Intégrez l&#39;agent à vos outils d&#39;automatisation existants pour mettre automatiquement à jour la documentation lorsque le code change, 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](/fr/api/agent/v2/create-agent-job), [obtenir le statut d'un job](/fr/api/agent/v2/get-agent-job) et [envoyer des messages](/fr/api/agent/v2/send-message).

Lors de la création de jobs via l&#39;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, ou 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.