Aplicativos Conectados

Plataforma principal

connected_apps_readAgente de IA

Mostra quais apps externos (e-mail, calendário, CRM, mensagens, ...) um dispositivo Agente de IA conectou, com suas contas, os serviços integrados do Performance Hub, apps em destaque e solicitações de conexão pendentes. As conexões pertencem a um dispositivo de agente. Passe search para encontrar qualquer app conectável e seu slug. As ferramentas dos apps conectados são executadas pelo servidor MCP separado "connected_apps" (PH_APPS_SEARCH_TOOLS e depois PH_APPS_MULTI_EXECUTE_TOOL).

Ações:

list: Listar Connected Apps. Os apps conectados listam cada conta (id, alias, healthy); passe o alias ou o id como account ao executar as ferramentas desse app.

Parâmetros

Nome	Tipo	Descrição
`action`*	`"list"`	O que fazer; cada ação é descrita na descrição da ferramenta.
`deviceId`	`string`	deviceUuid do Agente de IA de device_inventory_read. Os agentes agem sobre si mesmos, então omita-o; as pessoas podem omiti-lo quando a instalação tem um único agente.
`search`	`string`	Pesquisar no catálogo completo por nome, slug, categoria ou descrição, por exemplo "accounting"
`facilityId`	`string`	ID da instalação. Opcional quando a instalação conectada é a que você quer.

connected_apps_writeAgente de IA

Solicita que um app externo seja conectado a um dispositivo Agente de IA para que suas ferramentas fiquem disponíveis. Encontre antes o slug do app com connected_apps_read. Notifica o proprietário do agente e a pessoa no chat (no máximo uma vez por dia por app) e retorna um link de conexão para o chat; quem entrar por esse link passa a ser a conta em nome da qual o agente age, então compartilhe-o com cuidado.

Ações:

request_connect: Solicitar uma conexão. Apps já conectados retornam suas contas, a menos que alias seja passado para adicionar outra conta. Exige toolkit.

Parâmetros

Nome	Tipo	Descrição
`action`*	`"request_connect"`	O que fazer; cada ação é descrita na descrição da ferramenta.
`deviceId`	`string`	deviceUuid do Agente de IA de device_inventory_read. Os agentes agem sobre si mesmos, então omita-o; as pessoas podem omiti-lo quando a instalação tem um único agente.
`toolkit`	`string`	Slug do app de connected_apps_read list ou search
`reason`	`string`	Por que o agente precisa do app; exibido às pessoas notificadas
`alias`	`string`	Rótulo para uma conta adicional de um app que já está conectado, por exemplo o endereço da caixa de entrada
`facilityId`	`string`	ID da instalação. Opcional quando a instalação conectada é a que você quer.