# Dépanner les connexions

> Jetons expirés, accès révoqués, mauvais compte et erreurs d'autorisation : à quoi ressemble chaque cas et comment le corriger.

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

Ouvrez les connecteurs de l'agent dans [Agent Builder](/fr/docs/build/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

### 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

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

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

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 |
| **Google** | Un fichier est introuvable | Le compte connecté n'y a peut-être pas accès |

<Aside type="note" title="Introuvable signifie souvent non autorisé">
  Plusieurs fournisseurs renvoient « introuvable » plutôt que « non autorisé » pour ce que
  vous ne pouvez pas voir, afin de ne pas en révéler l'existence. Face à un « introuvable »
  sur quelque chose dont l'existence ne fait pour vous aucun doute, pensez d'abord à un
  problème d'autorisation.
</Aside>

### 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

- **L'opération n'existe pas.** Chaque connecteur expose un ensemble fixe d'opérations : consultez [Connecteurs disponibles](/fr/docs/connect/available-connectors/). 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](/fr/docs/capabilities/built-in-tools/) 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](/fr/docs/work/approvals/)**, y compris automatiquement, parce que l'exécution était sans surveillance.

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

## Voir aussi

<CardGrid>
  <LinkCard
    title="Présentation des connecteurs"
    href="/fr/docs/connect/overview/"
    description="Comment s'articulent connexion, association et révocation."
  />
  <LinkCard
    title="Dépannage"
    href="/fr/docs/troubleshooting/"
    description="Les problèmes qui ne concernent pas les connexions."
  />
  <LinkCard
    title="Sécurité et autorisations"
    href="/fr/docs/account/security/"
    description="Ce à quoi un agent a accès, et ce à quoi il n'a pas accès."
  />
</CardGrid>