Dépanner les connexions
Un connecteur qui fonctionnait hier et échoue aujourd’hui s’est généralement heurté à l’une de cinq causes. Cette page les passe en revue, dans l’ordre où elles se présentent.
Commencez ici
Section intitulée « Commencez ici »Ouvrez les connecteurs de l’agent dans Agent Builder. Une connexion qui demande votre attention y est signalée, et la solution consiste presque toujours à l’autoriser de nouveau.
Réautoriser conserve vos associations. Connecter le même service avec le même compte réautorise la connexion existante au lieu d’en créer une seconde : vous n’avez donc pas à la réassocier ensuite à chaque agent.
Les cinq causes
Section intitulée « Les cinq causes »L’autorisation a expiré
Section intitulée « L’autorisation a expiré »Les fournisseurs font expirer l’accès au bout d’un certain temps : rapidement pour certains, après plusieurs mois pour d’autres. La connexion est signalée comme devant être réautorisée, et les outils de l’agent pour ce service cessent de fonctionner.
Solution : reconnectez le service avec le même compte.
L’accès a été révoqué chez le fournisseur
Section intitulée « L’accès a été révoqué chez le fournisseur »Quelqu’un a retiré endue dans les paramètres du compte Google, désinstallé l’application Slack ou supprimé le jeton d’API. endue ne peut pas distinguer ce cas d’une expiration avant d’avoir essayé.
Solution : réautorisez, ou créez un nouveau jeton et reconnectez le service. Si la révocation était voulue, supprimez la connexion dans endue pour que l’état affiché corresponde à la réalité.
Vous avez connecté le mauvais compte
Section intitulée « Vous avez connecté le mauvais compte »Le cas classique : votre compte Google personnel était actif quand vous avez approuvé un connecteur professionnel. Aucune erreur ne s’affiche ; l’agent ne trouve simplement rien, parce qu’il cherche dans la mauvaise boîte de réception.
Solution : déconnectez-vous du mauvais compte chez le fournisseur, ou utilisez une fenêtre de navigation privée, puis reconnectez le service avec le compte voulu. Vérifiez le compte affiché sur l’écran de consentement avant d’approuver.
L’agent n’a pas accès à la ressource concernée
Section intitulée « L’agent n’a pas accès à la ressource concernée »La connexion fonctionne ; c’est la ressource qui n’est pas partagée avec elle.
| Service | Symptôme | Solution |
|---|---|---|
| Slack | « Pas dans la chaîne » à la lecture de l’historique | Invitez l’application dans cette chaîne depuis Slack |
| Notion | La recherche ne renvoie rien pour une page que vous voyez | Partagez la page avec l’intégration depuis Notion |
| GitLab | Un projet ou un ticket est signalé comme introuvable | L’utilisateur du jeton n’y a peut-être pas accès : vérifiez les autorisations, pas l’orthographe |
| Un fichier est introuvable | Le compte connecté n’y a peut-être pas accès |
Un service auto-hébergé a changé d’adresse ou est injoignable
Section intitulée « Un service auto-hébergé a changé d’adresse ou est injoignable »Les connecteurs qui demandent une adresse (GitLab, Jenkins, Discourse, WordPress, Mattermost, Grafana, Elasticsearch) ont besoin que cette adresse soit joignable depuis Internet.
Solution : vérifiez que l’adresse est correcte et joignable publiquement, puis reconnectez le service. Un service situé derrière un VPN est injoignable.
Quand le connecteur fonctionne mais que l’agent échoue quand même
Section intitulée « Quand le connecteur fonctionne mais que l’agent échoue quand même »- L’opération n’existe pas. Chaque connecteur expose un ensemble fixe d’opérations : consultez Connecteurs disponibles. Un agent ne peut pas utiliser une partie de l’API d’un fournisseur qu’endue n’expose pas.
- La connexion n’est pas associée à cet agent. La connexion se fait au niveau du compte ; l’utilisation, agent par agent.
- Le groupe d’outils est désactivé. Vérifiez les outils intégrés de l’agent si la capacité manquante est la mémoire, les livrables, les routines ou la récupération web plutôt qu’un connecteur.
- L’action a été refusée par le garde-fou d’approbation, y compris automatiquement, parce que l’exécution était sans surveillance.
Supprimer une connexion
Section intitulée « Supprimer une connexion »La supprimer dans endue retire immédiatement ces outils à tous les agents qui y sont associés. Les conversations existantes conservent leur historique ; l’agent ne peut simplement plus faire ces appels.
Supprimer une connexion dans endue ne révoque pas l’accès d’endue chez le fournisseur. Pour couper net, faites les deux.