AgentScope 2.0 多智能体框架快速上手:从终端 Demo 到多租户服务
【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope
AgentScope 多智能体框架由阿里巴巴通义实验室 SysML 团队开源,当前版本 2.0.7。如果你想把 LLM 智能体放进生产环境,卡在"工具能跑但管不住"这一步,这个项目把 ReAct 智能体、5 种权限模式、沙箱工作区和多租户智能体服务打包在一起,装一个包就能组装出多智能体应用。
它能帮你解决什么问题
代码助手不再让你提心吊胆。把一套文件工具交给智能体,最怕它改着文件顺手执行rm -rf。AgentScope 多智能体框架的默认权限模式对每次工具调用都要求你确认:终端里按y允许一次,按a还会把这条权限规则记下来,同类操作之后不再询问;Grep、Read 这类只读工具则直接放行。
把智能体搬进团队 IM。客服、值班场景要求智能体常驻钉钉、飞书或 Discord。agent service 示例在main.py里注册DingTalkChannel、FeishuChannel、DiscordChannel三类渠道,平台消息经统一消息总线路由到对应会话,你不需要自己写 IM 接入层。
长任务不再卡死会话。跑一次测试套件要十分钟,会话全程挂起体验很差。服务把长时间运行的工具调用卸载到后台任务,结果回来后再唤醒智能体继续对话,前端看到的效果是会话从未中断。
核心设计拆解
🤖 ReAct 智能体:让模型自己驱动,而不是编排代码驱动
Agent类实现推理-行动循环(ReAct:模型先推理再调工具,拿到结果继续推理),内置结构化输出、执行中断与恢复、串行/并发批量工具调用。官方 README 写明设计意图是利用模型自身的推理和工具能力,而不是用严格提示词和编排流程去约束它。对你的意义:你只配置模型、工具、权限上下文,不用自己写路由和状态机。
🔐 权限系统:5 种模式覆盖交互到无人值守
PermissionMode定义了 DEFAULT、ACCEPT_EDITS、EXPLORE、BYPASS、DONT_ASK 五种模式。规则匹配按工具类型区分:Bash 命令按子串匹配,Read/Write 的文件路径按 glob 匹配。对你的意义:默认模式最安全但最频繁要确认;定时任务应该用 DONT_ASK,它把所有"待确认"直接变成拒绝。源码注释明确提醒 BYPASS 连rm -rf /这类安全检查都会跳过,只适合放进容器后再用。
📦 工作区:工具跟着沙箱走
Workspace把工具绑定到具体后端,一共 8 种:本地文件系统、Docker、E2B、Apple Container、Bubblewrap、OpenSandbox、Daytona、K8s。同一个智能体,本地调试用 LocalWorkspace,上线时换成容器后端,工具代码不用改。
从零跑通:最小路径
装。要求 Python 3.11+,带[full]可一次装齐 fastapi、redis 等服务依赖:
uv pip install agentscope[full] git clone https://gitcode.com/GitHub_Trending/ag/agentscope配。最小路径是examples/console终端示例,只需一个 DashScope API Key:
cd agentscope/examples/console export DASHSCOPE_API_KEY=sk-... python main.py启动后终端就是对话界面,流式输出、权限确认、Ctrl+C 中断都自带。可以先让它列出目录下的 Python 文件(只读,无需确认),再让它写一个文件,观察确认流程。
跑。想验证多会话、Web UI 和调度,需要 Redis 存状态、Node 20+ 跑前端:
cd agentscope/examples/agent_service && python main.py cd agentscope/examples/web_ui && pnpm install && pnpm devWeb UI 里把 API 端点填为http://localhost:8000即可使用。
进阶与扩展
接入 IM 渠道。需要智能体常驻钉钉/飞书/Discord 时,安装channelextra,参考 agent service 的main.py注册对应渠道类,填入平台凭据即可。
用 MCP 挂外部工具。服务默认带了一个 Playwright 浏览器 MCP;Web UI 里还能浏览 GitHub MCP Registry 和 ClawHub 技能中心,把 MCP 服务器一键装进工作区工具集。
换容器沙箱。智能体要在共享机器上跑不可信代码时,把 LocalWorkspace 换成 Docker 或 E2B 后端(需安装对应 extra),工具调用自动落到容器里执行。
先想清楚这几件事
- 默认模式最安全也最吵。DEFAULT 对每次工具调用都要确认,交互场景没问题;定时或后台任务必须换成 DONT_ASK 或配置允许规则,否则任务会一直挂在等待确认上。
- BYPASS 不是"自动模式"。它连安全检查都跳过,源码注释写明不拦截
rm -rf /等危险命令,只在容器内使用,并且要靠 deny 规则保护关键路径。 - agent service 强依赖 Redis。示例用
RedisStorage存智能体状态,直连 localhost:6379,环境里没有 Redis 先用 Docker 起一个。 - Grep 依赖 ripgrep。内置 Grep 工具基于 rg 实现,
toolsextra 负责给本地工作区安装 rg 二进制,缺了它文件搜索不可用。 - [full] 依赖偏重。清单里含 qdrant、elasticsearch、mem0 等向量库和记忆组件,只跑单智能体可以只装基础包加模型 extra。
项目结构速览
- README.md — 能力总览与终端、服务两条快速上手路线
- examples/console/ — 终端智能体示例,最快跑通入口
- examples/agent_service/ — FastAPI 多租户服务与 Web UI 启动入口
- src/agentscope/agent/ — ReAct 智能体、配置与结构化输出实现
- src/agentscope/permission/ — 权限引擎、5 种模式与规则匹配
适合谁、下一步做什么
如果你是需要让智能体真正动手执行工具、同时要求可控可审计的应用开发者,AgentScope 多智能体框架值得先装上试一轮:装基础包后跑examples/console,完整看一次权限确认与规则记忆流程,再据此决定你的场景该固定哪种权限模式、用哪种沙箱后端。
【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考