已连接的应用

核心平台

connected_apps_read人工智能代理

显示人工智能代理设备已连接的外部应用（电子邮件、日历、CRM、消息等）及其账户、内置的 Performance Hub 服务、精选应用和待处理的连接请求。连接属于单台代理设备。传入 search 可查找任何可连接的应用及其 slug。已连接应用的工具通过单独的 "connected_apps" MCP 服务器运行（先 PH_APPS_SEARCH_TOOLS，再 PH_APPS_MULTI_EXECUTE_TOOL）。

操作：

list：列出 Connected Apps。已连接的应用会列出每个账户（id、alias、healthy）；运行该应用的工具时，将 alias 或 id 作为 account 传入。

参数

名称	类型	描述
`action`*	`"list"`	要执行的操作；每个操作的说明见工具描述。
`deviceId`	`string`	来自 device_inventory_read 的人工智能代理 deviceUuid。代理对自身操作，因此省略此项；设施只有一个代理时，人员也可以省略。
`search`	`string`	按名称、slug、类别或描述搜索完整目录，例如“accounting”
`facilityId`	`string`	设施 ID。如果所指的就是已连接的设施，则可省略。

connected_apps_write人工智能代理

请求将外部应用连接到人工智能代理设备，使其工具可用。先使用 connected_apps_read 查找应用的 slug。会通知代理的所有者和聊天中的人员（每个应用每天最多一次），并返回一个用于聊天的连接链接；通过该链接登录的人将成为代理所代表的账户，因此请谨慎分享。

操作：

request_connect：请求连接。对于已连接的应用，会改为返回其账户，除非传入 alias 以添加另一个账户。需要 toolkit。

参数

名称	类型	描述
`action`*	`"request_connect"`	要执行的操作；每个操作的说明见工具描述。
`deviceId`	`string`	来自 device_inventory_read 的人工智能代理 deviceUuid。代理对自身操作，因此省略此项；设施只有一个代理时，人员也可以省略。
`toolkit`	`string`	应用 slug，来自 connected_apps_read list 或 search
`reason`	`string`	代理需要该应用的原因；会显示给收到通知的人员
`alias`	`string`	已连接应用的附加账户的标签，例如收件箱地址
`facilityId`	`string`	设施 ID。如果所指的就是已连接的设施，则可省略。