在調試人工智能代理時，開發者面臨着比普通函數調試更復雜的挑戰。這些 AI 代理通常涉及多個步驟，如讀取文件、調用 API、編寫代碼等，而傳統的堆棧跟蹤方法並不適用。爲了幫助開發者更有效地分析和理解 AI 代理的工作過程，OpenAI 團隊推出了 Euphony，這是一款開源的瀏覽器可視化工具，旨在將結構化的 Harmony 聊天數據和 Codex 會話日誌轉化爲易於理解的對話視圖。

image.png

Euphony 的核心是一個 Web 組件庫和獨立的 Web 應用程序，可以接收 Harmony 格式的 JSON/JSONL 數據或 Codex 會話 JSONL 文件，並在瀏覽器中以結構化的對話時間線形式展示。這款工具具有友好的用戶界面，支持通過多種方式加載數據，包括直接粘貼 JSON 數據、從本地文件加載，或通過公共 URL 加載數據。Euphony 能自動識別數據格式，並根據不同情況進行相應的渲染。

除了基本的渲染功能，Euphony 還提供了豐富的元數據檢查面板，便於開發者在用戶界面中查看對話和消息的詳細元數據。這在處理帶有額外字段的註釋數據集時特別有用。開發者還可以利用基於 JMESPath 的過濾功能，精準篩選出所需的信息。此外，Euphony 還具備焦點模式、網格視圖和瀏覽器內編輯功能，方便用戶在一個平臺上進行各種操作。

Euphony 提供了兩種運行模式：僅前端模式和後端輔助模式。在前端模式下，整個應用可以在瀏覽器中獨立運行，無需依賴服務器。而在後端輔助模式下，使用 FastAPI Python 服務器來處理大型數據集的加載和渲染。這一設計充分考慮了開發者在使用過程中的便利性和安全性。

對於 AI 開發團隊來說，Euphony 的一個亮點是它以可重用的 Web 組件形式提供，能夠輕鬆嵌入到各種前端框架中。用戶可以通過 CSS 自定義樣式，靈活調整界面的外觀和風格。