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