Ứng dụng đã kết nối
Nền tảng cốt lõiconnected_apps_readTác nhân AIHiển thị các ứng dụng bên ngoài (email, lịch, CRM, nhắn tin, ...) mà một thiết bị AI Agent đã kết nối, kèm tài khoản của chúng, các dịch vụ Performance Hub tích hợp sẵn, ứng dụng nổi bật và các yêu cầu kết nối đang chờ. Kết nối thuộc về một thiết bị agent. Truyền search để tìm bất kỳ ứng dụng nào có thể kết nối và slug của ứng dụng đó. Công cụ của ứng dụng đã kết nối chạy qua máy chủ MCP riêng "connected_apps" (PH_APPS_SEARCH_TOOLS, sau đó PH_APPS_MULTI_EXECUTE_TOOL).
Các hành động:
- list: Liệt kê Connected Apps. Các ứng dụng đã kết nối liệt kê từng tài khoản (id, alias, healthy); truyền alias hoặc id làm
accountkhi chạy công cụ của ứng dụng đó.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "list" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
deviceId | string | deviceUuid của AI Agent lấy từ device_inventory_read. Agent tự thao tác trên chính mình, vì vậy hãy bỏ qua; người dùng có thể bỏ qua khi cơ sở chỉ có một agent. |
search | string | Tìm trong toàn bộ danh mục theo tên, slug, danh mục hoặc mô tả, ví dụ "accounting" |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |
connected_apps_writeTác nhân AIYêu cầu kết nối một ứng dụng bên ngoài với thiết bị AI Agent để các công cụ của ứng dụng đó khả dụng. Hãy tìm slug của ứng dụng trước bằng connected_apps_read. Thông báo cho chủ sở hữu agent và người trong cuộc trò chuyện (tối đa một lần mỗi ngày cho mỗi ứng dụng) và trả về liên kết kết nối cho cuộc trò chuyện; bất kỳ ai đăng nhập qua liên kết đó sẽ trở thành tài khoản mà agent dùng để thao tác, vì vậy hãy chia sẻ cẩn thận.
Các hành động:
- request_connect: Yêu cầu kết nối. Ứng dụng đã kết nối sẽ trả về tài khoản của chúng, trừ khi truyền alias để thêm một tài khoản khác. Cần toolkit.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
action* | "request_connect" | Việc cần làm; mỗi hành động được mô tả trong phần mô tả công cụ. |
deviceId | string | deviceUuid của AI Agent lấy từ device_inventory_read. Agent tự thao tác trên chính mình, vì vậy hãy bỏ qua; người dùng có thể bỏ qua khi cơ sở chỉ có một agent. |
toolkit | string | Slug ứng dụng lấy từ connected_apps_read list hoặc search |
reason | string | Lý do agent cần ứng dụng; hiển thị cho những người được thông báo |
alias | string | Nhãn cho một tài khoản bổ sung của ứng dụng đã kết nối, ví dụ địa chỉ hộp thư |
facilityId | string | ID cơ sở. Không bắt buộc khi cơ sở đang kết nối chính là cơ sở bạn muốn chỉ đến. |