> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Ajouter l'agent à Slack
> Installez l'agent Mintlify dans Slack pour poser des questions, transformer les conversations d'équipe en mises à jour et capturer le savoir en PR.
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.
Utilisez l'agent dans Slack pour mettre à jour votre contenu, poser des questions et capturer les connaissances de l'équipe. Mentionnez l'agent dans un canal pour l'utiliser de manière collaborative, ou envoyez-lui un message direct pour l'utiliser en privé.
Cette page explique comment ajouter l'agent en tant que bot à votre espace de travail Slack. Pour donner à l'agent l'accès au contenu des canaux Slack en tant que source de données, consultez [Intégrations de l'agent](/fr/agent/integrations).
## Connectez votre espace de travail Slack
1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
2. Dans la section "Agent settings", cliquez sur **Install Slack app**.
3. Suivez les instructions Slack pour installer l'application `mintlify` dans votre espace de travail.
4. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace de travail Slack.
5. Vérifiez que l'agent fonctionne et répond lorsque vous :
* Envoyez un message direct à l'agent.
* Mentionnez l'agent avec `@mintlify` dans un canal.
Chaque espace de travail Slack ne peut être connecté qu'à une seule organisation Mintlify à la fois. Si vous tentez d'installer l'agent dans un espace de travail déjà connecté à une autre organisation, l'installation échoue avec une erreur « wrong organization ». Désinstallez d'abord l'application de l'autre organisation, ou utilisez un autre espace de travail Slack.
Vous pouvez installer l'agent Slack même si vous n'avez pas de déploiement hébergé par Mintlify. L'agent fonctionne toujours pour répondre aux questions et tenir des conversations. Les fonctionnalités qui ouvrent des pull requests nécessitent un dépôt connecté.
Sur Slack Enterprise Grid, installer l'application au niveau de votre organisation ne suffit pas. Vous devez également l'installer dans l'espace de travail spécifique où vous souhaitez utiliser l'agent. Si vous omettez cette étape, l'agent apparaît comme disponible au niveau de l'organisation, mais ne répond pas dans votre espace de travail.
Pour ajouter l'application à un espace de travail, ouvrez la page de gestion des applications de votre organisation à une URL telle que `https://app.slack.com/manage//integrations/installed`, trouvez l'application `mintlify` et installez-la dans votre espace de travail.
### Reconnecter ou réinstaller l'agent
Si vous devez réautoriser l'agent — par exemple, pour accorder de nouvelles permissions après une mise à jour des scopes Slack ou pour récupérer après la révocation d'un jeton — réinstallez l'application depuis votre dashboard Mintlify.
Lorsque vous réinstallez l'agent dans un espace de travail déjà connecté à votre organisation, Mintlify met à jour le bot token stocké sur place. Vos canaux, fils de discussion et intégrations par utilisateur existants restent intacts.
Si votre organisation dispose de plusieurs déploiements, l'agent vous demande de choisir avec quel déploiement travailler la première fois que vous envoyez une demande.
Votre déploiement préféré est propre à votre compte Slack et n'affecte pas
les autres membres de l'équipe. Vous pouvez passer à un autre déploiement à tout
moment pendant une conversation en cliquant sur le bouton **Switch deployment** dans
le message de statut de l'agent dans le fil. L'agent conserve votre historique de
conversation afin que vous puissiez reprendre là où vous en étiez avec le nouveau
déploiement.
## Utiliser l'agent dans Slack
Une fois connecté, vous pouvez :
* Envoyer des messages directs à l'agent pour l'utiliser en privé afin de mettre à jour votre documentation.
* Mentionner `@mintlify` dans un canal pour l'utiliser publiquement et de manière collaborative.
* Joindre des fichiers et des images directement à vos messages pour que l'agent les analyse et les intègre à votre documentation.
* Poursuivre les conversations dans des fils pour affiner les modifications ou poser des questions de suivi. L'agent réutilise les fichiers, images et réactions emoji partagés plus tôt dans le fil comme contexte pour les demandes suivantes, vous n'avez donc pas besoin de les téléverser à nouveau.
* Partager des liens de pull request (demandes de fusion) avec l'agent pour mettre à jour la documentation associée.
## Poser des questions sur votre documentation
Posez à l'agent des questions sur votre produit ou votre documentation et recevez les réponses dans le fil.
* **Nouvelle question** : Envoyez un message direct à l'agent ou mentionnez `@mintlify` dans un canal avec votre question.
* **Fil existant** : Répondez dans le fil et mentionnez `@mintlify` avec une question de suivi.
Exemples de questions :
* « Quelles pages mentionnent la limite de débit de l'API ? »
* « Comment configurer l'authentification ? »
* « Comment est structurée notre navigation ? »
## Mettre à jour la documentation
Utilisez l'agent pour mettre à jour votre documentation au moyen d'une nouvelle demande ou dans un fil existant.
* **Nouvelle demande** : Envoyez un message direct à l'agent ou mentionnez `@mintlify` dans un canal avec des instructions sur ce qu'il faut mettre à jour.
* **Fil existant** : Répondez dans le fil et mentionnez `@mintlify` avec des instructions sur ce qu'il faut mettre à jour.
* **Avec des pièces jointes** : Téléversez des images, des diagrammes, des fichiers de code ou d'autres documents avec votre message. L'agent les traite automatiquement et les inclut dans votre documentation. Dans un fil, l'agent a accès aux images et fichiers partagés dans les messages précédents, vous pouvez donc y faire référence dans les demandes suivantes sans avoir à les téléverser à nouveau.
L'agent lit le contexte de la demande ou du fil et crée une pull request (demande de fusion) dans votre référentiel connecté avec les mises à jour.
## Référencer d'autres dépôts
L'agent peut lire le code source de n'importe quel dépôt connecté via la [GitHub app](/fr/deploy/github) ou l'[intégration GitLab](/fr/deploy/gitlab), même s'il ne s'agit pas de votre dépôt de documentation. Cela lui permet de construire un contexte plus approfondi pour guider les mises à jour de la documentation.
Lorsque vous mentionnez un autre dépôt dans votre demande, l'agent le clone à la demande et examine les fichiers pertinents avant de rédiger les modifications.
Exemples de prompts :
* « Mettez à jour le guide d'authentification en fonction des changements dans `acme/api-server/src/auth.ts`. »
* « Documentez les nouveaux endpoints ajoutés dans `acme/backend#1234`. »
* « À quels dépôts avez-vous accès ? »
Les dépôts clonés sont en lecture seule. L'agent les utilise comme contexte, mais ouvre toujours des pull requests (demandes de fusion) sur votre dépôt de documentation.
## Suivez la progression en temps réel
Pendant que l'agent travaille sur votre demande, il fournit un retour en direct dans le fil Slack.
* **Mises à jour de statut** : Un message mis à jour en direct indique ce que l'agent est en train de faire, comme le nombre de fichiers qu'il a recherchés, lus et modifiés.
* **Progression des tâches** : Lorsque l'agent décompose votre demande en plusieurs tâches, il affiche une liste de contrôle pour que vous puissiez suivre la progression de chacune.
* **Questions** : Si l'agent a besoin de plus d'informations, il présente des options parmi lesquelles vous pouvez choisir ou vous pouvez répondre dans le fil avec une réponse personnalisée.
* **Demandes d'autorisation** : Avant que l'agent n'exécute une action tierce qui écrit des données, comme envoyer un e-mail ou créer un ticket, il vous demande d'approuver ou de refuser l'action. La carte d'approbation est envoyée sous forme de message éphémère visible uniquement par vous, la personne qui a déclenché la demande, afin de ne pas interrompre les autres participants du fil. Cliquez sur **Approve** pour laisser l'agent continuer ou sur **Deny** pour annuler l'action.
* **Interruptions** : Si vous envoyez un message de suivi pendant que l'agent travaille encore, il arrête la tâche en cours et commence la nouvelle.
* **Achèvement** : Lorsque l'agent a terminé, il publie un résumé avec un lien vers la pull request (demande de fusion) et un lien pour ouvrir les modifications dans l'éditeur web.
## Rôles et autorisations
Les capacités de l'agent dans Slack correspondent au [rôle](/fr/dashboard/roles) du compte Mintlify associé :
* **Administrateurs et éditeurs** : Peuvent poser des questions et apporter des modifications à la documentation. L'agent a accès aux outils d'édition de fichiers et de pull requests.
* **Lecteurs** : Peuvent uniquement poser des questions. L'agent fonctionne en mode lecture seule, donc les outils d'édition de fichiers, de commit et de pull request ne sont pas disponibles. Les intégrations tierces sont filtrées sur les actions en lecture seule. Si un lecteur demande à l'agent d'apporter une modification, celui-ci explique la limitation et suggère de demander à un coéquipier éditeur ou administrateur.
Pour modifier les autorisations d'un coéquipier, mettez à jour son rôle depuis la page [Members](https://dashboard.mintlify.com/settings/organization/members) de votre Dashboard.
## Bonnes pratiques
* **Soyez précis** : Indiquez exactement à l’agent ce que vous souhaitez documenter et où cela doit être ajouté.
* **Ajoutez du contexte** : Si un fil de discussion ne contient pas toutes les informations nécessaires, ajoutez des détails supplémentaires dans votre message à l’agent.
* **Relisez attentivement** : Vous devez toujours relire les pull requests (demandes de fusion) créées par l’agent avant de les fusionner.