Aplicaciones conectadas

Plataforma principal

connected_apps_readAgente de IA

Muestra qué apps externas (correo electrónico, calendario, CRM, mensajería, ...) ha conectado un dispositivo de Agente de IA, con sus cuentas, los servicios integrados de Performance Hub, las apps destacadas y las solicitudes de conexión pendientes. Las conexiones pertenecen a un dispositivo de agente. Pasa search para encontrar cualquier app que se pueda conectar y su slug. Las herramientas de las apps conectadas se ejecutan a través del servidor MCP independiente "connected_apps" (PH_APPS_SEARCH_TOOLS y luego PH_APPS_MULTI_EXECUTE_TOOL).

Acciones:

list: Mostrar las Connected Apps. Las apps conectadas enumeran cada cuenta (id, alias, healthy); pasa el alias o el id como account al ejecutar las herramientas de esa app.

Parámetros

Nombre	Tipo	Descripción
`action`*	`"list"`	Qué hacer; cada acción se describe en la descripción de la herramienta.
`deviceId`	`string`	deviceUuid del Agente de IA de device_inventory_read. Los agentes actúan sobre sí mismos, así que omítelo; las personas pueden omitirlo cuando la instalación tiene un solo agente.
`search`	`string`	Buscar en todo el catálogo por nombre, slug, categoría o descripción, p. ej., "contabilidad"
`facilityId`	`string`	ID de la instalación. Opcional si te refieres a la instalación conectada.

connected_apps_writeAgente de IA

Solicita que se conecte una app externa a un dispositivo de Agente de IA para que sus herramientas estén disponibles. Busca primero el slug de la app con connected_apps_read. Notifica al propietario del agente y a la persona del chat (como máximo una vez al día por app) y devuelve un enlace de conexión para el chat; quien inicie sesión mediante ese enlace se convierte en la cuenta con la que actúa el agente, así que compártelo con cuidado.

Acciones:

request_connect: Solicitar una conexión. Las apps ya conectadas devuelven sus cuentas en su lugar, a menos que se pase alias para agregar otra cuenta. Requiere toolkit.

Parámetros

Nombre	Tipo	Descripción
`action`*	`"request_connect"`	Qué hacer; cada acción se describe en la descripción de la herramienta.
`deviceId`	`string`	deviceUuid del Agente de IA de device_inventory_read. Los agentes actúan sobre sí mismos, así que omítelo; las personas pueden omitirlo cuando la instalación tiene un solo agente.
`toolkit`	`string`	Slug de la app de connected_apps_read list o search
`reason`	`string`	Por qué el agente necesita la app; se muestra a las personas notificadas
`alias`	`string`	Etiqueta para una cuenta adicional de una app que ya está conectada, p. ej., la dirección de la bandeja de entrada
`facilityId`	`string`	ID de la instalación. Opcional si te refieres a la instalación conectada.