跳转至

Open Agent Harness

无头 Agent 运行时内核

用 Markdown 定义 Agent 逻辑，按场景切换，多 Workspace 并行执行。你做产品界面，它做后端运行时。

快速开始 架构总览

它是什么

Open Agent Harness 是一个可部署的 Agent 后端运行时。它管理 Workspace 的生命周期、Agent 执行循环、工具调用和状态持久化。它不提供产品界面——你接自己的前端，它负责把 Agent 跑起来。

核心能力

  • 多 Workspace 并行 — PostgreSQL 持久化 + Redis 队列调度，支撑大量 Workspace 同时运行
  • 声明式 Agent 配置 — 用 YAML frontmatter 的 Markdown 文件定义 Agent，热加载生效
  • 能力自由组合 — agent / skill / action / tool / hook / context 按 Workspace 独立配置
  • 两种 Workspace 模式 — project（完整执行）和 chat（只读对话）
  • REST + SSE API — 全部能力通过 /api/v1 暴露，前端无关
  • 灵活部署 — 本地一体运行或 API + Worker 拆分部署

快速开始

pnpm install                                        # 安装依赖
pnpm infra:up                                       # 启动 PostgreSQL + Redis
pnpm dev:server -- --config ./server.example.yaml   # 启动后端
pnpm dev:web                                        # 启动调试控制台

启动后访问：

完整指南

从这里开始

  • 快速开始

    安装、启动、验证，5 分钟跑起来

    开始

  • 架构总览

    分层设计、核心模块、请求链路

    查看

  • Workspace 配置

    Agent、Model、Skill、Action、Hook 定义

    配置

  • 部署与运行

    本地开发、分离部署、单 Workspace 模式

    部署