OpenAI 发布 Euphony：用于 Harmony 数据的开源可视化工具

在调试人工智能代理时，开发者遇到的困难远比调试普通函数要多。因为这类代理常常要经历读写文件、调用接口、生成代码等多个环节，传统的堆栈追踪并不好使。为让开发者更直观地分析和把握代理的运行过程，OpenAI 团队发布了 Euphony——一款开源的浏览器可视化工具，可把结构化的 Harmony 聊天数据与 Codex 会话日志，呈现成清晰的对话视图。

Euphony 由可复用的 Web 组件库与独立 Web 应用组成，能读取 Harmony 格式的 JSON/JSONL 以及 Codex 会话 JSONL 文件，并在浏览器里按对话时间线有序展示。它的界面简单好用，支持多种导入方式：直接粘贴 JSON、从本地文件选择，或通过公共链接加载。工具会自动判断数据类型，并以合适的方式渲染。

除基础渲染外，Euphony 提供丰富的元数据查看面板，方便在界面中查看对话与消息的详细信息。处理带额外字段的标注数据集时尤其方便。开发者还能使用基于 JMESPath 的筛选器，精准过滤所需内容。另有焦点模式、网格视图以及浏览器内编辑，让你在同一平台完成更多操作。

Euphony 支持两种使用方式：纯前端模式与后端辅助模式。纯前端模式下，应用可完全在浏览器中独立运行，无需服务器；而在后端辅助模式中，则借助基于 FastAPI 的 Python 服务来处理体量更大的数据加载与渲染。这样的架构兼顾了易用性与安全性。

对 AI 开发团队而言，Euphony 的一大优势是以可复用的 Web 组件提供，能轻松嵌入不同的前端框架。用户还可通过 CSS 定制样式，自由调整界面外观与风格。