Agent Communication Debugger

代理通訊調試器是一套專為維護多代理系統的開發者設計的綜合診斷工具，特別適用於使用中心輻射式 (hub-and-spoke) 架構（如 A2A 通訊框架）的系統。本技能提供結構化、系統化的方法來排查代理無響應、訊息遺失或路由邏輯錯誤等問題。它旨在協助軟體工程師與系統架構師驗證分散式代理組件（包括編排器、編碼代理、測試代理）的健康狀況，並確保 WebSocket 或基於 RAG 的儲存層等底層傳輸機制正常運作。

• 對代理進程（編排器、編碼器、測試器及 websocket_server）執行自動化健康檢查，識別掛起或無響應的實例。

• 驗證代理配置檔案 (agent.json)，檢測語法錯誤、無效的能力定義或不正確的路由主題鍵。

• 透過篩選日誌檔案 (logs/*.log) 中的特定模式（如連線例外、JSON 解析錯誤、路由決策），定位問題根源。

• 驗證傳輸層完整性，檢查 WebSocket 連接埠 (8765) 以及訊息儲存板檔案的存取權限與內容。

• 提供端到端訊息傳遞驗證指令碼，確認編排器能正確接收並回應請求。

• 支援針對路由邏輯的深入調試，檢查優先級關鍵字映射、代理發現日誌以及編排器原始碼中的備援機制。

• 簡化環境配置驗證，確認 OPENAI_API_KEY 及模型覆寫參數（如 ORCHESTRATOR_MODEL）是否正確設定。

• 前置需求包含 Python 3.10+ 環境以及對 a2a_communicating_agents/ 目錄結構的存取權限。

• 當開發環境中出現「代理無回應」或「路由錯誤」時，本工具能顯著提升排錯效率。

• 請優先查閱 common_issues.md 以獲取針對常見傳輸連接問題的解決方案。

• 在啟動完整系統重啟前，請務必確認所有環境變數已正確設定，因為錯誤的憑證常導致基於 LLM 的路由失敗。