Codex

参考 Codex 的开放 Agent Harness,为自己的工作流设计工具连接、任务状态与审阅边界。围绕 Floatboat 中的资料处理、任务执行和结果交付,判断哪些运行机制与集成方式值得复用。

为代码任务设计可审阅的执行循环

用一项仓库修改研究完整的上下文、工具和审阅循环。请求可以比较 Codex 集成入口,先形成带证据及批准节点的执行设计,再提出安装或连接工具方案,不预设环境已经具备。

说明改动、测试命令、审阅节点和现有集成入口。

复制请求,在 Floatboat 新对话中粘贴,并提供所需资料。

下载 Floatboat

带入 Floatboat 的请求

请求可预览和复制,不会从此处自动发送。

参考来源: Codex
https://github.com/openai/codex

先阅读原始说明并核对当前环境与依赖。需要安装或连接新工具时,先提出方案。

我的任务:
参考 Codex 仓库,为我的文档导入改动设计执行流程。梳理上下文读取、文件修改、测试与审阅,比较 CLI 和 app-server 集成后再提出实现,暂不安装或连接工具。

期望交付:
包含上下文输入、工具调用、测试证据与明确审批节点的任务循环。

关于 Codex

Codex 是 OpenAI 的编程 Agent 与开放 Agent Harness。公开项目提供模型周围的执行系统,让 Agent 理解工作区、维持对话、调用工具并逐步推进任务。这里的 harness 指运行与协作软件,不等同于模型权重。

对 Floatboat 用户而言,重点是判断自己的工作流在哪个环节需要更清晰的执行循环。Codex 为连接任务上下文、工具、反馈与人工审批提供了具体参考;可以评估软件组件的复用,也可以先将这些设计原则用于现有流程。

仓库采用 Apache-2.0 许可。OpenAI 模型、订阅和托管服务有独立的访问与商业条款。开放 harness 让实现可被查看和扩展,但不能据此承诺本地源码包含所有托管 Codex 功能。

值得借鉴的工作流机制

持续上下文、受控工具循环和运行层接口共同组成 Codex 的执行参考。人或应用发起任务的入口,与任务内部怎样推进属于不同职责,借鉴机制时需要结合自己的工作流分别评估。

  • 随任务延续的上下文

    参考其上下文与会话组织方式,为多步骤工作流保留输入、决策和工具反馈,减少每一步重新解释任务的成本。

  • 有边界的工具循环

    研究工具结果如何影响下一步,再明确自己的流程哪些步骤可以继续执行、哪些节点需要人工审阅。

  • 运行层集成选择

    比较 CLI、SDK 与 app-server 的职责,判断现有工作流需要一次性任务,还是能够持续推进的 Agent 会话。

Codex的使用场景

研究资料变成草稿、仓库任务变成修改,以及 Agent 接入自有应用,都需要不同执行边界。Codex 的上下文和工具机制可供参考,审阅证据及接口选择则应结合自己的任务定义。

从研究资料到交付成果

研究工作流可以借鉴 Codex 连接上下文、工具与审阅的方式,将来源阅读衔接到经过核对的草稿。明确交付格式,保留结论背后的证据,并标出需要人工确认的决定。执行设计应说明草稿如何形成,以及最后由谁完成验收。

可重复的代码任务

对于反复出现的仓库工作,先写明任务、允许修改的文件和测试命令,再划分调查、实施、验证与批准环节。每一阶段都留下可以检查的结果,形成可复用的代码任务说明。复用的是清楚的边界,而不是要求不同任务产生相同修改。

自己的工作空间中的 Agent

如果自有应用需要掌握业务上下文和允许执行的操作,应根据这些职责选择集成方式。对照任务入口、可用操作与资料来源,比较官方文档中的 CLI、SDK 和 app-server 接口,再通过最小兼容性测试验证候选方案,而不是直接假定它适合现有环境。

区分只读调查与允许修改

仓库任务可能需要较广阅读,却只允许修改很小范围。可以参考 Codex 的受控工具循环划分阶段,明确从调查进入行动前需要什么证据。在自己的工作流中设计审阅节点并验证边界,不假定仅仅选择某个模型就能限制运行时可执行的操作。

验证 Codex 式执行循环

一项实际瓶颈比完整复制运行时更适合作为起点。明确输入、工具和批准节点,用小型任务串联执行与审阅,再根据验证结果判断哪些 Codex 接口或机制值得复用。

  1. 定位一个流程瓶颈

    先确定缺少的是上下文、工具、状态衔接还是审批节点,再判断是否需要运行层组件。

  2. 明确输入输出与边界

    为该环节写明输入、允许使用的工具、预期输出,以及必须由人作出的决定。

  3. 验证一个小型完整循环

    使用代表性输入测试完整过程,检查证据、修改与失败行为,再扩大工作流范围。

相关软件项目

比较这些项目的用途、运行条件和源码许可。

Codex 常见问题

Codex 是模型还是 Agent Harness?
Codex 的开源项目提供 Agent 与 harness 实现,负责组织上下文、工具和任务执行。它使用的模型属于系统的另一部分,不能把运行层开源理解为模型权重也在此仓库中。
CLI、SDK 和 app-server 有什么区别?
CLI 面向直接交互,SDK 用于程序化 Agent 工作流,app-server 则为需要持续对话、事件流和审批处理的应用提供会话协议。选择取决于使用场景,不必同时使用全部入口。
源码许可是否包含免费模型调用?
不包含。Apache-2.0 适用于项目源码;模型访问、订阅权益、API 调用和托管服务各自有独立条款,可能存在费用和使用限制。
Codex 能嵌入自己的应用界面吗?
可以。OpenAI 提供 app-server 与 SDK 集成说明,由应用提供界面和相关上下文,并明确 Agent 可使用哪些工具、哪些操作需要人工审阅。
开放 harness 是否包含全部托管功能?
不一定。公开运行层与集成入口不同于托管基础设施、账户功能和模型服务,具体功能是否属于源码范围,应查阅对应官方文档。
借鉴这些机制是否需要更换工作工具?
不需要。可以先将 Codex 作为任务结构、工具边界和结果审阅的设计参考,在已有工作流中验证思路。软件复用是另一项选择,需要核对兼容性、权限与许可;借鉴设计思路不会自动完成软件与 Floatboat 的连接。