Présentation des connecteurs
Un connecteur relie un agent à un service que vous utilisez déjà. endue propose des connecteurs pour plus de trente services : voir Connecteurs disponibles. Pour un serveur que vous gérez vous-même, ajoutez une connexion directe.
Connexion et association
Section intitulée « Connexion et association »C’est la seule notion qu’il faut vraiment bien comprendre, car c’est elle qui rend prévisible ce à quoi un agent peut accéder.
-
Vous autorisez une connexion. Vous vous connectez chez le fournisseur (Google, Slack, Notion) ou collez un jeton d’API. La connexion ainsi créée appartient à votre compte.
-
Vous associez la connexion à des agents précis. Seuls les agents auxquels vous l’associez peuvent l’utiliser.
Connecter Gmail ne livre pas votre boîte de réception à tous vos agents. Un agent qui n’a aucune raison de lire vos e-mails ne devrait pas y être associé : cela réduit ce qui peut mal tourner et rend les choix de l’agent plus prévisibles.
Où trouver les connecteurs
Section intitulée « Où trouver les connecteurs »Ressources › Connecteurs, accessible depuis la barre latérale gauche, comporte trois onglets :
| Onglet | Contenu |
|---|---|
| Découvrir | Tous les connecteurs du catalogue |
| Connectés | Les connexions de votre compte |
| Connexions directes | Vos propres serveurs MCP et API HTTP. Voir Connexions directes. |
Connecter un service
Section intitulée « Connecter un service »-
Ouvrez Connecteurs dans Agent Builder, dans la section Ressources de l’agent, et choisissez le service.
-
Autorisez-le.
La plupart des services vous redirigent vers le fournisseur pour vous connecter et approuver l’accès ; endue ne reçoit que les autorisations affichées sur cet écran de consentement. D’autres demandent un jeton d’API que vous créez dans les paramètres du fournisseur, parfois accompagné de l’adresse de votre propre installation.
-
Associez la connexion à cet agent. Les outils de l’agent pour ce service apparaissent à sa prochaine exécution.
Ce qu’un agent peut faire une fois le service connecté
Section intitulée « Ce qu’un agent peut faire une fois le service connecté »Chaque connecteur expose un ensemble d’opérations, et chaque opération est classée selon ce qu’elle fait : lecture, écriture, envoi ou destruction. Les opérations d’envoi et de destruction s’arrêtent toujours pour attendre votre approbation avant de s’exécuter, en affichant leurs arguments exacts.
Ainsi, avec Gmail connecté, un agent peut rechercher et lire librement, rédiger des brouillons sans demander, et n’envoyer qu’avec votre accord.
Révoquer
Section intitulée « Révoquer »Vous pouvez couper la connexion d’un côté comme de l’autre :
- Dans endue, supprimez la connexion. Tous les agents qui y sont associés perdent immédiatement ces outils.
- Chez le fournisseur, révoquez l’accès d’endue dans les paramètres de votre compte Google, Slack ou Notion, ou supprimez le jeton d’API.
Révoquer chez le fournisseur laisse la connexion dans endue hors d’usage jusqu’à ce que vous la supprimiez ou la réautorisiez. Voir Dépanner les connexions.
- Un compte par connexion et par service. Pour travailler avec deux comptes Google, autorisez deux connexions.
- Les connexions s’associent agent par agent. Il n’existe pas d’option « tous les agents ».
- Un connecteur expose un ensemble fixe d’opérations. Ce n’est pas un client d’API généraliste : un agent ne peut pas appeler n’importe quel point de terminaison du fournisseur. Pour donner à un agent accès à votre propre API, utilisez une connexion directe.
- endue ne peut faire que ce que l’autorisation du fournisseur permet. Si une portée n’a pas été accordée, l’opération échoue chez le fournisseur, et pas en silence.