在调试人工智能代理时，开发者面临着比普通函数调试更复杂的挑战。这些 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 自定义样式，灵活调整界面的外观和风格。