Passer au contenu principal
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. Ouvrez le panneau de l’agent dans votre Dashboard.
  2. Cliquez sur le bouton Settings.
    Le bouton des paramètres en mode clair.
  3. Dans la section d’intégration à Slack, cliquez sur Connect.
  4. Suivez les instructions Slack pour ajouter l’application mintlify à votre espace de travail.
  5. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace de travail Slack.
  6. Vérifiez que l’agent fonctionne et répond lorsque vous :
    • Lui envoyez un message direct.
    • Le mentionnez avec @mintlify dans un canal.

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

​
Déconnectez votre espace de travail Slack

Pour supprimer l’intégration Slack :
  1. Ouvrez le panneau de l’agent dans votre Dashboard.
  2. Cliquez sur le bouton Settings.
  3. Dans la section d’intégration à Slack, cliquez sur Disconnect.
  4. Confirmez la suppression lorsque vous y êtes invité.
La déconnexion supprime l’application Mintlify de votre espace de travail Slack et dissocie tous les comptes utilisateurs connectés.

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