Intégrations de l'agent

Connectez Slack, Notion, Linear, Jira, Confluence et d’autres apps pour que l’agent utilise le contexte en direct lors des réponses et mises à jour.

Les intégrations de l’agent donnent à l’agent l’accès au contexte d’autres outils utilisés par votre équipe. Une fois connectées, l’agent peut rechercher dans les fils Slack, lire des pages Notion, consulter des tickets Linear et récupérer du contexte depuis d’autres applications pour étayer ses réponses et ses mises à jour de contenu.

​

Portée de la connexion

Les intégrations se connectent de l’une des deux façons suivantes :

• Les intégrations partagées sont connectées une seule fois pour toute votre organisation. N’importe quel membre de l’équipe peut demander à l’agent de les utiliser. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom et Plain se connectent toutes de cette manière.
• Les intégrations personnelles sont connectées par utilisateur. Chaque coéquipier autorise son propre compte, et l’agent ne peut utiliser une intégration personnelle qu’au nom de l’utilisateur qui l’a connectée. Google Calendar est personnelle.

Les intégrations personnelles maintiennent les données propres à un utilisateur, comme les événements de calendrier, limitées à l’utilisateur qui a connecté l’intégration, plutôt que partagées à l’échelle de l’organisation.

​

Connecter une intégration

1. Accédez à la page Intégrations de l’agent de votre tableau de bord.
2. Repérez l’intégration que vous souhaitez connecter.
3. Cliquez sur Connect.
4. Suivez les invites OAuth pour autoriser Mintlify à accéder à votre compte.

Certaines intégrations ouvrent une étape de configuration supplémentaire avant que la connexion ne se termine. Jira, Confluence et Salesforce demandent l’URL ou le sous-domaine de votre espace de travail avant le démarrage du flux OAuth, et les fournisseurs reposant sur une clé API, comme Plain, vous invitent à coller une clé API.

Les administrateurs et les éditeurs peuvent connecter les intégrations partagées au nom de l’organisation. Chaque coéquipier connecte les intégrations personnelles individuellement : connecter Google Calendar ne l’active que pour vos propres invites, pas pour le reste de votre organisation.

​

Intégrations prises en charge

Intégration	Portée
Confluence	Partagée
Google Calendar	Personnelle
Intercom	Partagée
Jira	Partagée
Linear	Partagée
Notion	Partagée
Plain	Partagée
Salesforce	Partagée
Slack	Partagée

​

Comment l’agent utilise les intégrations

L’agent utilise les intégrations connectées comme des outils. Lorsque vous posez une question à l’agent ou que vous lui confiez une tâche, il peut rechercher et récupérer du contenu depuis vos applications connectées pour construire le contexte.

Par exemple :

• “Résume le fil Slack sur la migration de l’API v2 et rédige-le pour la base de connaissances.”
• “Consulte le ticket Linear pour cette fonctionnalité et documente son comportement.”
• “Qu’a décidé l’équipe au sujet de la limitation du débit ? Vérifie Slack.”

L’agent n’accède aux données des intégrations que lorsqu’elles sont pertinentes pour la demande. Il ne lit pas les applications connectées de manière proactive.

​

Autorisations et accès

Chaque intégration demande les scopes OAuth (ou les autorisations de clé API) dont elle a besoin pour rechercher et récupérer du contenu depuis l’application connectée. Mintlify demande des scopes en lecture seule chaque fois que le fournisseur en propose.

Examinez les scopes exacts sur l’écran de consentement OAuth avant d’autoriser la connexion. L’écran de consentement liste toutes les autorisations dont disposera l’agent, et vous pouvez révoquer la connexion à tout moment depuis le tableau de bord ou depuis les paramètres d’intégrations de l’application connectée elle-même.

Si votre organisation restreint les applications que les utilisateurs peuvent autoriser, demandez à l’administrateur concerné (comme votre administrateur Slack ou Google Workspace) d’autoriser l’intégration Mintlify avant de la connecter.

​

Ce que l’agent peut lire dans chaque application

L’agent hérite de l’accès du compte qui a autorisé la connexion. Il ne peut lire que le contenu auquel l’utilisateur autorisant (pour les intégrations personnelles) ou le compte de l’espace de travail connecté (pour les intégrations partagées) a déjà accès dans l’application source.

Intégration	Contenu auquel l’agent peut accéder
Confluence	Pages et pièces jointes des espaces que le compte connecté peut lire
Google Calendar	Événements des calendriers que l’utilisateur connecté peut consulter
Google Drive	Fichiers et dossiers que l’utilisateur connecté peut consulter, y compris les drives partagés
HubSpot	Enregistrements CRM (contacts, entreprises, deals, tickets) que le compte connecté peut lire
Intercom	Conversations, contacts et articles du centre d’aide que le compte connecté peut lire
Jira	Tickets et commentaires des projets que le compte connecté peut lire
Linear	Tickets, projets et commentaires des équipes que le compte connecté peut lire
Notion	Pages et bases de données explicitement partagées avec l’intégration Mintlify
Plain	Fils et enregistrements clients accessibles avec la clé API fournie
Salesforce	Objets standard et personnalisés que le compte connecté peut lire
Slack	Canaux publics auxquels l’espace de travail donne accès, plus les canaux privés auxquels l’application Mintlify est invitée

Pour réduire ce que l’agent peut voir, restreignez les autorisations du compte connecté dans l’application source (par exemple, invitez l’application Slack Mintlify uniquement dans des canaux spécifiques, ou ne partagez que des pages Notion sélectionnées avec l’intégration).

​

Conservation des données après déconnexion

Lorsque vous déconnectez une intégration, l’agent perd immédiatement la capacité de lire depuis cette application. Mintlify ne conserve pas de copie durable du contenu d’intégration — l’agent récupère les données à chaque requête via le jeton OAuth ou la clé API en direct, donc la déconnexion coupe tout accès futur.

Le contenu qui est apparu dans les réponses passées de l’agent ou dans des pull requests reste en place (transcriptions de chat, pages publiées, historique de PR). Si vous souhaitez également que ce contenu soit supprimé, éditez ou supprimez directement les pages et les conversations.

​

Dépanner une connexion en échec

Si une intégration cesse de fonctionner ou affiche une erreur dans le tableau de bord, le jeton OAuth sous-jacent a généralement expiré, a été révoqué dans l’application connectée ou a vu ses scopes requis modifiés.

Pour rétablir l’accès :

1. Accédez à la page Intégrations de l’agent de votre tableau de bord.
2. Repérez l’intégration concernée et cliquez sur Configure.
3. Cliquez sur Disconnect, puis sur Connect à nouveau, et complétez le flux OAuth.

Pour les fournisseurs reposant sur une clé API comme Plain, générez une nouvelle clé API dans l’application source et collez-la dans la configuration de l’intégration. Si l’agent ne parvient toujours pas à accéder aux données après la reconnexion, vérifiez que l’utilisateur qui autorise dispose des autorisations nécessaires pour consulter le contenu pertinent dans l’application source.

​

Déconnecter une intégration

1. Accédez à la page Intégrations de l’agent de votre tableau de bord.
2. Repérez l’intégration connectée que vous souhaitez déconnecter.
3. Cliquez sur Configure.
4. Cliquez sur Disconnect.

La déconnexion d’une intégration partagée la supprime pour tous les membres de votre organisation, et l’agent perd immédiatement l’accès à cet outil.

La déconnexion d’une intégration personnelle ne supprime que votre propre connexion. Les autres coéquipiers qui ont connecté la même intégration conservent leur accès, et l’agent peut continuer à utiliser l’intégration en leur nom.