연동 앱

핵심 플랫폼

connected_apps_readAI 에이전트

AI 에이전트 기기가 연결한 외부 앱(이메일, 캘린더, CRM, 메시징 등)과 해당 계정, 기본 제공 Performance Hub 서비스, 추천 앱 및 대기 중인 연결 요청을 보여 줍니다. 연결은 하나의 에이전트 기기에 속합니다. 연결 가능한 앱과 해당 slug를 찾으려면 search를 전달하십시오. 연결된 앱의 도구는 별도의 "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에서 가져온 AI 에이전트 deviceUuid. 에이전트는 자기 자신에 대해 작동하므로 생략하십시오. 시설에 에이전트가 하나뿐이면 사람도 생략할 수 있습니다.
`search`	`string`	이름, slug, 카테고리 또는 설명으로 전체 카탈로그를 검색합니다, 예: "accounting"
`facilityId`	`string`	시설 ID입니다. 연결된 시설을 대상으로 하는 경우 생략할 수 있습니다.

connected_apps_writeAI 에이전트

외부 앱을 AI 에이전트 기기에 연결하도록 요청하여 해당 앱의 도구를 사용할 수 있게 합니다. 먼저 connected_apps_read로 앱의 slug를 찾으십시오. 에이전트 소유자와 채팅 중인 사람에게 알리고(앱당 하루 최대 1회) 채팅용 연결 링크를 반환합니다. 이 링크로 로그인한 사람의 계정으로 에이전트가 작동하므로 신중하게 공유하십시오.

작업:

request_connect: 연결을 요청합니다. 이미 연결된 앱은 대신 해당 계정을 반환하며, 다른 계정을 추가하려면 alias를 전달하십시오. 필요한 값: toolkit.

매개변수

이름	유형	설명
`action`*	`"request_connect"`	수행할 작업입니다. 각 작업은 도구 설명에 설명되어 있습니다.
`deviceId`	`string`	device_inventory_read에서 가져온 AI 에이전트 deviceUuid. 에이전트는 자기 자신에 대해 작동하므로 생략하십시오. 시설에 에이전트가 하나뿐이면 사람도 생략할 수 있습니다.
`toolkit`	`string`	connected_apps_read list 또는 search에서 가져온 앱 slug
`reason`	`string`	에이전트에 앱이 필요한 이유. 알림을 받는 사람에게 표시됩니다
`alias`	`string`	이미 연결된 앱의 추가 계정 레이블, 예: 받은편지함 주소
`facilityId`	`string`	시설 ID입니다. 연결된 시설을 대상으로 하는 경우 생략할 수 있습니다.