AgentScope 多智能体框架实战手册4 步把智能体变成多租户在线服务【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscopeAgentScope 是阿里通义实验室开源的多智能体框架定位是生产级。它既能帮你把智能体在本地组装、调试出来也能把它交付成多租户的在线服务。无论你是刚接触多智能体框架的新手还是准备把现有智能体搬上生产这条路都能照着走。整套框架分两层SDK 层负责把智能体搭出来、本地调好Agent Service 层负责把它变成在线应用。本文按“前置检查 → 终端快跑 → 安全底座 → 服务上线 → 动手作业”的顺序展开。谁适合用先对 3 个环境门槛如果你要自己组装智能体还想让它安全地上线这个框架值得投入。它的设计取向是信任模型自身的推理与工具调用能力把工程精力放在安全边界、执行环境和应用层这三处。门槛不高30 秒核对完Python ≥ 3.11硬性要求Node.js ≥ 20仅预置 Web UI 需要Redis想跑带持久化的示例服务时要先启动一个用uv或 pip 安装依赖即可五分钟跑通带工具调用的终端对话 ️不用部署任何服务几条命令就能进入流式输出的聊天界面。launch_console把工具确认、CtrlC 中断、中断后恢复这三件事都处理好了你只需要配好模型 API Key。先装完整功能包含服务、存储、频道、工作区、RAG 等依赖uv pip install agentscope[full]再克隆源码运行 console 示例git clone https://gitcode.com/GitHub_Trending/ag/agentscope cd agentscope/examples/console export DASHSCOPE_API_KEYsk-... python main.py遇到复杂任务时智能体会先把它拆成一份计划每做完一步就回写进度终端里全程能看到变化。模型也可以用参数切换完整脚本在 examples/console/ 里想看别的模型效果直接改参数就行。按场景选沙箱后端与权限模式 安全底座由两块组成代码在哪里执行由沙箱后端决定工具能不能执行由权限引擎决定。两者互相独立可以任意组合。先说沙箱。内置代码工具覆盖 Bash、Grep、Glob、Read、Write、Edit还带任务规划、MCP 服务器接入和 Skill 动态加载。它们可以绑定 8 种执行后端换后端时工具代码不用重写。按你的环境挑Local本地文件系统本地开发图快首选Docker容器隔离多数团队上生产的第一选择K8s已有集群、要多副本调度时用E2B / Daytona云沙箱无服务器、按需弹性Apple ContainermacOS 原生容器BubblewrapLinux 用户命名空间无容器运行时的轻量隔离OpenSandbox对接既有沙箱平台再说权限。规则挂在具体工具上Bash 按命令子串匹配读写类工具按文件路径 glob 匹配。规则之外再叠加 5 种全局模式从“人在场”一路覆盖到“完全无人值守”模式核心行为适合什么时候DEFAULT每次询问安全只读命令如ls或命中放行规则才免问日常开发求稳ACCEPT_EDITS工作目录内的读写与常规文件操作自动通过人在场快速迭代EXPLORE严格只读修改类工具与命令直接拒绝读代码库、做方案BYPASS跳过所有检查只保留显式 deny 规则沙箱内无人值守DONT_ASK把“询问”决策一律转成“拒绝”无人值守但要安全兜底注意BYPASS 模式下连工具自带的安全询问也不会执行。用它时务必配好若干 deny 规则锁住敏感路径否则等于裸奔。沙箱实现集中在 src/agentscope/workspace/权限引擎在 src/agentscope/permission/测试目录里每类后端都有独立用例可查。4 步把智能体部署成多租户服务 FastAPI 后端加预置 Web UI是从 demo 走向产品最省力的路线。租户之间、会话之间数据隔离状态落到 SQL 或 Redis服务重启也不丢进度。在这之上可以直接启用IM 频道接入钉钉、飞书、Discord消息路由在服务层完成智能体团队主智能体按需生成子智能体通过内置团队工具协调分工后台任务卸载耗时长的工具调用自动转入后台结果出来唤醒智能体继续对话前端全程可感知定时任务与 RAG内置定时调度知识库检索按租户隔离观测OpenTelemetry 组件与 OTLP 导出器已在依赖里追踪指标直接进现有监控整条路径数下来正好 4 步装[full]包、克隆源码、起后端、起 Web UI。前两步你在终端快跑时已经做完了剩下两条命令cd examples/agent_service python main.pycd examples/web_ui pnpm install pnpm dev后端默认监听 8000 端口。启动 Web UI 后把 API 地址一栏填上http://localhost:8000权限确认弹窗、定时任务、工具调用这些交互都能在页面上直接操作。示例后端在 examples/agent_service/团队工具的源码在 src/agentscope/app/_tool/。三个可复现的作业终端助手、IM 客服、双智能体评审前面跑通之后仓库里还有三个完整的作业可以做。每个都对应框架的一种典型用法场景关键组件示例路径终端代码助手智能体 Bash/Edit/Grep 工具先用 EXPLORE 只读模式通读代码库再切到允许写文件的模式动手改examples/console/IM 企业客服Agent Service 多会话后端 钉钉/飞书频道 RAG 知识库检索拿不准的操作由权限系统停下找人确认examples/agent_service/、examples/rag/双智能体质量把关“执行者 验证者”流水线一个写代码另一个用结构化输出给“通过/不通过”及理由不通过就带回理由重做上限 N 轮examples/pipeline/goal/质量把关这个作业里两个智能体待在同一个工作区。验证者看的是真实产物而不是执行者的自我汇报。上线前检查清单5 条过一遍 ✅无人值守任务先关进沙箱。容器隔离 BYPASS 用 deny 规则锁住敏感路径的组合最稳想保留底线就换 DONT_ASK把询问全部转成拒绝。长对话别裸跑。上下文不清理会越来越乱接上内置上下文中间件自动压缩、工具结果卸载、提示词/RAG/记忆注入都包了。状态要落库。会话与智能体状态持久化到 SQL 或 Redis服务随便重启进度不丢。观测直接进监控。追踪和指标不用另搭栈OpenTelemetry 组件与 OTLP 导出器已在依赖树里。核对一遍前置条件。Python 要 3.11 以上Web UI 要 Node.js 20 以上[full]包依赖较重生产环境按功能裁剪着装更合适。延伸阅读文档与关键目录更新日志docs/NEWS.md路线图docs/roadmap.md当前重心在语音三步走、Agent Skill 生产化与 A2UI / A2A 生态权限引擎源码src/agentscope/permission/更多示例web_ui、long_term_memory、realtime、a2a 等examples/【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考