實作代理程式執行程式

已完成

代理執行器是 A2A 代理程式的核心元件。 它定義了您的代理程式如何處理傳入的請求、產生回應以及與客戶端或其他代理程式通訊。 將其視為 A2A 協定和代理特定業務邏輯之間的橋樑。

瞭解代理程式執行器

介面會 AgentExecutor 處理傳送至代理程式的所有傳入請求。 它接收有關請求的信息,根據代理的能力進行處理,並通過通信通道將響應或事件發送回來。

主要職責:

  • 執行使用者或其他代理程式要求的任務。
  • 串流回應或將個別訊息傳送回用戶端。
  • 如果支援,請處理工作取消。

實作介面

代理程式執行器通常會定義兩個主要作業:

  • 處理傳入請求並產生回應。
  • 存取要求詳細資料 (例如,使用者輸入、工作內容)。
  • 透過事件佇列傳回結果,其中可能包括訊息、任務更新或成品。

  • 處理取消進行中任務的請求。
  • 簡單代理程式可能不支援。

執行程式會使用 RequestContext 來瞭解傳入的請求,並使用 EventQueue 將結果或事件傳達回用戶端。

請求處理流程

考慮一個「Hello World」代理程式工作流程:

  1. 代理程式有一個小型協助程式類別,可實作其核心邏輯 (例如,傳回字串)。
  2. 執行程式會收到要求,並呼叫代理程式的邏輯。
  3. 執行程式會將結果包裝為事件,並將其放在事件佇列中。
  4. 路由機制會將事件傳回要求者。

對於取消,基本客服專員可能僅指示不支援取消。

代理執行器是使 A2A 代理正常運作的核心。 它定義了代理如何執行任務和傳達結果,為客戶端和其他代理提供標準化介面。 正確實施的執行器可實現多代理工作流程中的無縫整合和協作。