Managed Agents 是百炼提供的智能体托管运行时，适用于多步工具调用、代码执行、文件处理等长时运行任务。平台托管会话状态、沙箱环境和工具执行，智能体在独立沙箱中自主执行命令、读写文件、安装依赖并处理数据，事件历史在服务端持久化。
与智能体应用的区别
| 维度 | 智能体应用 | Managed Agents |
|---|---|---|
| 运行模式 | 无状态调用，应用侧维护上下文 | 服务端维护会话状态，支持中断与续接 |
| 执行环境 | 共享运行时 | 独立沙箱，云端容器 |
| 事件模型 | 响应级流式输出 | 会话级 SSE 事件流，事件历史持久化 |
| 典型场景 | 问答、对话、轻量任务 | 多步工具调用、代码执行、文件处理等长时运行任务 |
核心概念
| 概念 | 说明 |
|---|---|
| 智能体（Agent） | 模型、系统提示词、工具、MCP 服务和 Skill 的组合配置。创建后通过 ID 引用，可在多个会话中复用。 |
| 运行环境（Environment） | 会话运行的沙箱配置，由百炼托管的云端容器。 |
| 会话（Session） | 智能体在指定环境中的一次运行实例，执行任务并生成输出。 |
| 事件（Event） | 应用与智能体之间交换的消息，包括用户消息、工具调用结果和状态变更。 |
支持的工具
智能体通过以下工具与运行环境交互：
- 命令执行：在沙箱中运行 shell 命令
- 文件操作：上传文件挂载到沙箱，或从 URL 下载；支持读取、写入、编辑、查找、搜索
- MCP 服务：接入外部工具服务
- Skill：挂载预置的工具组合，封装端到端任务流程
工作流程
- 创建智能体：配置模型、系统提示词、工具和 MCP 服务。创建后通过 ID 引用。
- 配置运行环境：创建云端容器沙箱，按需配置预装包。
- 发起会话：创建引用智能体和环境配置的会话实例。
- 发送事件，接收响应：发送用户消息，智能体自主执行工具调用，通过 SSE 事件流推送结果。事件历史在服务端持久化。
- 干预或中断：在执行过程中发送新事件引导方向，或中断当前任务。
适用场景
- 长时运行：任务涉及多步工具调用，持续数分钟到数小时。
- 代码执行：在沙箱中运行脚本、安装依赖、调试程序。
- 文件处理：读写、搜索、编辑沙箱内文件。
- 有状态会话：跨多轮交互保持上下文和文件系统状态。
- 快速开发 / 低运维开销：专注于 Agent 逻辑，而非从零开始构建和维护代理循环、沙箱编排或工具执行基础设施。