Agent 与编排
注册、发布、授权、协同。
真正的问题从来不是代理某个协议，而是把 agent 当作一支受管的队伍来运营： 注册它们、安全地对外发布、分配模型与工具、盯住它们在做什么、裁决人工审批、 再协调它们跨 agent 协作。这就是 AgentGuide 控制平面的职责。
运行时
三种运行方式，一种管理方式。
agent 是一等对象，拥有路由、资源、策略、用量与健康状况 —— 无论它的代码在哪里执行。运行时类型只决定进程归谁管。
Builtin — Agent 即配置
声明一个 agent —— 它的模型路由、MCP 工具、拓扑 —— 网关就在进程内 基于内嵌的 agent 框架把它物化出来。不用构建容器，不用部署服务。 定义更新在下一轮生效，在途工作优雅收尾。
- 最深的可观测性 每一轮内部的模型调用与工具执行都有独立的追踪 span。
- 结构性治理 agent 的模型走你的 LLM 路由、工具走你的 MCP 服务，此外什么都碰不到。
- fail-closed 限制 按 agent 的并发上限与轮次超时直接拒绝而非排队；每一轮都有 panic 隔离。
- 能力感知的"大脑" 带工具的节点只绑定支持工具调用的模型；plan-execute 各角色可各配模型 —— 便宜的做规划，强的做执行。
- 会话连续性 同会话的轮次安全串行，进行中的对话绝不会被容量驱逐清掉历史。
- 自定义 Go agent 把你自己的 agent 工厂编译进二进制，用声明的方式选用。
ACP — 托管编码 Agent
网关托管 Agent Client Protocol agent（如 Codex 与 OpenCode）的生命周期： 进程池化、SSE 流式轮次、转录回放，权限请求经由你的策略裁决 —— 拒绝、自动批准或交互式人工决定。
- 进程池 空闲回收、实例上限、死实例驱逐、会话感知复用。
- 会话与转录 列出会话、回放完整对话、续接线程。
- 人在环中 权限请求出现在实时流上、经 API 裁决 —— 超时即拒绝（fail-closed）。
- 流式轮次 API 增量、推理、计划、工具调用与用量，皆为类型化 SSE 事件。
HTTP — 带上你自己的 Agent
用任意框架构建、运行在你自己基础设施上的 agent，注册后即获得身份、 路由与归因。存量与外部 agent 无需重写就能加入同一个控制平面。
- 同一套身份模型 路由、资源、策略、用量与健康，与其他运行时一致。
- 同一条事件流 agent 经网关发出的流量都归因回它本身。
- 无锁定 LangChain、ADK、自研栈 —— 网关一视同仁。
| 运行时 | 进程归属 | 适合场景 | 编排 | 观测深度 |
|---|---|---|---|---|
| Builtin | 网关（进程内） | 可组合的企业 agent、多 agent 拓扑 | 声明式拓扑 | 轮次 + 内部模型与工具 span |
| ACP | 网关（托管进程） | 编码 agent：Codex、OpenCode | 会话与权限 | 轮次事件、转录、用量 |
| HTTP | 你（外部服务） | 任意框架上的存量 agent | 经网关资源 | 可归因的网关流量 |
注册与发布
你的 Agent 资产，登记在册、产品化输出。
大多数组织答不上来"我们有哪些 agent、谁能调用它们？" AgentGuide 让这两个问题变得无聊：一个盘点所有 agent 的注册中心， 和一套把 agent 发布成受治理 API 产品的路由。
一份完整的 agent 资产清单
每个 agent —— builtin、ACP 或 HTTP —— 都是有声明式形态的注册对象： 它使用哪些模型路由、可以触碰哪些 MCP 工具、哪些路由把它对外暴露、健康与否。 workspace 视图把这一切汇聚在每个 agent 的单页里。
- 声明式能力 模型与工具绑定是 agent 定义的一部分 —— 可发现，而不是口口相传。
- 实时状态 物化状态、池化实例、在途轮次、待裁决审批。
- 健康与活动 按 agent 的健康状况、用量汇总与交互历史。
- 归属无歧义 一条路由或运行时服务至多属于一个 agent —— 归因不可能含糊。
像发布 API 一样发布 Agent
路由之后的 agent 就是一个有稳定端点的企业能力：消费方拿到一个 URL 和一把虚拟密钥； 你保有版本化的定义、按消费方的计量，以及一处吊销访问的权力。 像交付服务一样向内部团队交付 agent。
- 稳定端点 网关路由之后的流式轮次 API —— 消费方永远不直接接触运行时。
- 按密钥授权 每个消费团队或应用一把虚拟密钥，集中轮换与吊销。
- 用量计量 每个消费方的流量都落入可归因的事件流。
- 零停机更新 builtin 定义变更在下一轮生效，在途工作优雅收尾。
Builtin 拓扑
多 Agent 协作模式，声明出来而不是写出来。
builtin agent 的拓扑是其定义的一部分。把子 agent 组合成经过验证的协作模式 —— 配置时校验，运行时物化。
Single
单模型，可选工具，可选对话摘要。
Sequential
子 agent 流水线，逐级精炼上一步的结果。
Parallel
把工作扇出到多个子 agent，再合并返回结果。
Loop
迭代直至结果收敛或到达上限。
Supervisor
会调用工具的"主管"，向专家子 agent 委派任务。
Plan-Execute
规划、执行、重规划三种角色 —— 可各配不同模型，只有执行者携带工具。
Deep
研究型"主脑"，递归下钻到子 agent 获取深度。
Custom
你自己的 Go 工厂，编译进二进制、按名称选用。
Workspace 与 Workflow
从单个 Agent，到一支协同作战的队伍。
终局是多个 agent 协作交付大型复杂任务 —— 网关既是调度器、也是策略引擎、 还是"飞行记录仪"。整个平台都在为这一层打地基。
Agent workspace
每个 agent 一块单面板：定义与运行时状态、存活实例与在途轮次、 待裁决的权限请求、会话与转录索引、绑定的模型与工具资源，以及用量与交互历史。
拓扑级的团队协作
builtin 拓扑已经能让多个 agent 在同一个任务上协作 —— supervisor 委派、plan-execute 循环、并行扇出 —— 全部在一个受治理、 全程追踪的轮次内完成。
任务与调度
由网关持有的工作单元：立即在某个 agent 上执行 prompt、续接会话、 定时任务、从 agent A 交接到 agent B —— 具备持久状态、重试、取消与审计元数据。
跨 Agent 工作流
横跨独立 agent 的工作流定义与运行：交接与依赖语义、拓扑视图、人工检查点 —— 把企业级任务分解到整支 agent 舰队。
人在环中
自主执行，但保留审批通道。
重要的 agent 操作 —— 写文件、跑命令、碰生产 —— 都可以要求人来拍板。 权限请求实时推送给运营者、经 API 裁决；没有回应就等于拒绝，永远如此。 默认拒绝，安全处自动批准，关键处必须问人。