AgentScope 是阿里巴巴开源的 Agent 框架(Apache-2.0,27,000+ Stars),由阿里云数据智能团队研发,拥有两篇学术论文支撑。v2.0 定位为"生产就绪、全栈覆盖的 Agent 平台",在 v1.0 基础上全面重写,核心特性包括:事件驱动架构、三级安全防护(工具审查 + Human-in-the-Loop + 沙箱隔离)、多租户多会话服务、分布式部署、中间件系统、Web UI 开箱即用。阿里生态亲和力强(DashScope 深度集成),是面向国内企业客户推荐的首选国产 Agent 框架。
1. 项目/产品概览
| 维度 | 信息 |
|---|---|
| 项目名 | AgentScope |
| 开发者 | 阿里巴巴(阿里云数据智能团队) |
| 开源协议 | Apache-2.0 |
| 主要语言 | Python |
| GitHub Stars | 27,364(2026-06-02 查询) |
| Forks | 3,103 |
| Commits | 373(v2.0 主线) |
| 创建时间 | 2024-01-12 |
| 最近更新 | 2026-07-01(每日活跃) |
| 最新版本 | v2.0.3(2026-06-29),共 41 个 Release |
| 官网 | https://docs.agentscope.io |
| 源码仓库 | https://github.com/agentscope-ai/agentscope(注意:GitHub org 已从 alibaba 更名为 agentscope-ai) |
| 学术论文 | 2 篇 |
| 社区 | Discord(国际)、钉钉群(国内) |
2. 它主要能做什么
AgentScope 2.0 的定位是 "安全、高效、灵活、完整的全栈 Agent 框架",覆盖从开发到部署的全生命周期:
框架架构
AgentScope 2.0 全栈架构:从 Agent SDK 到多租户服务、Web UI、分布式部署,一整套生产级方案。
| 层 | 能力 | 说明 |
|---|---|---|
| Agent 核心 | ReAct Agent | 自主推理 + 工具执行,内置 Human-in-the-Loop 监管 |
| 工具系统 | Toolkit + MCP + Skills | 代码工具(Bash/Grep/Glob/Read/Write/Edit)、MCP 协议、技能组件 |
| 安全体系 | 三级防护 | 工具审查 → Human-in-the-Loop 权限 → 沙箱隔离(本地/Docker/E2B/K8s) |
| 上下文管理 | Context + Memory | 上下文压缩、长短期记忆、Mem0/ReMe 集成、向量库 |
| 中间件系统 | Middleware | 可组合钩子,非侵入式修改 Agent 运行时行为 |
| 事件系统 | Event Bus | 统一事件总线,流式事件输出,前端集成 |
| Agent 服务 | Agent Service | FastAPI 多租户多会话后端 + Web UI,一键部署 |
| 分布式部署 | Distributed | 多节点分布式 RAG、Agent Team 跨节点协作 |
3. 适用场景
| 场景 | 说明 | 典型客户 |
|---|---|---|
| 企业内部 AI 开发平台 | 统一 Agent 开发框架,标准化工具和权限管理 | 中大型企业的 AI/数字化部门 |
| 多 Agent 协作系统 | Agent Team:Leader 创建 Worker,自动协调任务 | 研发效能、自动化运维团队 |
| 编码助手 / 代码 Agent | 内置代码工具集(Bash/Grep/Glob/Read/Write/Edit),天然适合代码场景 | 开发工具厂商、IDE 插件团队 |
| 国产化/合规 Agent 平台 | 阿里背书 + DashScope 深度集成,满足信创/国产化要求 | 政府、国企、金融、医疗 |
| 多租户 SaaS Agent 服务 | 开箱即用的多租户多会话架构,适合对外提供 Agent API | Agent PaaS/SaaS 创业公司 |
| 安全敏感场景 | 三级安全防护 + 沙箱隔离,适合需要严格权限控制的场景 | 金融、安全、合规行业 |
| RAG 知识库 + Agent | 分布式多租户 RAG 服务,支持大规模文档检索 | 有大量文档需要智能查询的企业 |
4. 不太适合的场景
| 场景 | 原因 | 替代建议 |
|---|---|---|
| 简单的单次问答 | AgentScope 是完整的 Agent 框架,简单 Q&A 用更轻量的方案即可 | LlamaIndex RAG / 直接调 LLM API |
| 纯海外部署(无国内需求) | AgentScope 对 DashScope/阿里云生态有倾向性,海外生态不如 LlamaIndex/LangChain | LlamaIndex / LangChain |
| 非代码场景的轻量原型 | 框架较"重",学习曲线需要理解事件系统、权限、沙箱等概念 | OpenAI SDK / LangChain |
| 纯工作流编排(无 Agent 推理) | AgentScope 的核心是 ReAct Agent,纯步骤编排过度设计 | Dify / Coze / n8n |
| 不需要安全沙箱的场景 | AgentScope 的沙箱和安全体系有学习和配置成本 | CrewAI / Agno |
5. 核心能力清单
5.1 Agent 核心
| 能力 | 说明 |
|---|---|
| ReAct Agent | 推理-行动循环,LLM 自主决定工具调用 |
| Human-in-the-Loop | 内置人工审批/监管,可在工具执行前暂停 |
| 事件流输出 | 统一 Event Bus,实时推送 Agent 状态变化 |
| Agent Team | Leader Agent 创建/管理 Worker Agent,自动任务分配 |
5.2 工具系统
| 能力 | 说明 |
|---|---|
| 代码工具 | Bash、Grep、Glob、Read、Write、Edit(类似 Coding Agent 工具集) |
| MCP 协议 | 完整的 MCP(Model Context Protocol)支持 |
| 自定义工具 | Python 函数、Skills 组件 |
| 工具编排 | 并发/顺序执行,基于工具属性的智能调度 |
| 工具审查 | 工具级别细粒度权限控制 |
5.3 安全体系(三级防护)
| 层级 | 说明 |
|---|---|
| 第一层:工具审查 | 配置哪些工具可用、什么条件可用 |
| 第二层:HITL 权限 | 关键操作暂停等待人工确认 |
| 第三层:沙箱隔离 | 本地文件系统 / Docker / E2B / K8s 多粒度隔离(用户/Agent/会话级别) |
5.4 上下文与记忆
| 能力 | 说明 |
|---|---|
| Context 管理 | 上下文压缩、卸载策略,防止 Token 溢出 |
| Agentic Memory | 基于文件的长期记忆中间件 |
| Mem0 集成 | 第三方记忆 API 集成 |
| RAG | 分布式、多租户、多会话 RAG 服务 |
| Vector DB 集成 | 支持主流向量数据库 |
5.5 中间件系统
| 能力 | 说明 |
|---|---|
| Agent Middleware | 非侵入式钩子,修改 Agent 推理-行动循环 |
| Tool Middleware | 工具调用前后的自定义逻辑 |
| 可组合 | 多个中间件串联/并联 |
5.6 生产服务
| 能力 | 说明 |
|---|---|
| Agent Service | FastAPI 后端,一行命令启动 |
| 多租户 | 租户隔离,独立会话和数据 |
| 多会话 | 单用户多会话并发 |
| Web UI | 预置前端(examples/web_ui),Vue/Vite 技术栈 |
| 分布式 | 多节点 Agent 协作、RAG 分布式部署 |
6. 架构/部署/集成方式
部署模式
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 本地开发 | pip install agentscope,本地 Python 运行 | 开发调试、原型验证 |
| Agent Service | FastAPI 服务,一行命令 python main.py 启动 | 生产级 API 服务 |
| Web UI | 前端 pnpm dev 启动,连接后端 | 完整的多租户 Agent 平台 |
| 分布式 | 多节点部署,Agent Team 跨节点协作 | 大规模、高并发场景 |
| 沙箱 | Docker/E2B/K8s 中运行工具 | 安全隔离需求的场景 |
模型集成
- 阿里系:DashScope(通义千问系列,深度集成)
- OpenAI:GPT 系列
- Anthropic:Claude 系列
- DeepSeek:DeepSeek 系列
- 其他:通过统一 Model API 接入任意 LLM
7. 怎么用
安装
# Python 3.11+
uv pip install agentscope
# 或 pip install agentscope
第一个 Agent
from agentscope.agent import Agent
from agentscope.model import DashScopeChatModel
from agentscope.credential import DashScopeCredential
from agentscope.message import UserMsg
import os
agent = Agent(
name="Friday",
system_prompt="你是一个有用的助手。",
model=DashScopeChatModel(
credential=DashScopeCredential(api_key=os.environ["DASHSCOPE_API_KEY"]),
model="qwen3.6-plus",
),
)
async for evt in agent.reply_stream(UserMsg("Tony", "你好!")):
# 处理事件流:REPLY_START、MODEL_CALL_START、TEXT_BLOCK_DELTA 等
pass
启动 Agent 服务(多租户 + Web UI)
git clone https://github.com/agentscope-ai/agentscope.git
cd agentscope/examples/agent_service
python main.py # 启动后端
cd ../web_ui
pnpm install && pnpm dev # 另一个终端启动前端
关键截图
Agent Team — Leader 创建 Worker 并协调执行:
Agent Team 模式:Leader Agent 自动管理 Worker 池,分配和协调任务。
任务规划 — Agent 自动分解复杂任务并跟踪进度:
任务规划:Agent 将复杂任务拆分为可追踪的计划步骤,边执行边更新。
8. 售前可以怎么讲
8.1 一句话定位
"AgentScope 是阿里出品的生产级 Agent 框架 — 安全、全栈、国产可控。"
8.2 客户痛点 → 解决方案
| 客户痛点 | AgentScope 解法 |
|---|---|
| "Agent 工具执行不安全,担心删库跑路" | 三级安全防护:工具审查 + Human-in-the-Loop + 沙箱隔离 |
| "需要国产化/信创方案" | 阿里巴巴开源、Apache-2.0、DashScope 深度集成、中文文档 |
| "多租户 SaaS 服务不知道怎么搭" | Agent Service:一行命令启动多租户多会话后端 + Web UI |
| "多个 Agent 需要协作但不会编排" | Agent Team:Leader 自动创建和管理 Worker |
| "Agent 需要操作代码/文件系统" | 内置代码工具集:Bash、Grep、Glob、Read、Write、Edit |
| "Agent 上下文太长,Token 成本高" | 上下文压缩 + 长期记忆 + RAG 检索 |
8.3 差异化卖点
vs LlamaIndex / LangChain(国际化框架):
- 阿里出品,国产可控,信创友好
- 安全体系(三级防护 + 沙箱)是竞品不具备的
- 多租户多会话服务开箱即用(竞品需自己搭建)
- DashScope / 通义千问深度集成,降低国内客户使用门槛
vs Agno:
- AgentScope 安全防护更完整(三级 vs 单层 RBAC)
- AgentScope 有 Web UI 和完整的前后端分离架构
- Agno 在版本化组件和组件管理上更成熟
- 技术路线不同:AgentScope 用事件驱动 + 中间件,Agno 用原语 + 能力挂载
vs Dify / Coze(低代码平台):
- AgentScope 是代码级框架,灵活性更高
- Dify/Coze 是拖拽式低代码,适合非开发者
- 目标用户不同,可互补使用
8.4 客户价值故事线
- 切入:"你们在做 AI Agent 应用,最担心的是什么?安全?多租户?还是国产化要求?"
- 共鸣:"海外框架虽然成熟,但在安全、合规、中文支持、阿里云生态集成上都有短板。"
- 演示:10 分钟跑通第一个 Agent → 加沙箱 → 启动 Agent Service → 开 Web UI
- 进阶:单 Agent → 代码工具集 → Agent Team → 分布式部署
- 放心:阿里开源、Apache-2.0、两篇学术论文、27K Stars、社区活跃
9. 常见客户问题
| 问题 | 回答 |
|---|---|
| 和阿里其他 AI 产品(百炼、通义)什么关系? | AgentScope 是开源的 Agent 框架,可以独立使用。与 DashScope 深度集成,但与百炼平台定位不同——百炼是托管平台,AgentScope 是代码框架。 |
| 必须用阿里云的模型吗? | 不必须。支持 OpenAI、Anthropic、DeepSeek 等多种模型,与 DashScope 集成最流畅。 |
| 数据安全怎么保证? | 完全本地部署,数据不离开服务器。三级安全防护确保 Agent 不会越权操作。 |
| 沙箱隔离的原理是什么? | 本地文件系统 / Docker 容器 / E2B / Kubernetes,可配置到用户/Agent/会话级别。 |
| v1.0 能升级到 v2.0 吗? | v2.0 是完全重写(Breaking Change),API 不兼容。新项目直接用 v2.0。 |
| MCP 支持怎么样? | 完整支持 MCP 协议,Agent 可直接使用 MCP 服务器提供的工具。 |
| 有中文文档吗? | 有。README 有中文版,贡献指南也有中文版。 |
| 能和 LangChain/LlamaIndex 一起用吗? | 可以。工具系统支持 Python 函数和 Skills,可将它们封装为工具。 |
10. PoC 建议
推荐 PoC 方向:企业代码助手 Agent 平台
| 阶段 | 内容 | 时间 | 产出 |
|---|---|---|---|
| 1. 环境搭建 | pip install agentscope,配置模型 API | 0.5 天 | 可运行环境 |
| 2. 单 Agent 开发 | 构建代码助手 Agent,接入 Bash/Grep/Read/Write 工具 | 1 天 | 可用的代码 Agent |
| 3. 安全配置 | 配置沙箱(Docker),设置工具权限和 HITL | 1 天 | 安全可控的 Agent |
| 4. Agent Service | 启动多租户 Agent 服务,部署 Web UI | 1 天 | 多用户 Agent 平台 |
| 5. Agent Team | 实现 Leader-Worker 模式,任务自动分配 | 1 天 | 多 Agent 协作系统 |
| 6. 评估报告 | 测试安全防护、多租户隔离、性能表现 | 0.5 天 | PoC 评估报告 |
验证指标:
- 沙箱隔离有效性(Agent 无法越权访问)
- 多租户数据隔离(租户 A 看不到租户 B 的数据)
- Human-in-the-Loop 审批流程可用性
- Agent Team 任务分配准确率
- 并发会话下的服务稳定性
11. 风险和注意事项
| 风险 | 级别 | 说明 | 缓解措施 |
|---|---|---|---|
| v2.0 相对年轻 | 中 | v2.0 于 2026-05 发布,API 和文档仍在完善中 | 关注 Release Notes,锁定版本 |
| GitHub org 迁移 | 低 | org 从 alibaba 迁移到 agentscope-ai | 使用新 org 链接 |
| 阿里系依赖 | 低 | DashScope 集成深,非强制 | 按需选择模型提供商 |
| 海外社区规模 | 低 | 海外知名度低于 LlamaIndex/LangChain | 国内社区活跃,有论文背书 |
| 中文优先 | 低 | 文档以中文为主,英文资料相对少 | 不影响国内客户 |
| 代码工具风险 | 中 | Bash/Write/Edit 功能强大,配置不当有安全隐患 | 务必配置沙箱 + 权限控制 |
12. 我的售前判断
推荐度:强烈推荐(特别适合有国产化/安全要求的国内企业客户)
理由:
- 国产标杆:阿里巴巴出品、27K Stars、两篇学术论文——是国内 Agent 框架中技术底蕴最深的
- 安全第一:三级安全防护 + 沙箱隔离,竞品中安全体系最完整——对金融、政务等客户是杀手锏
- 生产就绪:v2.0 全力投入多租户、分布式、Web UI 等生产级特性
- 全栈覆盖:SDK + 后端 + 前端 + 分布式,一套框架搞定全链路
- 生态友好:DashScope 深度集成,MCP 支持,工具系统灵活扩展
推荐客户画像:
- 国内企业,有国产化/信创需求
- 安全敏感行业(金融、政务、医疗、能源)
- 需要多租户 Agent 平台(SaaS 创业者)
- 使用阿里云生态(DashScope、通义千问)
- 团队有 Python 基础,走代码级开发路线
不推荐的情况:
- 纯海外部署(建议 LlamaIndex/LangChain)
- 简单场景不需要安全沙箱(复杂度不值得)
- 非技术人员需要低代码平台(推荐 Dify/Coze)
- v1.0 老用户且无法投入迁移成本
13. 参考资料
- GitHub 仓库:https://github.com/agentscope-ai/agentscope
- 官方文档:https://docs.agentscope.io
- README(中文):https://github.com/agentscope-ai/agentscope/blob/main/README_zh.md
- Roadmap:https://github.com/orgs/agentscope-ai/projects/2/views/1
- 学术论文 v1.0:https://arxiv.org/abs/2508.16279
- 学术论文原版:https://arxiv.org/abs/2402.14034
- Discord 社区:https://discord.gg/eYMpfnkG8h
- PyPI:https://pypi.org/project/agentscope/
分析日期:2026-06-02 | 数据时效:GitHub 信息实时拉取,产品功能基于官方文档 v2.0.3