Applications connectées
Plateforme principaleconnected_apps_readAgent IAAffiche les applications externes (e-mail, calendrier, CRM, messagerie, ...) qu'un appareil Agent IA a connectées, avec leurs comptes, les services Performance Hub intégrés, les applications mises en avant et les demandes de connexion en attente. Les connexions appartiennent à un seul appareil agent. Passez search pour trouver n'importe quelle application connectable et son slug. Les outils des applications connectées s'exécutent via le serveur MCP distinct « connected_apps » (PH_APPS_SEARCH_TOOLS, puis PH_APPS_MULTI_EXECUTE_TOOL).
Actions :
- list : Lister les Connected Apps. Les applications connectées listent chaque compte (id, alias, healthy) ; passez l'alias ou l'id comme
accountlors de l'exécution des outils de cette application.
Paramètres
| Nom | Type | Description |
|---|---|---|
action* | "list" | L'action à effectuer ; chaque action est décrite dans la description de l'outil. |
deviceId | string | deviceUuid de l'Agent IA issu de device_inventory_read. Les agents agissent sur eux-mêmes, omettez-le donc ; les personnes peuvent l'omettre lorsque l'installation n'a qu'un seul agent. |
search | string | Rechercher dans tout le catalogue par nom, slug, catégorie ou description, p. ex. "accounting" |
facilityId | string | ID de l'installation. Facultatif lorsque l'installation connectée est celle que vous visez. |
connected_apps_writeAgent IADemande la connexion d'une application externe à un appareil Agent IA afin que ses outils deviennent disponibles. Trouvez d'abord le slug de l'application avec connected_apps_read. Avertit le propriétaire de l'agent et la personne présente dans la conversation (au plus une fois par jour et par application) et renvoie un lien de connexion pour la conversation ; la personne qui se connecte via ce lien devient le compte au nom duquel l'agent agit, partagez-le donc avec prudence.
Actions :
- request_connect : Demander une connexion. Les applications déjà connectées renvoient plutôt leurs comptes, sauf si alias est passé pour ajouter un autre compte. Requiert toolkit.
Paramètres
| Nom | Type | Description |
|---|---|---|
action* | "request_connect" | L'action à effectuer ; chaque action est décrite dans la description de l'outil. |
deviceId | string | deviceUuid de l'Agent IA issu de device_inventory_read. Les agents agissent sur eux-mêmes, omettez-le donc ; les personnes peuvent l'omettre lorsque l'installation n'a qu'un seul agent. |
toolkit | string | Slug de l'application issu de connected_apps_read list ou search |
reason | string | Pourquoi l'agent a besoin de l'application ; affiché aux personnes averties |
alias | string | Libellé d'un compte supplémentaire pour une application déjà connectée, p. ex. l'adresse de la boîte de réception |
facilityId | string | ID de l'installation. Facultatif lorsque l'installation connectée est celle que vous visez. |