首页
先选一条路线¶
教程和指南承担不同任务:教程带你完成真实闭环,指南用于准确查阅能力、配置和边界。
按任务学习15 篇教程,从首次运行一直做到 Workflow、多 Agent、恢复、Sandbox、生产存储和 SDK 专题。
一条权威执行主链¶
Run身份、预算、权限与持久化生命周期
Workflow顺序、并行、条件、Join、Fallback 与嵌套
ExecutionAgent、工具、审批、Quality Gate 与 Sandbox
RunEventTimeline、Checkpoint、Artifact、Audit 与恢复
CLI、TUI、Web 与 SDK 不各自维护运行状态;它们都是 Canonical Runtime 的不同入口和视图。
生产能力,不只是接口占位¶
Durable RuntimeRun / Step / Event / Checkpoint / Approval / Artifact / Audit 使用稳定关联标识。
Workflow 与多 Agent并发调度、确定性合并、任务 DAG、局部失败和有界重试。
Sandbox 边界Seatbelt、Bubblewrap、Docker/Podman 与 provider-neutral Remote adapter。
生产存储SQLite 单机开发,PostgreSQL 多进程 catalog,S3/MinIO 承载大型 Artifact。
60 秒开始¶
模型接入
Cody 使用 OpenAI-compatible Chat Completions 接口。模型 ID 和 Base URL 必须以你所用端点的当前文档为准;API Key 只通过环境变量或 secret manager 注入。
当前边界¶
我们会明确区分“已实现”与“需要部署方提供”的能力:
- Remote Sandbox 是 transport/handle 适配层,不是 Cody 托管的远程沙箱服务。
- PostgreSQL、S3/MinIO、Docker/Podman 和 Bubblewrap 需要对应外部服务或系统依赖。
local-policy提供路径、命令和环境策略,但不是 OS 级隔离。- 自定义 Python 扩展运行在可信宿主中,不受 guest Sandbox 隔离。
- 企业 OAuth/SSO 不是内置产品能力;Web 内置鉴权是 API Key,可通过 Auth extension 接入外部身份系统。