A2A 協議：當您的 AI Agent 需要彼此溝通

單一 AI agent 可以自動化一項任務。但真正的業務流程跨越系統、團隊和組織。您的銷售自動化需要來自市場研究 agent 的資料。您的合規 workflow 需要法律分析 agent 的判定結果。您的客服流程需要調用帳務系統 agent 來處理退款。

Agent-to-Agent (A2A) 協議讓這一切成為可能。JieGou 現已雙向支援 A2A：從您的 workflow 調用外部 agent，同時也能將您自己的 recipe 和 workflow 發布為其他人可以調用的 agent。

什麼是 A2A？

A2A 是一種協議，讓 AI agent 能夠彼此探索、驗證身份並相互調用。它建立在一個簡單的概念上：agent 在一個已知的 URL 發布自身能力的描述，其他 agent 則使用該描述來發送任務。

Agent 的能力透過 Agent Card 來描述——一個發布在 /.well-known/agent.json 的 JSON 文件。這張卡片列出了 agent 的技能、輸入/輸出結構描述、身份驗證要求和端點 URL。您可以把它想像成機器可讀的 API 規格，但對象是 AI agent 而非 REST 端點。

從 workflow 調用外部 agent

JieGou 新增了一種 workflow 步驟類型：A2A Step。將它加入 workflow 中，指向一個已註冊的 agent，將您的 workflow 資料對應到該 agent 的輸入結構描述，該步驟就會在執行時調用外部 agent。

執行流程如下：

1. 探索。 透過提供 Agent Card URL 來註冊外部 agent。JieGou 會擷取該卡片、驗證其內容，並將 agent 的能力儲存在登錄檔中。健康檢查會確認 agent 是否可達（10 秒逾時）。

2. 配置。 在 workflow 編輯器中新增 A2A 步驟。選擇已註冊的 agent、選擇一項技能，並將前一步驟的輸出對應到 agent 預期的輸入欄位。

3. 執行。 當 workflow 運作時，A2A 步驟會向外部 agent 的端點發送任務請求。JieGou 會以可配置的逾時和重試設定輪詢結果。

4. 結果處理。 Agent 的輸出會儲存在 workflow 上下文中，供下游步驟使用，就像任何其他步驟的輸出一樣。如果 agent 失敗，該步驟會遵循您的 workflow 錯誤處理策略——重試、跳過或中止。

A2A 步驟與 workflow 引擎中的所有其他功能整合：核准閘道、檢查點、平行分支、條件邏輯和錯誤處理都能正常運作。

將您的 recipe 發布為 agent

反向操作同樣重要。JieGou 中的任何 recipe 或 workflow 都可以發布為相容 A2A 的 agent。

當您建立一個託管 agent 時，JieGou 會：

1. 產生一組 API 金鑰（以明文回傳一次，以 SHA-256 雜湊值儲存）
2. 發布一張 Agent Card，將您的 recipe 輸入/輸出結構描述對應到 A2A 技能定義
3. 建立一個接受 A2A 任務請求的端點

外部系統可以透過 Agent Card 探索您的 agent、使用 API 金鑰進行身份驗證並提交任務。JieGou 會執行底層的 recipe 或 workflow，並以 A2A 格式回傳結果。

這意味著您精心調校、測試過、具有版本控制的 recipe 能夠成為可調用的服務——無需建構獨立的 API、撰寫部署腳本或管理基礎設施。

信任與身份驗證

並非所有 agent 都具有相同的信任等級。JieGou 為每個已註冊的 agent 指定一個信任層級：

• Verified — 經 JieGou 核准，已審核其可靠性
• Community — 由其他 JieGou 使用者註冊，經同儕驗證
• Self-hosted — 您自行運作的 agent
• Unknown — 未經驗證的外部 agent

身份驗證支援 API 金鑰、Bearer Token 和 OAuth2。憑證在靜態時加密儲存，僅在調用時才解密。

稽核軌跡

每一次 A2A 調用——無論是入站或出站——都會記錄以下資訊：

• 方向 — JieGou 是調用了外部 agent，還是接收了一個任務
• Agent 和任務 ID — 用於跨系統關聯
• 輸入與輸出預覽 — 為保護隱私而截斷，但足以用於除錯
• 來源中繼資料 — IP 位址、使用者代理程式、呼叫者身份
• 耗時 — 以毫秒為單位的持續時間
• 狀態 — 已提交、處理中、已完成、失敗或已取消
• Workflow 連結 — 如果該調用是 workflow 的一部分，則提供直接連結到該 workflow 執行記錄

稽核日誌可依帳戶、方向、狀態和時間範圍進行查詢和篩選。當外部 agent 失敗時，您可以追蹤確切的請求與回應，無需猜測問題所在。

何時使用 A2A

A2A 在以下情境最具價值：

• 您需要自己沒有的能力。 您的公司有一個內部的機器學習模型用於詐欺偵測。將它發布為 A2A agent，您的 JieGou workflow 就能原生調用它。

• 您正在建構多 agent 系統。 不同團隊負責不同的自動化。A2A 讓它們能在不緊密耦合的情況下組合——銷售團隊的潛在客戶評分 agent 可以將結果輸入行銷團隊的行銷活動 agent。

• 您希望將自動化作為服務提供。 將您最佳的 recipe 發布為託管 agent。合作夥伴或其他部門無需 JieGou 帳戶即可調用它們。

• 您正在與第三方 agent 平台整合。 任何支援 A2A 協議的平台都能與 JieGou 互通——無需自訂整合。

可用性

A2A 協議支援——包含入站和出站——適用於企業方案。託管 agent 建立、外部 agent 註冊以及完整的稽核軌跡均已包含在內。了解更多企業功能或申請展示。