术语表¶

Agent Loop¶

一次用户 turn 内，模型可能多次采样、调用工具、接收工具结果并继续采样。Codex 的主实现是 run_turn。

模型动作外面的执行外壳。包括工具注册、hook、审批、沙箱、网络策略、取消、遥测和结果回写。

Codex 中原 conversation 概念的新名字。一个 thread 由 ThreadId 标识，有自己的 session、history、配置快照和持久化状态。

一个 live thread 的运行上下文。负责任务互斥、状态、服务引用、input queue、active turn、MCP、plugins、skills 等。

一次模型任务的执行单位。普通用户输入、compact、review 等都可以作为不同任务类型进入 session。

线程历史的事件化 JSONL 表示。用于恢复、回放、fork、搜索和审计。

模型上下文窗口，以及 Codex 在自动压缩后维护的逻辑窗口编号和 window id。

用模型 summary 替换长历史，减少后续 prompt token。不同于磁盘 rollout compression。

删除或截短内容，例如工具输出截断、fork 历史裁剪、compact 超限时删除最老 item。

可按需注入的任务工作流说明。它让模型知道某类任务应该怎么做，但本身不是工具执行协议。

可安装 bundle，可声明 skills、MCP servers、apps、hooks 和 interface metadata。

Model Context Protocol。Codex 通过 MCP server 获取外部工具和资源，但 MCP 工具仍会经过统一工具 harness。

持久化线程目标。通过 get_goal、create_goal、update_goal 工具管理，由 goal extension 负责续跑、记账和预算限制。

声明式权限配置，描述文件系统和网络允许范围。运行时会解析成 concrete PermissionProfile，并记录 active profile id。

来自项目、组织或云端的约束层，用来限制 config 可选值，例如允许的 sandbox mode、approval policy、hooks、网络、plugins 等。

Codex 生命周期中的策略插槽。可在输入、工具、审批、压缩、stop、subagent 等节点运行命令、prompt 或 agent handler。

基于 freeform exec 和 wait 的代码单元执行模式。支持 yielded cell 和 nested tool call。

multi-agent v2 中的 live sub-agent 管理策略。通过 LRU 卸载已完成或可安全卸载的 resident thread，控制资源占用。

实时语音/文本会话运行时。它通过 bounded channel 接收音频、文本和后台 agent handoff 输出，再把 Realtime API 事件 fanout 成 Codex protocol event。

Realtime 会话请求后台 Codex agent 执行任务的桥接机制。Codex 会把 transcript 包装成 <realtime_delegation> 输入，再把 agent 输出写回 realtime conversation。

自动审批审查机制。对 on-request 或 granular approval 请求启动专用 reviewer session，要求严格 JSON 输出，并在超时、解析失败或拒绝时 fail closed。

Codex memories 的 Phase 2 后台任务。它用受限 internal agent 在 memory workspace 中合并 Phase 1 raw memories，并通过 git baseline diff 控制输入与提交边界。

root-thread session tree 共享的加权 token 预算。它按 non-cached input 与 output token 加权计费，超限时中止 turn，并可向历史写入 developer reminder。