目前以 API 开放内测，控制台等更多功能近期即将推出。
基本概念
Managed Agents 围绕四个概念构建：Agent
模型、系统提示词、工具、MCP 服务器和 Skills 的组合定义，创建一次后可在多个会话中通过 ID 引用
Environment
声明式的运行环境配置：预装的软件包、网络访问策略等，决定会话沙箱长什么样
Session
在某个环境中运行的一个 Agent 实例，执行具体任务并产出结果
Events
你的应用与 Agent 之间交换的消息（用户输入、Agent 回复、工具调用与结果、状态更新）
适用场景
Managed Agents 最适合具备以下特征的工作负载：- 长时间执行：需要连续运行数分钟到数小时、包含多轮工具调用的任务
- 云端基础设施：需要预装软件包、可控网络访问的安全沙箱
- 最小化基建投入：不想自建 Agent 循环、沙箱和工具执行层
- 有状态会话：跨多轮交互保持文件系统与对话历史
- 定时执行：通过定时部署按 cron 计划周期性运行 Agent
工作方式
1
创建 Agent
定义模型、系统提示词、工具、MCP 服务器与 Skills。Agent 创建一次，跨会话复用。详见 定义 Agent。
2
创建 Environment
声明沙箱的软件包与网络策略，平台负责构建与预热。详见 配置运行环境。
3
启动 Session
引用 Agent 与 Environment 创建会话。详见 创建会话。
4
流式接收并发送消息
先订阅 SSE，再把用户消息作为事件发送；Agent 自主调用工具并实时回传。事件历史在服务端持久化，可随时完整拉取。详见 事件与流式输出。
5
引导或打断
在执行途中追加用户事件来引导 Agent，或打断它改变方向。
与模型 API 的差异
模型 API 提供单轮推理：发送消息、接收回复。若要让模型持续执行任务，调用方还需自行实现循环调度、上下文管理、工具执行与运行环境。Managed Agents 将这些能力纳入平台，对外以会话和事件交互：下发任务后，Agent 在云沙箱中自主运行，过程通过 SSE 回传。 短问答、低延迟对话，或不依赖沙箱与长任务状态时，直接调用模型 API 更合适。平台托管的能力
| 能力 | 直接调用模型 API | Managed Agents |
|---|---|---|
| Agent 循环 | 自行解析 tool_use、执行工具，再将结果回传模型，直至任务结束 | 平台驱动循环；一轮结束后发出 session.status_idle |
| 上下文 | 客户端维护 history，每轮回传完整对话 | 事件在服务端持久化；客户端只发送新事件并订阅增量 |
| 代码与文件 | 自行准备计算资源，并处理扩缩容与回收 | 每个会话配备云沙箱，bash 与文件读写开箱即用，会话结束即释放 |
| 密钥 | Token 容易进入提示词或进程环境 | 凭据写入 Vault，用于 MCP、自定义工具、普通 HTTPS 等出站请求的鉴权；响应不回显，沙箱无法读取原文 |
| 落库加密 | 对话与工具 I/O 以明文写入自建存储 | 可选按客户密钥加密业务事件后落库 |
| 跨会话状态 | 自行实现记忆与定时调度 | Memory 可挂载到多个会话并审计变更；定时任务按 cron 自动创建新会话 |
| 用量 | 自行从模型响应里累加 | span.model_request_end 带单次 model_usage；Session usage 累计整段会话 |
仍由调用方定义
- 角色与能力：模型、系统提示词、Skills 写在 Agent 定义中，跨会话复用。
- 工具边界：启用哪些内置工具、连接哪些 MCP、是否要求 always_ask 人工审批。
- 自定义工具：以 JSON Schema 声明；Agent 发起调用后，由你的应用执行并回传结果。适合接订单、工单等业务系统，见工具。
- 过程干预：执行中可追加用户事件引导方向，或发送 user.interrupt 打断本轮。
内置工具
Managed Agents 为 Agent 提供一组内置工具：- Bash：在沙箱内执行 shell 命令
- 文件操作：在沙箱内读取、写入、编辑和检索文件
- MCP 服务器：连接外部工具提供方，扩展 Agent 能力
- 自定义工具：由你的客户端执行的工具，Agent 发起调用、你的应用返回结果
计费
模型用量目前按开放平台 API 按量计费，暂不支持 Coding Plan。已订阅 Coding Plan 的账号，在 Managed Agents 产生的模型消耗仍按推理价格从 API 余额扣费，不会走套餐额度。
- 模型用量：按会话实际调用的模型（目前支持 glm-5.3、glm-5.3-flash），走开放平台 API 按量计费，价格与同名模型的推理价一致。见 模型价格。Coding Plan 套餐额度不能用于抵扣。
- 沙箱与运行环境：当前限时免费。后续计费规则以平台公告为准。
- MCP：接入自有 MCP 服务器的用量以开放平台公告为准。可在 MCP 市场 查看可用服务。
- Web Search / Web Fetch：尚未开放。上线后将单独计费，具体以届时公告为准。
Beta 访问
开始使用前，你需要：- 一个智谱开放平台 API Key（在智谱开放平台控制台创建）
- 在所有请求上携带版本头 zai-version: 2026-05-26 与 Beta 头 zai-beta: managed-agents-2026-05-26
/v1 开头，例如 /v1/agents）：
反馈与交流
产品还在内测初期，不少能力还不完善。欢迎扫码进群，问题与建议都可以在群里反馈。Managed Agents 内测交流群
飞书扫码入群
- 获取产品进展
- 反馈使用问题
- 与研发团队交流
下一步
快速入门
用 curl 跑通第一个会话
最佳实践
客服、数据分析等常见配法
创建会话
带上初始事件启动会话
API 参考
端点与错误码速查