Ajouter l'agent à Slack

Ajoutez l’agent Mintlify à Slack pour créer des mises à jour de documentation à partir des conversations, capturer les connaissances de l’équipe et maintenir les docs à jour.

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.

​

Connectez votre espace de travail Slack

1. Accédez à la page 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.

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.

​

Connecter des intégrations supplémentaires depuis Slack

Une fois votre espace de travail Slack connecté, vous pouvez demander à l’agent dans Slack de configurer n’importe quelle intégration tierce qu’il doit utiliser comme contexte. L’agent s’appuie sur Composio pour prendre en charge un large catalogue de services tiers, notamment des outils de suivi des tickets, des bases de connaissances, des CRM et des outils pour développeurs.

GitHub et GitLab ne sont pas configurés via Composio. L’accès aux référentiels est géré par la GitHub App Mintlify ou l’intégration GitLab installée depuis votre tableau de bord. Une fois installée, l’agent peut lire le code source de tout référentiel auquel l’application a accès.

Pour ajouter une nouvelle intégration depuis Slack :

1. Dans un message direct ou dans un fil qui mentionne @mintlify, demandez à l’agent de configurer l’intégration. Par exemple :
   • « Connecte Jira pour que tu puisses lire les tickets. »
   • « Installe l’intégration HubSpot. »
   • « Configure l’intégration Linear. »
2. L’agent répond avec un lien d’autorisation.
3. Cliquez sur le lien, connectez-vous au service tiers et approuvez les autorisations demandées.
4. Retournez dans Slack. L’agent confirme la connexion et peut immédiatement utiliser l’intégration comme contexte pour les futures demandes.

Les intégrations que vous connectez depuis Slack sont définies au niveau de votre utilisateur Slack individuel : chaque coéquipier configure ses propres connexions et l’agent utilise les connexions de la personne qui a envoyé le message. Si un utilisateur Slack n’a pas connecté un service, l’agent se rabat sur les intégrations au niveau de l’organisation installées depuis la page Agent du tableau de bord.

Pour supprimer ou réautoriser une intégration au niveau de l’organisation, utilisez la section Agent settings de la page Agent.

Pour la liste complète des services pris en charge, consultez le catalogue des toolkits Composio.

​

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.
• Partager des liens de pull request (demandes de fusion) avec l’agent pour mettre à jour la documentation associée.

​

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.

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 sur lequel la GitHub App Mintlify est installée, 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.

​

Mémoire personnelle

Lorsque vous posez des questions à l’agent sur vos documents depuis Slack, il retient des informations durables à votre sujet d’un fil à l’autre afin que vous n’ayez pas à vous répéter. La mémoire est personnelle à votre compte d’utilisateur Mintlify et limitée à votre organisation : les autres membres de l’équipe ont leur propre mémoire distincte.

L’agent enregistre une information lorsque vous indiquez quelque chose de stable à votre sujet, par exemple :

• Une préférence de réponse : “Je préfère des réponses en langage clair, sans jargon.”
• Une identité ou un rôle : “Je fais partie de l’équipe support.”
• Une règle de flux de travail : “Redirige les questions des clients vers Plain.”

À chaque nouvelle question, l’agent charge les informations pertinentes dans le contexte avant de répondre, afin que ses réponses reflètent ce que vous lui avez déjà dit.

L’agent n’enregistre pas :

• Les détails éphémères liés à la tâche ou au fil en cours.
• Les informations concernant d’autres personnes ou votre organisation dans son ensemble. Cela relève de vos documents.
• Les données personnelles sensibles, telles que des identifiants, des adresses ou des pièces d’identité.

La mémoire personnelle s’applique lorsque vous posez des questions à l’agent dans Slack. Elle n’est pas utilisée lorsque l’agent capture des connaissances depuis un fil existant pour rédiger une pull request (demande de fusion).

​

Exemple

Dans un fil, indiquez une préférence à l’agent :

@mintlify Je suis ingénieur commercial — quand je pose des questions sur nos API, donne-moi des exemples de requêtes que je peux coller dans un e-mail destiné à un client.

Dans un fil ultérieur, posez une question sur les documents :

@mintlify Comment fonctionne la pagination sur l’endpoint de recherche ?

L’agent se souvient de votre rôle et adapte sa réponse avec des exemples de requêtes prêts à copier, sans que vous ayez besoin de réindiquer votre préférence.

​

Rôles et autorisations

Les capacités de l’agent dans Slack correspondent au rôle 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 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.