AgentScope 2.0

AgentScope 2.0 – 通义实验室开源的多智能体开发框架

AgentScope 2.0：赋能智能体从实验走向生产的强大引擎

由通义实验室倾力打造的AgentScope 2.0，是一款面向真实生产环境的开源多智能体开发框架。它专注于解决多智能体系统在稳定性、安全性及部署落地方面面临的挑战，并引入了一系列性的系统性能力，包括模型容错、权限管理、重构的上下文机制、可扩展的中间件、解耦的执行环境以及服务化的部署方案，旨在将智能体应用从简单的演示阶段推向成熟的生产阶段。

AgentScope 2.0 的核心亮点

• 坚若磐石的模型容错能力：AgentScope 2.0 整合了包括 Qwen、Anthropic、DeepSeek、Gemini、OpenAI、Grok、Moonshot 在内的业界主流大模型，实现统一接入。更重要的是，它引入了智能的自动重试与备用模型切换机制。当主模型调用遭遇失败时，系统会自动尝试备用模型，确保复杂长链路任务的连续性，避免因单一模型故障而中断。
• 洞悉全局的驱动与过程透明：全新的消息模块采用统一的 Content Block 承载文本、文件、图片、工具调用结果及模型思考等丰富信息。流系统更是实现了执行过程的实时可视化，用户可以清晰地追踪模型调用、文本增量输出、工具执行、用户确认等关键节点，使得整个过程可观察、可交互、可干预，彻底告别“黑盒”操作。
• 铜墙铁壁般的安全边界与权限体系：AgentScope 2.0 构建了一套系统化的权限控制体系，全面覆盖了工具调用、文件读写以及命令执行等高风险操作。基于静态规则、工具类型及输入内容进行智能风险判断，支持自动放行、拒绝或进入用户审批流程。它能够精准识别危险目录、敏感文件、高危命令以及危险删除操作，为智能体安全运行保驾护航。
• 精益求精的上下文管理重构：针对多轮对话和复杂任务，AgentScope 2.0 对上下文管理进行了深度优化。它能够结构化地压缩并保留任务目标、当前状态、关键发现以及下一步计划等核心信息。工具调用产生的超长日志将被自动截断，避免其撑爆上下文。文件读写操作新增缓存机制，并执行“先读后改”的流程，显著减少了不必要的 IO 操作。
• 灵活强大的 Middleware 扩展机制：AgentScope 2.0 允许开发者在模型调用、思考规划、工具执行等关键环节插入自定义逻辑，而无需修改框架源码。这一特性极大地增强了框架的可扩展性，可用于实现日志追踪、安全检查、业务策略注入、动态上下文注入等多样化需求。
• 切换的 Workspace 执行解耦：通过抽象执行环境，AgentScope 2.0 统一了本地、Docker 容器、E2B 云沙箱等不同后端接口。智能体的运行逻辑与执行环境实现解耦，真正做到“一次编写，随处运行”。内置的预热池机制还能支持并行场景下的批量环境初始化，提升效率。
• 生产就绪的 Agent Service 服务化部署：将 Runtime 的 Agent Service 能力整合至核心库，AgentScope 2.0 打通了开发与部署的壁垒。它提供标准的对外服务接口、流畅的流式输出以及会话恢复能力，能够稳定地被前端应用、外部系统及工作流调用，真正实现开箱即用的生产部署。

AgentScope 2.0 的技术基石

• 统一的消息传递结构：Content Block 作为核心，能够承载文本、文件/图片、工具结果、模型思考等多种模态的消息。DataBlock 则支持 base64 和 URL 两种数据源，完美兼容不同模型 API 的多模态能力。
• 驱动的架构设计：Agent 的一次回复不再是单一的文本输出，而是转化为一系列流，包括模型调用开始、文本增量、工具调用、工具结果、用户确认等。这种设计使得前端 UI 能够实时展示执行进度。
• 严谨的权限检查流程：当智能体尝试进行工具调用、文件读写或命令执行时，权限系统将依次进行规则检查、输入分析和风险判断，最终输出允许、拒绝或需要用户确认的结果。
• 智能的上下文管理策略：对于长期任务中的多轮推理、工具结果和文件内容，系统采用结构化压缩保留关键状态，并对超长工具结果进行自动截断。文件缓存机制的引入进一步优化了读取效率。
• 无缝集成的 Middleware 插桩：在模型调用、思考规划、工具执行等核心环节预留了钩子（hooks），开发者可以轻松插入自定义逻辑，实现日志、权限、上下文等横切关注点的统一处理。
• 灵活的 Workspace 抽象层：通过 WorkspaceBase 抽象出身份标识、生命周期、资源发现、上下文卸载和动态资源管理等通用能力，不同的执行后端（本地、容器、云沙箱）只需实现同一套接口即可无缝接入。

AgentScope 2.0 的使用入门

• 便捷安装：通过 pip 命令即可轻松安装 AgentScope：pip install agentscope
• 灵活配置模型：在配置文件中指定主模型和备用模型，并可自定义重试次数和切换策略。
• 快速定义智能体与工具：使用 ReActAgent 创建智能体，并将所需的工具函数注册到 Toolkit 中。
• 精细化设置权限：配置工具调用、文件读写、命令执行的权限策略，灵活定义允许、拒绝或确认规则。
• 按需选择执行环境：通过 Workspace 选择本地、Docker 容器或 E2B 云沙箱作为智能体的执行后端。
• 一键启动服务或本地运行：通过 Agent Service 启动标准接口服务，或直接通过脚本运行智能体工作流。

AgentScope 2.0 的核心优势

• 卓越的稳定性：结合模型层面的自动重试与备用切换、上下文的结构化压缩以及文件缓存机制，AgentScope 2.0 确保了长链路任务的持续稳定执行。
• 无与伦比的安全性：系统化的权限体系支持规则检查、风险判断和用户审批，为高危操作构建了完善的自动拦截与审批机制。
• 高度的透明与可控性：流系统让执行过程一目了然，支持人工确认和干预，彻底打破了智能体应用的“黑盒”状态。
• 灵活的扩展性：Middleware 机制实现了业务逻辑的即插即用，而 Workspace 则支持本地、容器及云沙箱环境的无缝切换。
• 面向生产的设计：内置的 Agent Service 提供了标准的接口、流式输出和会话恢复能力，可直接将开发原型转化为生产服务。
• 领先的多模态支持：AgentScope 2.0 集成了图像生成、TTS、语音输入、实时语音等丰富的多模态能力，并支持 MCP、A2A 等先进协议。

AgentScope 2.0 的应用场景

• 复杂企业级协作系统：适用于需要多智能体层级协作、严格组织管理的企业级业务流程自动化场景。
• 实时语音智能体应用：构建支持语音输入、实时对话的创新型多模态智能体。
• 安全敏感型任务处理：在涉及文件操作、命令执行等场景下，提供严格的权限控制和详尽的审计轨迹。
• 长周期持续性任务：支撑需要多轮推理、多次工具调用、跨轮次状态保持的复杂工作流。
• 多云/混合部署环境：满足在本地开发、容器测试、云沙箱生产之间灵活切换的需求。