ใช้ตัวดําเนินการตัวแทน
Agent Executor เป็นองค์ประกอบหลักของตัวแทน A2A กําหนดวิธีที่ตัวแทนของคุณประมวลผลคําขอขาเข้า สร้างการตอบสนอง และสื่อสารกับลูกค้าหรือตัวแทนอื่นๆ คิดว่ามันเป็นสะพานเชื่อมระหว่างโปรโตคอล A2A และตรรกะทางธุรกิจเฉพาะของตัวแทนของคุณ
ทําความเข้าใจ Agent Executor
อินเทอร์เฟซจะ AgentExecutor จัดการคําขอขาเข้าทั้งหมดที่ส่งไปยังตัวแทนของคุณ รับข้อมูลเกี่ยวกับคําขอ ประมวลผลตามความสามารถของเอเจนต์ และส่งการตอบสนองหรือเหตุการณ์กลับผ่านช่องทางการสื่อสาร
ความรับผิดชอบหลัก:
- ดําเนินการงานที่ร้องขอโดยผู้ใช้หรือตัวแทนอื่น ๆ
- สตรีมการตอบกลับหรือส่งข้อความแต่ละข้อความกลับไปยังไคลเอ็นต์
- จัดการการยกเลิกงานหากได้รับการสนับสนุน
ใช้อินเทอร์เฟซ
โดยทั่วไปแล้ว Agent Executor จะกําหนดการดําเนินการหลักสองอย่าง:
ประหารชีวิต
- ประมวลผลคําขอขาเข้าและสร้างการตอบสนอง
- เข้าถึงรายละเอียดคําขอ (เช่น การป้อนข้อมูลของผู้ใช้ บริบทของงาน)
- ส่งผลลัพธ์กลับผ่านคิวเหตุการณ์ ซึ่งอาจรวมถึงข้อความ การอัปเดตงาน หรือสิ่งประดิษฐ์
ยกเลิก
- จัดการคําขอยกเลิกงานที่กําลังดําเนินอยู่
- อาจไม่รองรับเอเจนต์ธรรมดา
ผู้ดําเนินการใช้ RequestContext เพื่อทําความเข้าใจคําขอขาเข้าและ EventQueue เพื่อสื่อสารผลลัพธ์หรือเหตุการณ์กลับไปยังไคลเอ็นต์
ขั้นตอนการจัดการคําขอ
พิจารณาเวิร์กโฟลว์ตัวแทน "Hello World":
- เอเจนต์มีคลาสตัวช่วยขนาดเล็กที่ใช้ตรรกะหลัก (เช่น ส่งคืนสตริง)
- ผู้ดําเนินการได้รับคําขอและเรียกใช้ตรรกะของตัวแทน
- ผู้ดําเนินการจะห่อผลลัพธ์เป็นเหตุการณ์และวางไว้ในคิวเหตุการณ์
- กลไกการกําหนดเส้นทางจะส่งเหตุการณ์กลับไปยังผู้ร้องขอ
สําหรับการยกเลิก ตัวแทนพื้นฐานอาจระบุเพียงว่าไม่รองรับการยกเลิกเท่านั้น
Agent Executor เป็นศูนย์กลางในการทําให้ตัวแทน A2A ของคุณทํางานได้ กําหนดวิธีที่ตัวแทนดําเนินการงานและสื่อสารผลลัพธ์ โดยให้อินเทอร์เฟซที่เป็นมาตรฐานสําหรับลูกค้าและตัวแทนอื่นๆ ผู้ดําเนินการที่นําไปใช้อย่างเหมาะสมช่วยให้สามารถผสานรวมและการทํางานร่วมกันได้อย่างราบรื่นในเวิร์กโฟลว์หลายตัวแทน