跳转至

Open Agent Harness

无头 Agent Engine

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

快速开始 架构总览

它是什么

Open Agent Harness 是一个可部署的 Agent Engine。它运行 Agent Runtime，并通过 Agent Spec 扩展运行行为。它管理 workspace 生命周期、agent 执行循环、工具调用和状态持久化，但不提供产品界面。

仓库自带的 Web 控制台和终端 TUI 都是调试入口：Web 控制台适合浏览器内查看 trace 与存储状态，TUI 则适合在 shell 里直接选择 workspace、进入 session、观察流式输出。

核心能力

  • 多 Workspace 并行 — PostgreSQL 持久化 + Redis 队列调度，支撑大量 Workspace 同时运行
  • 声明式 Runtime 组织 — 用 Markdown 和 YAML 组织 agent/runtime 能力，热加载生效
  • 能力自由组合 — agent / skill / action / tool / hook / context 按 Workspace 独立配置
  • 统一 Workspace 结构 — 同一套目录结构承载对话、工具调用和执行能力
  • REST + SSE API — 全部能力通过 /api/v1 暴露，前端无关
  • 调试 TUI — 通过同一套 API / SSE 在终端内进行 workspace 与 session 调试
  • 灵活部署 — 最小化时可用 oah-api 内嵌 worker，拆分时使用 oah-api + oah-controller + oah-sandbox

快速开始

pnpm install                                        # 安装依赖
mkdir -p /absolute/path/to/oah-deploy-root
cp -R ./template/deploy-root/. /absolute/path/to/oah-deploy-root
export OAH_DEPLOY_ROOT=/absolute/path/to/oah-deploy-root
pnpm local:up                                       # 启动 PostgreSQL + Redis + MinIO + oah-api + oah-controller + oah-sandbox，并自动同步一次
pnpm dev:web                                        # 启动调试控制台
pnpm dev:cli -- --base-url http://127.0.0.1:8787 tui # 启动终端 TUI

启动后访问：

完整指南

从这里开始

  • 快速开始

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

    开始

  • 架构总览

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

    查看

  • 术语约定

    Engine、Runtime、Spec 的统一边界

    查看

  • Workspace 配置

    Agent、Model、Skill、Action、Hook 定义

    配置

  • 部署与运行

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

    部署

  • 调试 CLI / TUI

    终端内调试 workspace、session、catalog 和流式输出

    查看

  • K8S 上线清单

    staging 验证、production readiness、release gate

    检查

  • K8S 运维 Runbook

    leader、rollout、drain、strict egress 等故障排查

    排障