logs

logs 技能為開發人員與支援團隊提供強大的介面，用於檢查 Vocal Bridge 語音代理的效能與歷史記錄。透過利用底層的 Vocal Bridge CLI，此工具讓您無需離開開發環境即可檢索通話元資料、完整文字轉錄與工作階段診斷資訊。它是除錯代理行為、驗證對話品質以及審核客戶互動的重要公用程式。無論您是在對客戶服務機器人執行品質保證，還是正在調查特定失敗的通話，logs 技能都能連結雲端原始資料與工作區中可操作的洞察資訊。

• 檢索詳細的工作階段元資料，包括 UUID、來電號碼、連線方向與總持續時間。

• 提供強大的篩選功能，可按通話狀態（已完成、失敗、已放棄或進行中）與結果數量進行篩選。

• 提供對話轉錄的完整存取權，實現對代理與使用者對話流程的快速審查。

• 支援機器可讀的 JSON 輸出，允許與外部資料分析腳本或自訂報告工具整合。

• 透過公開失敗原因並識別特定工作階段識別碼，簡化錯誤追蹤以進行進一步疑難排解。

• 請確保透過 pip 安裝 vocal-bridge CLI，以確保命令正確執行。

• 使用工作階段 UUID 作為直接參數，提取特定互動的細粒度詳細資訊。

• 使用 -n 旗標限制回傳的記錄數量，有助於有效管理高流量資料串流。

• 將此技能與下載工具配對，以便在可用時擷取通話的錄音檔。

• 與狀態篩選結合使用，可快速隔離問題通話進行事後分析。

• 本工具專為在 Claude Code 環境中無縫運作而設計，並與其他 Vocal Bridge 外掛程式指令共用相同的驗證內容。