Подключенные приложения
Основная платформаconnected_apps_readИИ-агентПоказывает, какие внешние приложения (электронная почта, календарь, CRM, мессенджеры, ...) подключены к устройству ИИ-агента, с их учётными записями, а также встроенные сервисы Performance Hub, рекомендуемые приложения и ожидающие запросы на подключение. Подключения принадлежат одному устройству агента. Передайте search, чтобы найти любое доступное для подключения приложение и его slug. Инструменты подключённых приложений работают через отдельный MCP-сервер "connected_apps" (PH_APPS_SEARCH_TOOLS, затем PH_APPS_MULTI_EXECUTE_TOOL).
Действия:
- list: Список Connected Apps. Для подключённых приложений перечисляется каждая учётная запись (id, alias, healthy); при запуске инструментов этого приложения передавайте alias или id как
account.
Параметры
| Имя | Тип | Описание |
|---|---|---|
action* | "list" | Что сделать; каждое действие описано в описании инструмента. |
deviceId | string | deviceUuid ИИ-агента из device_inventory_read. Агенты действуют от своего имени, поэтому не указывают его; люди могут не указывать его, если на объекте один агент. |
search | string | Поиск по всему каталогу по названию, slug, категории или описанию, например "accounting" |
facilityId | string | ID объекта. Необязателен, если имеется в виду подключённый объект. |
connected_apps_writeИИ-агентЗапрашивает подключение внешнего приложения к устройству ИИ-агента, чтобы стали доступны его инструменты. Сначала найдите slug приложения с помощью connected_apps_read. Уведомляет владельца агента и человека в чате (не чаще одного раза в день для каждого приложения) и возвращает ссылку на подключение для чата; учётная запись того, кто войдёт по этой ссылке, станет учётной записью, от имени которой действует агент, поэтому делитесь ею осторожно.
Действия:
- request_connect: Запросить подключение. Для уже подключённых приложений вместо этого возвращаются их учётные записи, если не передан alias для добавления ещё одной учётной записи. Требуется toolkit.
Параметры
| Имя | Тип | Описание |
|---|---|---|
action* | "request_connect" | Что сделать; каждое действие описано в описании инструмента. |
deviceId | string | deviceUuid ИИ-агента из device_inventory_read. Агенты действуют от своего имени, поэтому не указывают его; люди могут не указывать его, если на объекте один агент. |
toolkit | string | Slug приложения из connected_apps_read list или search |
reason | string | Зачем агенту нужно приложение; показывается уведомляемым людям |
alias | string | Метка для дополнительной учётной записи уже подключённого приложения, например адрес почтового ящика |
facilityId | string | ID объекта. Необязателен, если имеется в виду подключённый объект. |