Premiers pas
Connexion d'applications externes à vos agents
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
Qu'est-ce qu'une Connexion
Une connexion est un lien signé entre l'un de vos experts et une application externe. Une fois connectée, cet expert peut utiliser les outils de l'application dans une conversation: lire un document, rédiger un message, vérifier un enregistrement. Sans connexion, l'expert n'a pas accès du tout.
Deux points méritent de la précision:
- Une connexion donne accès à cette application, pas à votre compte Kapsule. Les deux ensembles de permissions ne se mélangent jamais.
- Tout ce qui modifie quelque chose dans l'application connectée passe toujours par la même carte de confirmation qu'une modification sur votre compte Kapsule. La lecture est immédiate; l'écriture demande d'abord.
Les connexions se trouvent à Agents, puis Manage Connections, ou accédez directement à /agents/connections. La page d'accueil d'Agents affiche également une carte Connexions avec quelques applications d'exemple.
Quels Experts Peuvent Utiliser Quelles Applications
La liste est délibérément conservatrice, et chaque expert ne voit que les applications dont son rôle a besoin. Certaines sont limitées aux outils en lecture seule même si l'application elle-même peut faire plus:
| Expert | Applications externes accessibles |
|---|---|
| Mara, Business Advisor | Stripe (lecture seule) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (lecture seule) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (lecture seule) |
| Pip, Policy and Docs | Aucune |
Connecter une application ne la confie pas à toute l'équipe. Elle devient disponible uniquement pour les experts dans la ligne ci-dessus.
Connexion d'une Application
- Ouvrez Agents, puis Manage Connections.
- Parcourez l'onglet Popular, basculez vers All Apps, ou tapez dans la boîte de recherche. Chaque carte affiche le nom de l'application et le nombre d'outils qu'elle expose.
- Cliquez sur Connect sur l'application que vous souhaitez. Le bouton devient Opening... pendant que la fenêtre de connexion est préparée.
- Connectez-vous à l'application elle-même et approuvez l'accès qu'elle demande.
- Vous revenez sur la page Connexions avec une confirmation [app] Connected.
Une fois connectée, la carte affiche un badge Connected, l'étiquette du compte sur lequel vous vous êtes connecté, et quand la connexion a été utilisée pour la dernière fois, ou Not used yet.
États des Connexions
| État | Ce que cela signifie | Quoi faire |
|---|---|---|
| Connected | Fonctionnement. Vos experts peuvent l'utiliser. | Rien |
| Pending | La connexion a été commencée mais jamais terminée. | Cliquez sur Finish Connecting |
| Reconnect Needed | L'accès a expiré ou a été retiré du côté de l'application. | Cliquez sur Reconnect |
L'état Reconnect Needed est normal au fil du temps: la plupart des applications font expirer l'accès qu'elles accordent selon un calendrier. La reconnexion le restaure sans rien perdre.
Comment Cela Reste Sûr
La page Connexions énonce le modèle de sécurité en trois lignes, et il vaut la peine de comprendre plutôt que de survoler:
- Géré par un partenaire certifié. La connexion à une application est gérée par notre partenaire d'intégration certifié, qui détient la subvention. Votre mot de passe d'application ne touche jamais Kapsule.
- Confirmation avant action. Les Agents demandent avant d'agir. Tout ce qui change quelque chose nécessite votre approbation d'abord.
- Révocation instantanée. Déconnecter coupe l'accès immédiatement, à la fois ici et avec l'application.
Traitez une connexion comme une clé que vous avez fait couper pour quelqu'un. Connectez les comptes dans lesquels vous souhaitez que vos experts travaillent, pas tous les comptes que vous possédez. Si vous n'êtes pas sûr qu'un expert a besoin d'une application pour faire le travail que vous avez en tête, ne la connectez pas: demandez d'abord, puis connectez.
Déconnexion d'une Application
- Ouvrez Agents, puis Manage Connections.
- Cliquez sur Disconnect sur l'application connectée.
- Une confirmation apparaît: Votre équipe perd l'accès à [app] immédiatement. Tout ce qu'elle a déjà utilisé reste dans vos conversations passées.
- Cliquez sur Disconnect pour confirmer.
L'accès se termine immédiatement. Ce que cela ne fait pas, c'est effacer le contenu de l'application des conversations que vous aviez déjà: si un expert a cité un document dans une conversation la semaine dernière, ce texte est toujours dans la transcription de la conversation. Déconnecter concerne l'accès futur, pas l'effacement rétroactif.
Quand Connexions n'est pas Disponible sur Votre Compte
Si la page Connexions affiche une seule carte calme indiquant Connections Are Not Available Yet, la connexion d'applications externes n'a pas été activée pour votre compte. La carte précise clairement que rien n'est connecté et rien n'a d'accès, ce qui est exactement la vérité dans cet état. Vos experts travaillent toujours; ils ne peuvent simplement pas accéder en dehors de Kapsule.
Le reste d'Agents n'est pas affecté. Les conversations, les Skills et les lectures de compte fonctionnent tous normalement.
En Cas d'Échec
"Permission was not granted, so nothing was connected." Vous avez annulé ou refusé à l'écran d'approbation de l'application. Rien n'a été créé. Cliquez sur Connect à nouveau et approuvez l'accès.
"Connections are unavailable right now. Try again in a moment." Le service d'intégration n'a pas pu être atteint. C'est intentionnellement un défaut fermé: plutôt que d'afficher une liste semi-construite, la page n'affiche rien. Attendez une minute et rechargez.
"Connections could not be loaded." Vos paramètres sont sûrs. Actualisez la page. S'il persiste, ouvrez un ticket de support.
Un expert dit qu'il ne peut pas accéder à une application connectée. Vérifiez le tableau ci-dessus. Chaque expert n'est pas autorisé à utiliser chaque application, et une application connectée pour Cora n'est pas automatiquement disponible pour Mara.
Une connexion reste en attente (Pending). La fenêtre de connexion a été fermée avant qu'elle se termine. Cliquez sur Finish Connecting et terminez-la.
Ce que les Connexions Coûtent
L'utilisation d'une application connectée dans une conversation est comptabilisée comme tout autre travail. Chaque appel qu'un expert fait à une application externe est facturé au poids de l'appel de connexion, qui représente une fraction de ce qu'une longue pièce d'écriture coûte. Les lectures sur votre compte Kapsule restent gratuites. La pondération complète se trouve dans How Agent Credits Work.