實作代理程式執行程式
代理執行器是 A2A 代理程式的核心元件。 它定義了您的代理程式如何處理傳入的請求、產生回應以及與客戶端或其他代理程式通訊。 將其視為 A2A 協定和代理特定業務邏輯之間的橋樑。
瞭解代理程式執行器
介面會 AgentExecutor 處理傳送至代理程式的所有傳入請求。 它接收有關請求的信息,根據代理的能力進行處理,並通過通信通道將響應或事件發送回來。
主要職責:
- 執行使用者或其他代理程式要求的任務。
- 串流回應或將個別訊息傳送回用戶端。
- 如果支援,請處理工作取消。
實作介面
代理程式執行器通常會定義兩個主要作業:
誅
- 處理傳入請求並產生回應。
- 存取要求詳細資料 (例如,使用者輸入、工作內容)。
- 透過事件佇列傳回結果,其中可能包括訊息、任務更新或成品。
銷
- 處理取消進行中任務的請求。
- 簡單代理程式可能不支援。
執行程式會使用 RequestContext 來瞭解傳入的請求,並使用 EventQueue 將結果或事件傳達回用戶端。
請求處理流程
考慮一個「Hello World」代理程式工作流程:
- 代理程式有一個小型協助程式類別,可實作其核心邏輯 (例如,傳回字串)。
- 執行程式會收到要求,並呼叫代理程式的邏輯。
- 執行程式會將結果包裝為事件,並將其放在事件佇列中。
- 路由機制會將事件傳回要求者。
對於取消,基本客服專員可能僅指示不支援取消。
代理執行器是使 A2A 代理正常運作的核心。 它定義了代理如何執行任務和傳達結果,為客戶端和其他代理提供標準化介面。 正確實施的執行器可實現多代理工作流程中的無縫整合和協作。