เอเจนต์ (Agent)

ภาพรวม

หน้าเอเจนต์ (เมนูแถบด้านข้าง เอเจนต์) คือจุดเริ่มต้นสำหรับการเรียกดูและใช้งาน AI เอเจนต์ในพื้นที่ทำงาน รองรับเอเจนต์สองประเภท:

• เอเจนต์โปรโตคอล A2A: Agent มาตรฐานที่บุคคลที่สามให้บริการภายนอกตาม โปรโตคอล A2A เพียงเพิ่ม URL หนึ่งรายการก็สนทนาได้
• เอเจนต์แบบดั้งเดิม (ประเภท QuestionAnswer / Flow): เอเจนต์ที่เผยแพร่บนแพลตฟอร์ม GPTBots ฝังผ่าน iframe

ความแตกต่างสำคัญ: ต่างจาก Work หน้าเอเจนต์เป็นตลาดแอปพลิเคชัน —— สิ่งที่คุณเรียกใช้คือ Agent ที่คนอื่นหรือตัวคุณเองสร้างเสร็จแล้ว ไม่ใช่การเริ่มงานจากศูนย์

---

จุดเข้าใช้งาน

• Web: https://www.gptbots.ai/工作区/agent
• APP: เมนูด้านซ้าย "เอเจนต์"

มุมมองรายการ

เอเจนต์แสดงในรูปแบบกริดการ์ด:

การกรอง

• แท็บหมวดหมู่ด้านบน: ทั้งหมด / Default / หมวดหมู่ที่กำหนดเอง (เช่น การเงิน / งานธุรการ / วิจัยและพัฒนาผลิตภัณฑ์ / กฎหมาย)
• การค้นหาด้วยคำสำคัญ: กล่องค้นหาที่มุมขวาบน
• รายการโปรดของฉัน: ปุ่มที่มุมขวาบน แสดงเฉพาะเอเจนต์ที่เก็บเข้าที่ชื่นชอบไว้แล้ว

---

เอเจนต์ A2A

การเพิ่มเอเจนต์ A2A

เพิ่มเอเจนต์โปรโตคอล A2A มาตรฐานผ่าน Agent Card URL:

