企业官网建设流程全解析

AgentScope 2.0 多智能体框架部署实战：4 步上线多租户智能体服务

【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope

让智能体干活不难，难的是敢不敢把它放到用户面前：代码在哪跑、权限谁把关、多租户数据怎么隔离。AgentScope 2.0 是阿里通义实验室开源的生产级多智能体框架，覆盖沙箱隔离、权限引擎与多租户服务上线。SDK 层负责把智能体搭出来，Agent Service 层负责把它做成产品。

5 分钟拿到第一个结果

最快的验证路径不是部署服务，而是终端控制台：launch_console一行代码在终端里打开聊天界面。配好模型 API Key（如DASHSCOPE_API_KEY），直接跑examples/console/main.py即可。

几个容易踩坑的细节框架都已处理好：流式输出、工具调用的人机确认（按y放行一次，按a顺带把建议的权限规则记住，后续同类调用不再询问）、Ctrl+C 中断当前回复、中断后继续对话。复杂任务会被拆成可跟踪的计划，边执行边更新进度，终端里能直接看到每一步。

安全双底线：代码在哪跑 + 谁在把关

智能体能不能放心用，取决于两件事：执行环境怎么隔离，权限引擎怎么把关。

执行环境怎么挑

同一套工具箱可以绑定 8 种执行后端，切换后端时工具代码一行不用改。实现集中在 src/agentscope/workspace/，按隔离强度可分三档：

• 本地档
  • Local：本地文件系统，本地开发图快首选；
  • Apple Container：macOS 原生容器，macOS 环境选它；
  • Bubblewrap：Linux 用户命名空间，轻量隔离，没有容器运行时也能用。
• 容器档
  • Docker：生产隔离的默认选择，多数团队的第一站；
  • K8s：已有集群、要多副本调度时选它。
• 云沙箱档
  • E2B / Daytona：无服务器、按需弹性，想零运维选它们；
  • OpenSandbox：对接既有沙箱平台。

权限模式怎么选

权限引擎按"工具 + 规则"做细粒度控制：Bash 按命令子串匹配，读写工具按文件路径 glob 匹配，再叠加一个全局模式。按"有人值守 → 完全无人值守"排列，5 种模式是一条逐渐放手的光谱：

1. DEFAULT：默认逐次询问，命中放行规则或识别为安全只读命令（如ls）才免问。日常开发，最稳妥。
2. ACCEPT_EDITS：工作目录内的读写与常规文件操作自动放行。人在场、快速迭代。
3. EXPLORE：严格只读，任何修改类工具或命令直接拒绝。读代码库、做方案时用。
4. DONT_ASK：把所有"询问"决策转成"拒绝"。无人值守，但仍要安全兜底。
5. BYPASS：跳过所有检查，只保留你显式配置的拒绝规则。沙箱内无人值守。

一个实操细节：BYPASS 下连工具自带的安全询问都不会执行，务必用若干 deny 规则锁住敏感路径，否则等于没有护栏。

三个真实任务配方

配方 A：验证者看真实产物。目标是"第二个智能体确认后才算完成"。组合：执行者负责写代码，验证者是普通智能体，用结构化输出给出"通过/不通过"及理由；两者共享同一工作区，不通过时反馈原样带回重做，最多迭代 N 轮。验证者检查的是落盘的产物，而不是执行者的口头汇报。见 examples/pipeline/goal/。

配方 B：能安全改代码的助手。目标是先通读代码库、再动手修改。组合：ReAct 智能体 + Bash / Grep / Glob / Read / Write / Edit 工具集 + 权限模式切换——先以只读模式读代码，确认范围后切到允许写文件的模式再执行。见 examples/console/。

配方 C：查得到知识库的客服入口。目标是回答有据、不确定时停下找人的客服。组合：Agent Service 多会话后端 + IM 频道接入 + RAG 检索（解析→分块→嵌入→索引，向量库可选 Qdrant、Milvus Lite、MongoDB、Elasticsearch）。见 examples/rag/。

从聊天窗口到多租户产品

从 demo 走向产品最省力：FastAPI 后端、预置 Web UI，租户之间、会话之间数据隔离，状态可持久化到 SQL 或 NoSQL（如 Redis）。在此之上可直接启用：

• IM 频道：接入钉钉、飞书、Discord 等平台，消息路由在服务层完成；
• 智能体团队：主智能体按需创建子智能体，通过内置团队工具协调分工，源码见 src/agentscope/app/_tool/；
• 后台任务卸载：长耗时工具调用自动转入后台，结果出来后唤醒智能体继续对话，前端全程可感知；
• 定时任务与 RAG：内置定时调度与多租户知识库检索。

上线四步 + 五项自查

前置条件：Python ≥ 3.11 是硬门槛；Web UI 需要 Node.js ≥ 20；示例后端用 Redis 做存储，需先启动。

第 1 步，安装完整功能包（含服务、存储、频道、工作区、RAG 依赖）：

uv pip install agentscope[full]

第 2 步，获取源码：

git clone https://gitcode.com/GitHub_Trending/ag/agentscope cd agentscope/examples/agent_service

第 3 步，启动后端（FastAPI 服务，默认端口 8000）：

python main.py

第 4 步，启动 Web UI，并在页面里把 API 地址指向http://localhost:8000，即可体验权限确认、定时任务、工具调用的完整交互：

cd agentscope/examples/web_ui pnpm install pnpm dev

多智能体框架部署到生产前，逐项过一遍这个清单：

• 先隔离、后放权：无人值守用"容器隔离 + BYPASS + 明确 deny 规则"，比默认模式加人工逐条点更可控；想保留安全底线就改用 DONT_ASK；
• 长对话接上上下文中间件：自动压缩、工具结果卸载、系统提示词 / RAG / 记忆注入；
• 状态落库：会话与智能体状态持久化到 SQL 或 Redis，服务重启不丢进度；
• 观测接上：依赖里已内置 OpenTelemetry SDK 与 OTLP 导出器，追踪和指标可直接汇入现有监控；
• 核对前置条件：Python ≥ 3.11、Node.js ≥ 20、Redis 已启动；[full]包依赖较多，生产环境按功能裁剪安装。

延伸资源

• 更新日志：docs/NEWS.md
• 路线图（当前重心：语音智能体三步走、Agent Skill 生产化、A2UI / A2A 生态）：docs/roadmap.md
• 权限引擎源码：src/agentscope/permission/
• 沙箱后端实现：src/agentscope/workspace/
• 全部示例（agent_service、web_ui、long_term_memory、realtime 等）：examples/

【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope