A2A 介紹¶
當你建立更複雜的 agent 系統時，會發現單一 agent 往往無法滿足需求。你可能希望建立專門化的 agent，讓它們能夠協作解決問題。Agent2Agent (A2A) Protocol 就是讓這些 agent 彼此溝通的標準協議。
何時應使用 A2A 與本地子 agent¶
-
本地子 agent（Local Sub-Agents）： 這些 agent 在同一個應用程式程序 中執行，與你的主 agent 共用記憶體。它們就像內部模組或函式庫，用來將程式碼組織成有邏輯、可重複使用的元件。主 agent 與本地子 agent 之間的溝通非常快速，因為是直接在記憶體中傳遞，沒有網路延遲。
-
遠端 agent（Remote Agents, A2A）： 這些是獨立運作的 agent，以分離的服務形式執行，並透過網路進行溝通。A2A 定義了這種溝通的標準協議。
建議在以下情境下使用 A2A：
- 你需要溝通的 agent 是獨立、可單獨部署的服務（例如，專門的財務建模 agent）。
- 這個 agent 由不同的團隊或組織維護。
- 你需要連接不同程式語言或 agent 框架所撰寫的 agent。
- 你希望在系統元件間強制執行嚴謹、正式的契約（即 A2A 協議）。
何時使用 A2A：具體範例¶
- 與第三方服務整合： 你的主 agent 需要從外部金融資料提供者即時取得股價。該提供者透過支援 A2A 協議的 agent 提供資料。
- 微服務架構： 你有一個大型系統，拆分為多個小型、獨立的服務（例如，訂單處理 agent、庫存管理 agent、運送 agent）。A2A 非常適合讓這些服務跨網路邊界相互溝通。
- 跨語言溝通： 你的核心商業邏輯在 Python agent 中，但你有一個舊系統或專門元件是用 Java 撰寫，想以 agent 方式整合。A2A 提供標準化的溝通層。
- 正式 API 契約： 你正在建構一個平台，不同團隊會貢獻 agent，你需要嚴格規範這些 agent 如何互動，以確保相容性與穩定性。
何時不要使用 A2A：具體範例（建議使用本地子 agent）¶
- 內部程式碼組織： 你將單一 agent 內的複雜任務拆分為較小、易管理的函式或模組（例如，
DataValidator子 agent 用來在處理前清理輸入資料）。這類情境建議使用本地子 agent，效能與簡潔性較佳。 - 效能關鍵的內部操作： 某個子 agent 負責高頻率、低延遲且與主 agent 執行緊密耦合的操作（例如，
RealTimeAnalytics子 agent 在同一應用程式中處理資料串流）。這些操作適合以本地子 agent 處理。 - 共用記憶體／上下文： 當子 agent 需要直接存取主 agent 的內部狀態或共用記憶體以提升效率時，A2A 的網路延遲與序列化／反序列化反而會造成反效果。
- 簡單輔助函式： 對於不需獨立部署或複雜狀態管理的小型、可重複使用的邏輯片段，直接在同一 agent 內以函式或類別實作，比建立獨立的 A2A agent 更合適。
Agent Development Kit (ADK) 中的 A2A 工作流程：簡化說明¶
Agent Development Kit (ADK) 讓你能更簡單地使用 A2A 協議來建構與連接 agent。以下是其運作方式的簡要說明：
-
讓 agent 可被存取（Exposing）： 你有一個現有的 ADK agent，希望其他 agent 能與之互動。ADK 提供簡單的方法來「暴露」這個 agent，將其轉換為 A2AServer。這個 server 就像公開介面，允許其他 agent 透過網路向你的 agent 發送請求。你可以把它想像成為 agent 架設一個 web server。
-
連接到可存取的 agent（Consuming）： 在另一個 agent（可以在同一台機器或不同機器上運行）中，你會使用一個特殊的 ADK 元件
RemoteA2aAgent。這個RemoteA2aAgent會作為 client，知道如何與你先前暴露的 A2AServer 溝通。它會在背後處理所有網路通訊、認證與資料格式化的複雜細節。
對開發者來說，當你完成這些設定後，與遠端 agent 互動的體驗就像操作本地工具或函式一樣。ADK 幫你抽象掉網路層，使分散式 agent 系統的開發與本地系統一樣容易。
A2A 工作流程視覺化¶
為了進一步說明 A2A 的工作流程，讓我們看看「暴露」與「消費」 agent 前後的狀態，以及它們組合成的整體系統。
暴露一個 agent¶
暴露前：
你的 agent 程式碼作為獨立元件運行，但在這個情境下，你希望將它暴露出去，讓其他遠端 agent 能夠與你的 agent 互動。
公開後：
您的 agent 程式碼已與 A2AServer（一個 Agent Development Kit (ADK) 元件）整合，使其能夠透過網路被其他遠端 agent 存取。
+-----------------+
| A2A Server |
| (ADK Component) |<--------+
+-----------------+ |
| |
v |
+-------------------+ |
| Your Agent Code | |
| (Now Accessible) | |
+-------------------+ |
|
| (Network Communication)
v
+-----------------------------+
| Remote Agent(s) |
| (Can now communicate) |
+-----------------------------+
使用 agent¶
開始使用前： 你的 agent（在此情境下稱為「Root Agent」）是你正在開發、需要與遠端 agent 互動的應用程式。在開始使用前，它尚未具備直接進行互動的機制。
+----------------------+ +-------------------------------------------------------------+
| Root Agent | | Remote Agent |
| (Your existing code) | | (External Service that you want your Root Agent to talk to) |
+----------------------+ +-------------------------------------------------------------+
消費後：
您的 Root Agent 會使用 RemoteA2aAgent（這是一個 Agent Development Kit (ADK) 元件，作為遠端 agent 的用戶端代理）來與遠端 agent 建立通訊。
+----------------------+ +-----------------------------------+
| Root Agent | | RemoteA2aAgent |
| (Your existing code) |<------->| (ADK Client Proxy) |
+----------------------+ | |
| +-----------------------------+ |
| | Remote Agent | |
| | (External Service) | |
| +-----------------------------+ |
+-----------------------------------+
(Now talks to remote agent via RemoteA2aAgent)
最終系統（整合視圖）¶
此圖說明了消費端與提供端如何連接，組成一個完整的 A2A 系統。
Consuming Side:
+----------------------+ +-----------------------------------+
| Root Agent | | RemoteA2aAgent |
| (Your existing code) |<------->| (ADK Client Proxy) |
+----------------------+ | |
| +-----------------------------+ |
| | Remote Agent | |
| | (External Service) | |
| +-----------------------------+ |
+-----------------------------------+
|
| (Network Communication)
v
Exposing Side:
+-----------------+
| A2A Server |
| (ADK Component) |
+-----------------+
|
v
+-------------------+
| Your Agent Code |
| (Exposed Service) |
+-------------------+
具體使用案例：客服 agent 與產品目錄 agent¶
讓我們來看一個實際範例：一個客服 agent（Customer Service Agent）需要從另一個產品目錄 agent（Product Catalog Agent）擷取產品資訊。
在 A2A 之前¶
最初，您的客服 agent 可能沒有直接且標準化的方式來查詢產品目錄 agent，特別是當它是一個獨立服務或由不同團隊管理時。
+-------------------------+ +--------------------------+
| Customer Service Agent | | Product Catalog Agent |
| (Needs Product Info) | | (Contains Product Data) |
+-------------------------+ +--------------------------+
(No direct, standardized communication)
A2A 之後¶
透過使用 A2A Protocol，Product Catalog Agent 可以將其功能作為 A2A 服務對外提供。您的 Customer Service Agent 隨後可以輕鬆地利用 Agent Development Kit (ADK) 的 RemoteA2aAgent 來存取此服務。
+-------------------------+ +-----------------------------------+
| Customer Service Agent | | RemoteA2aAgent |
| (Your Root Agent) |<------->| (ADK Client Proxy) |
+-------------------------+ | |
| +-----------------------------+ |
| | Product Catalog Agent | |
| | (External Service) | |
| +-----------------------------+ |
+-----------------------------------+
|
| (Network Communication)
v
+-----------------+
| A2A Server |
| (ADK Component) |
+-----------------+
|
v
+------------------------+
| Product Catalog Agent |
| (Exposed Service) |
+------------------------+
在這個設定中，首先需要透過 A2A Server 將 Product Catalog Agent 對外公開。接著，Customer Service Agent 就可以像使用工具一樣，直接呼叫 RemoteA2aAgent 上的方法，而所有與 Product Catalog Agent 之間的底層通訊都會由 Agent Development Kit (ADK) 處理。這樣可以明確區分各自的職責，並且輕鬆整合專業化的 agent。
下一步¶
現在你已經了解 A2A 的「為什麼」，接下來讓我們深入「如何做」。
- 繼續閱讀下一份指南： 快速開始：公開你的 agent