概述
WorkBuddy Managed Agents 是 WorkBuddy 企业服务提供的托管智能体能力：平台侧统一托管 Agent 的定义、版本、会话与运行资源，开发者无需自建运行时，即可通过 API 构建、编排并调用企业内的智能体。该能力同时通过 Python / TypeScript ADK 与 REST API 对外开放。
本章节介绍的 WorkBuddy Managed Agents API 接口均为 API 3.0 接口。
您可以调用 API 对托管智能体进行操作，例如创建与查询 Agent、管理 Agent 版本与多版本路由、创建与查询会话、查询会话消息事件，以及浏览可用于编排的技能、专家、连接器与内置模型，并将外部 A2A Agent 绑定到指定 Agent。
WorkBuddy Managed Agents 支持的所有接口信息，请参见 API 概览。
术语表
WorkBuddy Managed Agents API 接口的常见术语请参见下表：
| 术语 | 描述 |
|---|---|
| Agent（智能体） | 托管智能体实例，由 AgentId 唯一标识，下可有多份版本。 |
| Agent 版本 | Agent 的冻结快照，承载模型、Manifest、沙箱模板等内容；区分默认版本、测试版本与生产版本。 |
| 路由 | 同一 Agent 下多个版本之间的流量分配规则，按权重决定会话落到哪个版本。 |
| 会话（Session） | 一次对话上下文，绑定到某个 Agent 与版本，由 SessionId 标识。 |
| Manifest | Agent 版本的内容声明，以 JSON 字符串传入（v2.0），描述系统提示词、编排的技能与专家、外部服务等。 |
| 技能（Skill） | 可被 Agent 编排复用的能力包，区分内置、自建与企业授权三种来源。 |
| 专家（Expert） | 面向特定领域的专家型能力包，区分内置与自建。 |
| 连接器（Connector） | 平台接入外部服务的网关条目，由平台统一管理版本与授权方式。 |
| 外部 Agent / A2A | 通过 A2A 协议在 Agent Registry 注册、不由本平台托管运行的 Agent，可绑定到指定 Agent 使用。 |
| 内置模型 | 平台预置、企业可直接绑定到 Agent 的模型条目。 |
| 消息事件（MessageEvent） | 会话内可回放的消息与工具调用记录，用于查看会话过程与排障。 |
| OneID 企业账号（AccountId） | WorkBuddy 企业账号标识，会话与资源按该账号归属。 |
| 沙箱模板 | Agent 版本运行时使用的沙箱模板，须属于当前企业且可用。 |
| RequestId | 请求唯一标识，由平台注入到每个响应，排查问题时请提供。 |
使用限制
- 鉴权：全部接口需签名并经过 CAM 鉴权。
- 超时、体积与分页：接口默认超时 10s、请求体上限 8 MB；列表接口统一用
Offset/Limit分页，默认 20 条，单页上限 100 或 200。个别接口取值不同，以接口文档为准。 - 资源约束：单个版本的 Manifest 大小不超过 256 KiB；生产版本不支持原地修改，需新建版本迭代。
- 不可逆操作：删除 Agent 会级联清理其会话与版本等关联资源，解绑外部 Agent 立即生效，调用前请确认资源 ID。
- 数据口径：会话消息事件仅返回已脱敏的消息与工具调用记录，不含推理过程等平台内部数据。
API 快速入门
您可以使用 API Explorer 工具在线调用 API。
本文以“创建 Agent > 创建版本 > 创建会话 > 查询会话消息事件”这一最短可用链路为例，通过 API Explorer 工具调用 API 接口的步骤如下：
- 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息，请参见 使用 API Explorer。
- 在产品列表中选择 WorkBuddy Managed Agents，版本选择 2026-07-09，地域按资源所在地域选择（如
ap-beijing）。 - 调用
CreateAgent（创建 Agent），填写AgentName，按需填写Description/Model/Manifest/AccountId，记录响应中的AgentId。 - 调用
CreateAgentVersion（创建 Agent 版本），填写AgentId、IsTest=false（生产版本）与Manifest，记录响应中的VersionId。 - 调用
CreateAgentSession（创建 Agent 会话），填写AgentId（可选VersionId指定版本；不传则按路由权重自选），记录响应中的SessionId与EndpointSet[0].Url（会话接入地址）。 - 调用
DescribeMessageEventList（查询消息事件列表），填写SessionId与AgentId，查看该会话的消息与工具调用记录。 - 需要核对结果时，可继续调用
DescribeAgentList/DescribeAgentVersionList/DescribeAgentSessionList查询列表。
