Skip to content

Agents and Automation

Ericwong edited this page Aug 11, 2026 · 1 revision

Agent 与自动运行

Agent 是什么

Better Codex 的 Agent 是一套可复用的 Codex 执行配置。它不替代 Codex 模型,而是把特定角色所需的模型、推理等级、权限和指令保存为可重复分配的工作单元。

默认 Codex Agent 读取 Codex 的全局配置。自定义 Agent 可以针对代码审查、问题排查、前端实现、研究、写作或其他职责单独配置。

可配置内容

  • 名称与角色说明
  • 模型
  • 推理等级
  • 沙箱权限
  • Agent 指令
  • 最大并发数
  • 头像与显示信息

沙箱权限决定 Agent 可以读取或修改哪些本地内容。只读任务应使用更受限的权限;确实需要修改工作区时再授予写权限。

分配任务

任务可以分配给:

  • 用户本人
  • 默认 Codex Agent
  • 任意自定义 Agent
  • 暂不分配

工作目录决定 Agent 从哪里执行任务。创建或编辑任务时,应确认工作目录与实际项目一致。

手动运行

手动运行是默认的可控模式。Agent 任务不会因为被分配就立即执行,需要用户点击立即开始。它适合:

  • 需要逐项确认执行时机
  • 任务可能修改重要文件
  • 多个任务之间存在严格顺序
  • 需要先补充描述或附件

自动运行

开启自动运行后,Better Codex 会调度已分配给 Agent 且可以执行的任务,并遵守每个 Agent 的并发上限。

自动运行不会执行:

  • 待规划 中的任务
  • 已完成已取消 的任务
  • 正在等待用户处理的任务
  • 已经存在活动运行的任务

自动运行适合一组边界清晰、可以独立推进的工作。描述不完整、需要授权或有不可逆操作的任务,应保留用户审核点。

状态调度

Agent 完成一次执行后,独立的状态调度器只判断结果应该进入 已完成待审核 还是 已阻塞。调度器不执行任务,也不会代替用户做产品、发布或外部操作决定。

可以在帮助与设置中选择调度器模型和推理等级。任务最终是否符合预期,仍由用户在看板中确认。

并发建议

并发上限应根据机器资源、任务是否修改同一工作区以及任务之间的依赖关系设置。多个 Agent 同时编辑相同文件可能产生冲突;存在共享文件或严格顺序时,使用单并发或手动运行更稳妥。

Clone this wiki locally