App connesse

Piattaforma principale

connected_apps_readAgente AI

Mostra quali app esterne (email, calendario, CRM, messaggistica, ...) ha collegato un dispositivo Agente AI, con i relativi account, i servizi integrati di Performance Hub, le app in evidenza e le richieste di connessione in attesa. Le connessioni appartengono a un singolo dispositivo agente. Passa search per trovare qualsiasi app collegabile e il suo slug. Gli strumenti delle app collegate vengono eseguiti tramite il server MCP separato "connected_apps" (PH_APPS_SEARCH_TOOLS, poi PH_APPS_MULTI_EXECUTE_TOOL).

Azioni:

list: Elenca le Connected Apps. Le app collegate elencano ogni account (id, alias, healthy); passa l'alias o l'id come account quando esegui gli strumenti di quell'app.

Parametri

Nome	Tipo	Descrizione
`action`*	`"list"`	Cosa fare; ogni azione è descritta nella descrizione dello strumento.
`deviceId`	`string`	deviceUuid dell'Agente AI da device_inventory_read. Gli agenti agiscono su se stessi, quindi omettilo; le persone possono ometterlo quando la struttura ha un solo agente.
`search`	`string`	Cerca nell'intero catalogo per nome, slug, categoria o descrizione, ad es. "contabilità"
`facilityId`	`string`	ID della struttura. Facoltativo quando intendi la struttura connessa.

connected_apps_writeAgente AI

Richiede che un'app esterna venga collegata a un dispositivo Agente AI affinché i suoi strumenti diventino disponibili. Trova prima lo slug dell'app con connected_apps_read. Avvisa il proprietario dell'agente e la persona nella chat (al massimo una volta al giorno per app) e restituisce un link di connessione per la chat; chiunque acceda tramite quel link diventa l'account con cui agisce l'agente, quindi condividilo con attenzione.

Azioni:

request_connect: Richiedi una connessione. Le app già collegate restituiscono invece i loro account, a meno che non venga passato alias per aggiungere un altro account. Richiede toolkit.

Parametri

Nome	Tipo	Descrizione
`action`*	`"request_connect"`	Cosa fare; ogni azione è descritta nella descrizione dello strumento.
`deviceId`	`string`	deviceUuid dell'Agente AI da device_inventory_read. Gli agenti agiscono su se stessi, quindi omettilo; le persone possono ometterlo quando la struttura ha un solo agente.
`toolkit`	`string`	Slug dell'app da connected_apps_read list o search
`reason`	`string`	Perché l'agente ha bisogno dell'app; mostrato alle persone avvisate
`alias`	`string`	Etichetta per un account aggiuntivo di un'app già collegata, ad es. l'indirizzo della casella di posta
`facilityId`	`string`	ID della struttura. Facoltativo quando intendi la struttura connessa.