基于 Codex Harness 构建自己的智能体界面｜OpenAI Dominik Kundel

📌 One-Sentence Summary

OpenAI 的 Dominik Kundel 介绍如何通过开源 App Server 协议和 120 多种客户端消息复用 Codex Harness，并现场演示自定义界面，甚至让 Codex 在 Doom 游戏里运行。

📝 Summary

OpenAI Codex 开发者体验工程师 Dominik Kundel 介绍了 Codex App Server：它以类似 JSON-RPC 的协议封装 Codex Harness，既支撑 Codex 官方应用和 IDE 扩展，也供第三方客户端接入。Harness 和协议以 Apache 2 许可开源，可连接兼容 Responses API 的模型供应商。他用事件检查器演示客户端与服务端之间的实时通信，并说明 120 多种消息覆盖会话、目标、插件、文件搜索等能力。定制客户端时，可以追加开发者指令、注册动态工具，并将工具标记为延迟加载，以免占满上下文；模型、供应商及沙箱权限也可按会话配置。App Server 随 Codex CLI 二进制分发，协议持续变化，因此他建议应用自带匹配版本的二进制，并生成相应的 TypeScript 绑定或 JSON Schema。接入方式包括新的 Python SDK，或直接让 Codex 编写客户端。现场演示把 Codex 放进 Doom 界面，同时赋予游戏操作工具与真实终端能力。最后他区分了适合脚本任务的 codex exec 与适合完整交互客户端、并行会话的 App Server。演讲给出了实用的集成取舍，但协议细节与性能限制仍是概览。

💡 Main Points

Codex App Server 是封装 Codex Harness 的开放协议。

它支撑官方应用和 IDE 扩展，也可供 JetBrains、Xcode 等第三方客户端使用；协议提供比通用 Agent Client Protocol 更细的 Harness 控制，并允许连接兼容 Responses API 的模型。

120 多种客户端消息向自定义界面开放应用级能力。

消息涵盖会话与轮次管理、目标、插件、文件搜索和文件系统操作。用户还可通过 ChatGPT 登录，让使用量计入自己的 Codex 配额。

用开发者指令和延迟加载的动态工具定制行为。

开发者指令追加到针对模型调优的系统提示之后，动态工具可经工具搜索按需发现，减少上下文占用；模型、供应商和沙箱权限也能按会话配置。

应用应自带匹配版本的 Harness 二进制。

App Server 随 Codex CLI 发布，协议会随版本演进。随应用打包二进制，并生成对应版本的 TypeScript 绑定或 JSON Schema，可以降低兼容性风险；Python SDK 也是可用入口。

完整交互客户端用 App Server，脚本任务用 codex exec。

codex exec 适合 CI 等非交互任务；App Server 更适合自定义客户端和并行会话。Doom 演示表明界面可以脱离传统聊天形态。

💬 Key Quotes

App Server 实际上是封装 Codex Harness 的协议。

它让 Codex 通过工具搜索找到这些工具，而不是占满整个上下文窗口。

我想的是，怎样让 Codex 在 Doom 里面运行，而不是在 Codex 里面运行 Doom。

你应该随应用发布自己的 Harness 版本。这能省去许多麻烦。

构建 Harness 时，我们必须不断考虑如何让提示保持在模型适用范围内，并让智能体表现良好。

📊 Article Meta

AI Screening： 91

Featured： Yes

Source： AI Engineer

Author： AI Engineer

Category： 人工智能

Language： 英文

Read Time： 14 min

Word Count： 3298

Tags：

AI 与智能应用 , AI Agent , Harness工程 , 开发者工具 , API设计

Play Full Video