Centidor 文档

Coding Agent Driver

理解 Agent、Engine、Driver、Runtime、Session 与 Run,并选择 Claude Code、Codex 或 Kimi Code。

Centidor 把可复用的业务身份与实际执行工具分开管理:

  • Agent:保存名称、指令、模型来源、Skills 和执行策略;
  • Engine:选择 Managed Agent 或 Coding Agent;
  • Driver:Coding Agent 使用的工具与协议实现,例如 Claude Code、Codex、Kimi Code;
  • Runtime:实际执行位置,即 Connected Host、Cloudflare Container 或 Managed Worker;
  • Session:长期上下文,固定绑定 Agent、Project 和 Runtime;
  • Run:Session 中的一轮输入与执行。

因此,Coding Agent 不是一个常驻 CLI 进程。每个 Run 启动受控子进程;连续性由 Centidor Session、工具自身的 provider session 与固定 workspace 共同保存。

选择 Driver 与 Runtime

创建 Coding Agent 时,控制台只显示 Runtime 当前上报且版本合格的 Driver:

DriverConnected HostCloudflare ContainerSession 协议
Claude Code支持支持stream-json
Codex支持支持app-server
Kimi Code支持支持ACP stdio

具体组合还会受模型来源、权限模式和 Runtime 能力限制。控制台的禁用状态只是提示,Agent Gateway 会在创建 Agent、创建 Session、调度和派发时重复校验。

Session 与 Run

同一 Session 的第二个 Run 必须恢复第一个 Run 返回的原生 provider session。恢复失败会明确 报错,不会静默创建新上下文。Session 创建后不能切换 Runtime;Connected Host 和 Cloudflare Container 的本地状态也不能互相迁移。

活动 Run 支持结构化事件、审批和取消。模型 token 与 thinking delta 留在 Runtime 本地, 完成时由一条终态结果携带完整 assistant output、usage、artifact 与 provider session。

Skills 与凭证

Agent 选择的是不可变 Skill revision。创建 Session 时会锁定 revision,Runtime 只物化或挂载 该快照。Driver 只能读取注册表中审核过的相对 Skill 路径。

Connected Host 的“机器默认”模式沿用本机已有登录和配置;Centidor 不覆盖模型或认证变量。 AI Gateway 模式只对通过隔离验证的 Driver/Runtime 组合开放,凭证只注入子进程,不进入浏览器、 workspace、日志、事件或 artifact。

Connected Host 的配置与诊断见 Connected Host 与 Agent Session,调用已保存 Agent 见 TypeScript Agent SDK

本页内容