A2A (Agent2Agent) 是一種用於 Agent 之間通訊的開放協定。透過 A2A，不同的 Agent 可以探索彼此的能力、傳送訊息並返回執行結果。A2A Debugger 是一個用於偵錯 A2A Agent 的視覺化工具。你可以連線到 A2A Agent、傳送測試訊息、檢視 Agent 返回的內容、執行狀態與偵錯日誌，協助開發者快速排查 Agent 整合、訊息傳遞與返回結果中的問題。如果你正在開發或整合 A2A Agent，可以先使用 A2A Debugger 驗證該 Agent 是否能正常連線與回應，再將其整合到正式業務流程中。我們建議使用最新版 Apidog 用戶端，以體驗 AI Agent Debugger 的完整功能。
連線到 A2A Agent#
在頁面頂部輸入 Agent Card URL，然後點擊 Connect。連線成功後，頂部狀態會顯示為 Connected。此時，你可以檢視 Agent 資訊並開始傳送訊息。如果需要切換到另一個 Agent，可以點擊 Disconnect，然後重新輸入 Agent Card URL。編寫測試訊息#
在 Messages 分頁中編寫要傳送給 Agent 的測試輸入。左側：輸入訊息文字、上傳附件、設定 Metadata
傳送訊息#
如果目前尚未連線到 Agent，A2A Debugger 會先嘗試連線；連線成功後再傳送訊息。傳送後，你可以在訊息區域看到使用者訊息與 Agent 返回的內容。檢視回覆訊息#
訊息區域會顯示目前工作階段中的使用者訊息與 Agent 回覆。Agent 返回的內容可能是純文字，也可能包含任務狀態、執行結果或產生的成品。你可以透過訊息顯示區域快速判斷 Agent 是否正確理解並處理了請求。點擊任一偵錯訊息，即可在右側檢視詳情。詳情面板支援三種檢視：What is the distance between the Earth and the Moon?
檢視 Agent Card#
偵錯面板中的 Agent Card 分頁用於檢視目前已連線 Agent 的能力描述。Agent 支援的能力，例如是否支援串流回應、推播通知、狀態歷史等
新增附件#
如果目前的 Agent 支援檔案輸入，你可以點擊訊息輸入區下方的附件按鈕來上傳檔案。A2A Debugger 會根據 Agent 宣告的輸入類型判斷是否允許上傳附件：如果 Agent 僅支援文字輸入，附件按鈕將不可用
如果 Agent 僅支援特定檔案類型，你只能上傳符合類型的檔案
如果 Agent 支援任意檔案類型，你可以上傳任何檔案
設定驗證#
如果 A2A Agent 需要驗證，你可以在 Authentication 分頁中設定驗證方式。| 驗證方式 | 描述 |
|---|
| None | 不新增驗證資訊 |
| Bearer Token | 使用 token 進行驗證 |
| Basic Auth | 使用使用者名稱與密碼進行驗證 |
| API Key | 透過指定的標頭傳遞 API Key |
如果傳送訊息時返回未授權錯誤，請檢查驗證方式、token、使用者名稱/密碼或 API Key 是否正確。設定標頭#
在 Header 分頁中，你可以新增自訂請求標頭。Header 分頁上的數字表示目前已設定的有效標頭數量。展開訊息編輯區下方的 Metadata，即可為此訊息新增自訂鍵值對。Metadata 適合用於傳遞上下文識別碼、業務參數或偵錯標記。例如，你可以新增環境名稱、使用者 ID 或請求來源等資訊。FAQ#
如果連線失敗，該怎麼辦？#
1.
Agent Card URL 是否正確，且可從目前環境存取。
3.
如果需 要驗證，是否已在 Authentication 分頁中設定正確的驗證資訊。
4.
是否需要額外的標頭，例如租戶 ID、環境識別碼或閘道驗證資訊。
5.
Agent Card 返回的內容是否為有效 JSON。
成功連線後無法上傳附件？#
這通常是因為目前 Agent 未宣告支援檔案輸入，或僅允許上傳特定檔案類型。請在 Agent Card 分頁中檢視 Agent 支援的輸入類型，並確認上傳的檔案類型是否相符。如何檢視完整的請求與回應？#
在偵錯面板的 Messages 分頁中點擊對應的請求或回應日誌，然後切換到 Raw Data 檢視，即可查看完整 JSON。如果 Agent 返回的內容顯示異常，該怎麼辦？#
1.
檢查偵錯訊息中的預覽內容，確認 Agent 是否已返回結果。
3.
檢查 Agent Card 中宣告的輸入類型、輸出類型與技能是否符合預期。
