欢迎来到AgentScope Runtime Cookbook¶

AgentScope Runtime V1.0 发布¶

AgentScope Runtime V1.0 在高效智能体部署与安全沙箱执行的坚实基础上，推出了 统一的 “Agent 作为 API” 开发体验，覆盖完整智能体从本地开发到生产部署的生命周期，并扩展了更多沙箱类型、协议兼容性与更丰富的内置工具集。

同时，智能体服务的接入方式从过去的 黑盒化模块替换 升级为 白盒化适配器模式 —— 开发者可以在保留原有智能体框架接口与行为的前提下，将状态管理、会话记录、工具注册等运行时能力按需嵌入应用生命周期，实现更灵活的定制与跨框架无缝集成。

V1.0 主要改进：

统一的开发/生产范式 —— 在开发环境与生产环境中智能体功能性保持一致
原生多智能体支持 —— 完全兼容 AgentScope 的多智能体范式
主流 SDK 与协议集成 —— 支持 OpenAI SDK 与 Google A2A 协议
可视化 Web UI —— 部署后即可立即体验的开箱即用 Web 聊天界面
扩展沙箱类型 —— GUI、浏览器、文件系统、移动端、云端（大部分可通过 VNC 可视化）
更丰富的内置工具 —— 面向生产的搜索、RAG、AIGC、支付等模块
灵活的部署模式 —— 本地线程/进程、Docker、Kubernetes、或托管云端

更详细的变更说明，以及迁移指南请参考：CHANGELOG

什么是AgentScope Runtime？¶

AgentScope Runtime 是一个面向 AI Agent 的全栈运行时，旨在解决两大核心挑战：高效部署与服务化以及安全的沙箱化执行。

简而言之： $$ \begin{aligned} \textbf{AgentScope Runtime} =&\ \textbf{工具沙箱隔离} +\ \textbf{AaaS API（Agent 即服务）} +\ \textbf{可扩展部署} \\ &+\ \textbf{全栈可观测性（日志/链路追踪）} +\ \textbf{框架兼容性} \end{aligned} $$ 本 cookbook 将引导你使用 AgentScope Runtime 构建可服务化、面向生产环境的高质量 Agent 应用。

核心架构¶

⚙️ 智能体部署运行时 (Engine)

提供AgentApp作为智能体应用主入口，同时配备部署、管理和监控智能体应用的生产级基础设施，并内置了会话历史、长期记忆以及智能体状态等服务。

🔒 沙箱执行运行时 (Sandbox)

安全隔离的环境，让您的智能体能够安全地执行代码、控制浏览器、管理文件并集成MCP 工具——所有这些都不会危及您的系统安全。

🛠️ 生产级工具服务 (Tool)

基于可信第三方 API 能力（如搜索、RAG、AIGC、支付等），通过统一的 SDK 封装对外提供标准化调用接口，使智能体能够以一致的方式集成和使用这些服务，而无需关心底层 API 的差异与复杂性。

为什么选择 AgentScope Runtime？¶

🤖 AS原生运行时框架：由 AgentScope 官方构建和维护，与其多智能体范式、适配器模式及工具使用深度集成，确保最佳兼容性与性能
🏗️ 部署基础设施：内置长短期记忆、智能体状态和沙箱环境控制服务
🔒 沙箱执行：隔离的沙箱确保工具安全执行，不会危及系统
⚡ 开发者友好：简单部署，功能强大的自定义选项
📊 可观测性：针对运行时操作的全面追踪和监控

立即开始使用 AgentScope Runtime 部署你的智能体并尝试工具沙箱吧！