1. ในหน้าเอเจนต์ คลิกปุ่ม เพิ่มเอเจนต์ A2A (เฉพาะผู้ดูแลระบบ)
2. กรอก Agent Card URL ของเอเจนต์ (เช่น https://agent.example.com/.well-known/agent.json)
3. ระบบดึงข้อมูลเอเจนต์โดยอัตโนมัติ (รูปประจำตัว ชื่อ คำอธิบาย รายการความสามารถ)
4. ตั้งค่าหมวดหมู่และชื่อที่แสดง
5. หลังจากบันทึกแล้ว เอเจนต์จะปรากฏในรายการ

Agent Card URL คืออะไร? มันคือ HTTP endpoint ที่เอเจนต์ A2A ของบุคคลที่สามเปิดเผยไว้ ซึ่งจะส่งคืนข้อมูลคำอธิบายตัวตนของเอเจนต์ (รูปแบบ JSON) โดยทั่วไปจัดเตรียมโดยนักพัฒนาเอเจนต์

การสนทนา A2A

คลิกการ์ดเอเจนต์เพื่อเข้าสู่อินเทอร์เฟซการสนทนา A2aChatView:

ประเภทการตอบกลับแบบมีโครงสร้าง:

สำหรับรายละเอียดทางเทคนิคของโปรโตคอล โปรดดูที่ โปรโตคอล A2A

การเรียกใช้ข้ามบัญชี

เอเจนต์ A2A รองรับการส่งต่อผ่าน Gateway ข้ามบัญชี —— เมื่อผู้ใช้เรียกใช้เอเจนต์ในขอบเขต enterprise จากฝั่ง Web คำขอจะถูกกำหนดเส้นทางผ่าน Gateway ไปยังโหนดเป้าหมายเพื่อดำเนินการ ดูรายละเอียดที่ สถาปัตยกรรมหลายโหนด — กฎการกระจายป๊อปอัปสิทธิ์

---

เอเจนต์แบบดั้งเดิม

เอเจนต์แบบดั้งเดิม (ประเภท QuestionAnswer / Flow) ฝังผ่าน iframe เข้าสู่หน้ารายละเอียดเอเจนต์ของ Space Web

หลังจากคลิกการ์ดเอเจนต์แบบดั้งเดิม จะเข้าสู่ AgentDetailPage ซึ่งฝังหน้า /space/agent-details/{botId} ของ Space Web

---

การควบคุมสิทธิ์

สิทธิ์ผู้ดูแลระบบตรวจสอบผ่าน canManageAgents() (บทบาทเป็น Owner / Admin หรือมีรหัสสิทธิ์เฉพาะ)

---

คู่มือการใช้งาน

วิธีเพิ่มเอเจนต์ A2A

1. หลังจากสร้างและเผยแพร่ Agent ในพื้นที่พัฒนาแล้ว สามารถคลิกเผยแพร่ไปยังพื้นที่ทำงานได้ในหน้าการเชื่อมต่อ
2. ในหน้าพื้นที่ทำงาน-การจัดการพื้นที่-ทรัพยากรองค์กร-Agent ผู้ดูแลระบบสามารถตรวจสอบว่าจะให้ขึ้นใช้งานหรือไม่
3. หลังจากตรวจสอบผ่านแล้ว Agent นั้นจะแสดงในรายการพื้นที่ทำงาน คลิก เอเจนต์ ในแถบด้านข้างของพื้นที่ทำงาน
4. ค้นหา Agent ที่คุณเพิ่งขึ้นใช้งาน คลิกการ์ดเพื่อเข้าสู่อินเทอร์เฟซการสนทนา

วิธีสนทนากับเอเจนต์

1. ค้นหาการ์ดเอเจนต์เป้าหมายในหน้าเอเจนต์
2. คลิกการ์ดเพื่อเข้าสู่อินเทอร์เฟซการสนทนา
3. พิมพ์ข้อความ กด Enter เพื่อส่ง
4. รอการตอบกลับของเอเจนต์ (สตรีม SSE แสดงผลแบบเรียลไทม์)

คำแนะนำ: ระบบใช้เซสชันครั้งก่อนหน้าซ้ำโดยค่าเริ่มต้น หากต้องการเริ่มการสนทนาใหม่ทั้งหมด ให้คลิกปุ่ม "สร้างเซสชันใหม่"

คำถามที่พบบ่อย

เชื่อมต่อเอเจนต์ไม่สำเร็จ

• ยืนยันว่า Agent Card URL สามารถเข้าถึงได้จากเครือข่ายปัจจุบัน
• ยืนยันว่า URL เป็น HTTPS และไม่ใช่ที่อยู่ในเครือข่ายภายใน (ระบบมีการป้องกัน SSRF)
• หากเอเจนต์ต้องการการยืนยันตัวตน ให้ยืนยันว่ากำหนดค่า authType และข้อมูลรับรองถูกต้อง

เอเจนต์ตอบกลับว่างเปล่าหรือรูปแบบผิดปกติ

• อาจเป็นปัญหาที่ฝั่งเอเจนต์ ลองส่งใหม่อีกครั้ง
• ตรวจสอบว่าเอเจนต์รองรับภาษาจีนหรือไม่ (เอเจนต์บางตัวอาจรองรับเฉพาะภาษาอังกฤษ)

---

เอกสารที่เกี่ยวข้อง

• โปรโตคอล A2A — รายละเอียดทางเทคนิคของ Agent Card, JSON-RPC, การตอบกลับแบบมีโครงสร้าง
• ทรัพยากรองค์กร — การจัดการเอเจนต์ A2A ระดับองค์กร
• สถาปัตยกรรมหลายโหนด — การกำหนดเส้นทาง Gateway ข้ามบัญชี