长期维护的 Agent Engine 文档Open Agent Harness 文档总览
Section titled “Open Agent Harness 文档总览”用 Markdown 组织 Runtime,让多 Workspace 并行执行。OAH 负责 workspace 生命周期、agent 执行循环、工具调用、队列调度和状态持久化;WebUI、TUI、Desktop 都通过同一套 REST + SSE API 接入。
TypeScript Engine
PostgreSQL + Redis
REST + SSE
Runtime Spec
pnpm install
export OPENAI_API_KEY=sk-...
pnpm dev:cli -- daemon start
pnpm dev:web
pnpm dev:cli -- tui
WebUI
TUI
Desktop
OAH API
Controller
Workers
Storage
推荐阅读路径
Section titled “推荐阅读路径”从运行、配置、架构到 API,对新加入的维护者也比较友好。
核心文档入口
Section titled “核心文档入口”围绕长期维护常见任务组织,而不是按文件堆目录。
入门与定位从本地启动、术语、设计总览建立维护者共同语境。
Runtime 配置编写、发布和维护可复用 runtime 模板。
Workspace SpecSettings、Agent、Model、Skill、Action、Hook、MCP。
Engine 内部设计生命周期、上下文、执行后端、队列可靠性和事件审计。
API 与 SchemaOpenAPI 3.1、服务端配置 Schema、workspace 配置 Schema。
部署与运维本地开发、embedded worker、split deployment、K8S 路径。
路线图当前进度、实现路线图、worker scale 与生产成熟度。
OAH 的文档应该帮助维护者快速判断:改哪里、影响谁、怎么验证。
Client SurfacesWebUI、TUI、Desktop 只消费 OAH-compatible API,不拥有 engine 状态。
Control PlaneAPI、controller、queue、placement、rebalance 共同管理并发 workspace。
Execution Planeembedded worker 或 sandbox worker 执行 run,并同步 workspace 状态。
Storage PlanePostgreSQL 是中心事实源,Redis 负责队列与协调,对象存储承载 workspace backing store。