แอปที่เชื่อมต่อ
แพลตฟอร์มหลักconnected_apps_readตัวแทน AIแสดงแอปภายนอก (อีเมล ปฏิทิน CRM การส่งข้อความ ...) ที่อุปกรณ์ตัวแทน AI เชื่อมต่อไว้ พร้อมบัญชี บริการในตัวของ 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 ของตัวแทน AI จาก device_inventory_read ตัวแทนดำเนินการกับตัวเอง จึงไม่ต้องส่งค่านี้ ผู้ใช้ไม่ต้องส่งได้เมื่อสถานที่มีตัวแทนเพียงตัวเดียว |
search | string | ค้นหาแคตตาล็อกทั้งหมดตามชื่อ slug หมวดหมู่ หรือคำอธิบาย เช่น "accounting" |
facilityId | string | ID ของสถานที่ ไม่จำเป็นต้องระบุหากหมายถึงสถานที่ที่เชื่อมต่ออยู่ |
connected_apps_writeตัวแทน AIขอให้เชื่อมต่อแอปภายนอกกับอุปกรณ์ตัวแทน AI เพื่อให้ใช้เครื่องมือของแอปได้ หา slug ของแอปด้วย connected_apps_read ก่อน ระบบจะแจ้งเจ้าของตัวแทนและผู้ที่อยู่ในแชต (ไม่เกินวันละครั้งต่อแอป) และส่งคืนลิงก์เชื่อมต่อสำหรับแชต ผู้ที่ลงชื่อเข้าใช้ผ่านลิงก์นั้นจะกลายเป็นบัญชีที่ตัวแทนใช้ดำเนินการ จึงควรแชร์ลิงก์อย่างระมัดระวัง
การดำเนินการ:
- request_connect: ขอการเชื่อมต่อ แอปที่เชื่อมต่อแล้วจะส่งคืนบัญชีของแอปแทน เว้นแต่จะส่ง alias เพื่อเพิ่มบัญชีอื่น ต้องระบุ toolkit
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
action* | "request_connect" | สิ่งที่ต้องการทำ การดำเนินการแต่ละรายการมีคำอธิบายอยู่ในคำอธิบายของเครื่องมือ |
deviceId | string | deviceUuid ของตัวแทน AI จาก device_inventory_read ตัวแทนดำเนินการกับตัวเอง จึงไม่ต้องส่งค่านี้ ผู้ใช้ไม่ต้องส่งได้เมื่อสถานที่มีตัวแทนเพียงตัวเดียว |
toolkit | string | slug ของแอปจาก list หรือ search ของ connected_apps_read |
reason | string | เหตุผลที่ตัวแทนต้องใช้แอป ซึ่งจะแสดงต่อผู้ที่ได้รับแจ้ง |
alias | string | ป้ายกำกับสำหรับบัญชีเพิ่มเติมของแอปที่เชื่อมต่อแล้ว เช่น ที่อยู่กล่องจดหมาย |
facilityId | string | ID ของสถานที่ ไม่จำเป็นต้องระบุหากหมายถึงสถานที่ที่เชื่อมต่ออยู่ |