Połączone aplikacje
Platforma podstawowaconnected_apps_readAgent AIPokazuje, które aplikacje zewnętrzne (e-mail, kalendarz, CRM, komunikatory, ...) połączyło urządzenie Agent AI, wraz z ich kontami, wbudowane usługi Performance Hub, polecane aplikacje i oczekujące prośby o połączenie. Połączenia należą do jednego urządzenia agenta. Przekaż search, aby znaleźć dowolną aplikację, którą można połączyć, i jej slug. Narzędzia połączonych aplikacji działają przez osobny serwer MCP "connected_apps" (PH_APPS_SEARCH_TOOLS, a następnie PH_APPS_MULTI_EXECUTE_TOOL).
Akcje:
- list: Lista Connected Apps. Połączone aplikacje wyświetlają każde konto (id, alias, healthy); przekaż alias lub id jako
accountpodczas uruchamiania narzędzi tej aplikacji.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
action* | "list" | Co zrobić; każda akcja jest opisana w opisie narzędzia. |
deviceId | string | deviceUuid urządzenia Agent AI z device_inventory_read. Agenty działają na sobie, więc pomijają ten parametr; ludzie mogą go pominąć, gdy obiekt ma jednego agenta. |
search | string | Przeszukaj cały katalog według nazwy, slugu, kategorii lub opisu, np. "accounting" |
facilityId | string | Identyfikator obiektu. Opcjonalny, jeśli chodzi o połączony obiekt. |
connected_apps_writeAgent AIProśba o połączenie aplikacji zewnętrznej z urządzeniem Agent AI, aby jej narzędzia stały się dostępne. Najpierw znajdź slug aplikacji za pomocą connected_apps_read. Powiadamia właściciela agenta i osobę na czacie (najwyżej raz dziennie dla danej aplikacji) i zwraca link do połączenia do wklejenia na czacie; osoba, która zaloguje się przez ten link, staje się kontem, w imieniu którego działa agent, więc udostępniaj go ostrożnie.
Akcje:
- request_connect: Prośba o połączenie. Dla już połączonych aplikacji zwracane są ich konta, chyba że przekazano alias, aby dodać kolejne konto. Wymaga: toolkit.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
action* | "request_connect" | Co zrobić; każda akcja jest opisana w opisie narzędzia. |
deviceId | string | deviceUuid urządzenia Agent AI z device_inventory_read. Agenty działają na sobie, więc pomijają ten parametr; ludzie mogą go pominąć, gdy obiekt ma jednego agenta. |
toolkit | string | Slug aplikacji z connected_apps_read list lub search |
reason | string | Dlaczego agent potrzebuje aplikacji; wyświetlane powiadamianym osobom |
alias | string | Etykieta dodatkowego konta aplikacji, która jest już połączona, np. adres skrzynki odbiorczej |
facilityId | string | Identyfikator obiektu. Opcjonalny, jeśli chodzi o połączony obiekt. |