运行时开箱能做什么
下面是你最常打交道的几块能力:从 SDK 入口到持久化记录、记忆与证据能力,再到外部协议与传输面。
核心 runtime
createAgentHarness、request、subscribe、resolveApproval,以及基于持久化记录的 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 在同一工作区里被发现和编译,便于复用与评审。
按生产标准验收
不止「能跑出回答」:审批、恢复、持久化记录与可观测性应默认成立;第六章提供测试、文档与发布前的核对方式。
参考资料
专题契约与深度说明放在仓库 Markdown;需要时从这里跳转,不必在章节里重复粘贴全文。各篇 docs/*.md 标题下均有
Who should read this(读者指引),便于区分「第一次接入」与「架构/维护向」长文。
运行时 dashboard
静态示意页,用来帮助你理解控制面适合展示哪些检查能力。
发行说明
由 RELEASE_NOTES.md 同步的发行记录,便于在文档站浏览版本历史。
检查契约
界定哪些 inspection 字段属于稳定 runtime,哪些属于应用自定义数据。
工具执行策略
整理工具调用、审批门槛和写类副作用的策略边界。
并列对比
公开说明智能体产品、执行框架与运行时产品层之间的差异。
长期记忆
解释持久记忆如何接入运行时,同时不替代上游记忆底座。
A2A bridge
当前智能体到智能体传输层的说明文档,以及基于运行时的外部互操作范围。
记忆策略参考
稳定的记忆策略字段、审核原因与运行时决策规则。
行为准则
开源协作时的社区行为标准。
许可证
Apache 2.0 开源许可条款。