AgentScope 2.0：阿里通义开源的生产级多 Agent 框架与 Agent Service｜部署与使用全指南

仓库：https://github.com/agentscope-ai/agentscope 官方文档：https://docs.agentscope.io/ 许可证：Apache-2.0 运行形态：Python 库 + FastAPI Agent Service + Web UI

1. 项目简介

AgentScope 2.0 是阿里通义团队开源的生产级 Agent 框架，官方定位是"production-ready, easy-to-use agent framework"。设计理念是顺着模型日益增强的推理与工具使用能力走，而不是用严格 prompt 和主观编排去束缚模型。SDK 层提供 ReAct、Toolkit、Model、Context、事件系统、权限 / HITL、中间件、记忆、沙箱等积木；另附开箱即用的 Agent Service（FastAPI 后端 + 预建 Web UI）。

1.1 核心信息一览

1.2 适用场景

• 想用 Python 快速搭一个生产级 Agent 并跑终端对话；
• 需要多租户、多会话的 Agent 服务化应用；
• 要接飞书 / Discord 等 IM 渠道、RAG、MCP / Skill Hub；
• 做多 Agent Team（leader-worker 编排）、SOP 多步任务。

1.3 能力边界（官方口径）

• 实时语音（WebRTC）、SOP、Realtime Voice Agent 等部分能力标注为 Experimental；
• 工具 / 代码执行有本地、Docker、E2B 等多种沙箱后端，生产建议用隔离沙箱；
• 各模型 Provider 凭据需自备（DashScope、OpenAI、Anthropic、Gemini、DeepSeek、Moonshot、Ollama 等）。

2. 功能特性

• ReAct：推理-行动循环，结构化输出、可中断恢复、批量（顺序 / 并发）工具执行；
• Toolkit：Python 工具、MCP server、技能管理，内置 shell / 文件编辑 / 搜索等编码工具；
• Model：跨主流 Provider 的 LLM、嵌入、TTS；
• Context：自动压缩、工具结果卸载、上下文注入（系统提示 / RAG / 记忆）中间件；
• 事件系统：统一事件总线把推理、工具调用、多模态内容流式推给前端；
• 权限与 HITL：细粒度工具 / 资源控制、确认、bypass 模式；
• 记忆：可切换后端的 Agentic 记忆（ReMe、Mem0）；
• 沙箱：本地、Docker、Apple Container、Bubblewrap、E2B、OpenSandbox、Daytona、K8s；
• Agent Service：多租户多会话、Agent Team、飞书 / Discord 渠道、RAG、MCP & Skill Hub、持久化、定时任务。

3. 官方界面预览

上图为官方 README 的架构示意（README 官方素材）。仓库内另有 team / task planning / permission bypass / background task 等演示 GIF。

4. 官方跳转链接汇总

• 仓库主页：https://github.com/agentscope-ai/agentscope
• 中文主页：https://github.com/agentscope-ai/agentscope/blob/main/README_zh.md
• 文档：https://docs.agentscope.io/
• Roadmap：https://github.com/orgs/agentscope-ai/projects/2/views/1
• 示例：https://github.com/agentscope-ai/agentscope/tree/main/examples
• Discord：https://discord.gg/eYMpfnkG8h
• 论文：https://arxiv.org/abs/2402.14034

5. 前置要求与服务器配置

• Python 3.11+（官方明确要求）；
• 模型 Provider API Key（示例用 DashScope qwen3.6-plus）；
• 跑 Web UI 需 Node.js 与 pnpm；
• 跑 Agent Service 需 FastAPI 依赖；生产建议用隔离沙箱执行工具。

6. 方式一：pip / uv 安装（推荐）

uv pip install agentscope

最小终端 Agent 示例：

from agentscope.agent import Agent
from agentscope.console import launch_console
from agentscope.tool import Toolkit, Bash, Grep, Glob, Read, Write, Edit
from agentscope.credential import DashScopeCredential
from agentscope.model import DashScopeChatModel

import os, asyncio

async def main() -> None:
    agent = Agent(
        name="Friday",
        system_prompt="You're a helpful assistant named Friday.",
        model=DashScopeChatModel(
            credential=DashScopeCredential(
              api_key=os.environ["DASHSCOPE_API_KEY"]
            ),
            model="qwen3.6-plus",
        ),
        toolkit=Toolkit(tools=[Bash(), Grep(), Glob(), Read(), Write(), Edit()]),
    )
    await launch_console(agent)

asyncio.run(main())

7. 方式二：源码与 Agent Service 运行

git clone -b main https://github.com/agentscope-ai/agentscope.git
cd agentscope
uv pip install -e .

启动 Agent Service 后端：

cd agentscope/examples/agent_service
python main.py

另开终端启动 Web UI：

cd agentscope/examples/web_ui
pnpm install
pnpm dev

8. 配置项说明

9. 常用运维命令

# 安装
uv pip install agentscope

# 源码开发安装
uv pip install -e .

# 启动 Agent Service 后端
cd examples/agent_service && python main.py

# 启动 Web UI
cd examples/web_ui && pnpm install && pnpm dev

10. 常见故障排查

• Python 版本过低：必须 3.11+，python --version 检查；
• 模型 401：检查对应 Provider API Key 环境变量；
• Web UI 起不来：确认 pnpm 已装、依赖 pnpm install 完整；
• 工具执行权限：生产环境把工具沙箱切到 Docker / E2B，不要用本地裸执行；
• Experimental 能力不稳：实时语音 / SOP 等按官方文档标注谨慎使用。

11. 风险与合规说明

• Apache-2.0 许可；
• Agent 会执行工具与代码，生产务必用隔离沙箱并配权限 / HITL；
• 模型调用费用由对应 Provider 账号承担；
• 本文为社区部署笔记，命令以官方文档最新版本为准。