智能体运行时文档

快速搭建可上线、可运维的企业级多智能体运行时。

agent-harness 把你的工作区(YAML、工具、技能、MCP)装配成同一套持久化运行时。第一次 request 之后即可使用审批、持久化记录、重启恢复、运行检查,以及 ACP、A2A、AG-UI、runtime MCP 等对外接入面。正文按「边界 → 装配 → 运维与发布」展开;需要接口签名或现成示例时,可随时打开 API 参考与 Cookbook。

运行时开箱能做什么

下面是你最常打交道的几块能力:从 SDK 入口到持久化记录、记忆与证据能力,再到外部协议与传输面。

核心 runtime

createAgentHarnessrequestsubscriberesolveApproval,以及基于持久化记录的 request / session / approval / event 查询与检查。

记忆与证据

持久记忆接口、产物查询、request / session 导出、evaluation bundle、回放能力,以及 flow inspection 工具,都放在同一套稳定接口里。

协议与传输

ACP、A2A、AG-UI 和 runtime MCP 都基于同一套持久化运行时边界,用来对接外部客户端或工具。

章节导读

按章节从心智模型走到工作区装配与运维,即可完成接入;需要时再到 API 与 Cookbook 查具体签名与配方。

第 1 章

起步

建立最短心智模型:何时该用、仓库长什么样、如何从安装走到第一次可治理运行。

进入章节 →

第 2 章

应用模型

弄清 requests、sessions、approvals、events 与生命周期——哪些是稳定契约,哪些留在上游执行语义。

进入章节 →

第 3 章

工作区与 YAML

按推荐布局放 catalog 与 agent;用 YAML 装配运行时,而不再造一层与上游重复的私有语义。

进入章节 →

第 4 章

工具、技能与 MCP

注册本地工具与 SKILL、配置 MCP catalog,并让 agent 显式白名单自己要用的能力。

进入章节 →

第 5 章

运行时运维

用订阅与检查 API 看清运行态;处理审批与恢复;理解排队、并发与日常运维视角。

进入章节 →

第 6 章

测试与发布

单测与集成验证、文档与 release notes、发布与 CI 自检——适合准备上线或向团队交付结果时使用。

进入章节 →

参考

API 参考

按场景分组查阅:生命周期、运行、检查、审批、记忆能力、产物读取、协议适配与 flow inspection。

进入参考 →

参考

并列对比

选型时对照:面向人的智能体产品、执行框架与 harness 各自解决什么问题。

进入对比 →

参考

协议接入

同一入口比较 ACP、A2A、AG-UI、runtime MCP:何时用哪一种接入方式。

进入参考 →

示例

Cookbook

可直接照做的配方:启动运行时、审批流、记忆能力、暴露协议面、运维面板数据与发布前自检。

进入示例 →

从安装到上线的主线

产品站说明价值与场景;开发文档带你完成装配、审批与日常运维。按章节顺序阅读,能把最短路径与参考材料串起来,比零散跳页更省时。

从边界入手

先分清一项能力属于稳定运行时契约,还是上游执行细节,再决定写进产品集成还是留在 adapter。

用 workspace 装配

catalog、tools、skills、MCP、agents 与 stores 在同一工作区里被发现和编译,便于复用与评审。

按生产标准验收

不止「能跑出回答」:审批、恢复、持久化记录与可观测性应默认成立;第六章提供测试、文档与发布前的核对方式。