
AgentScope 2.0 完整指南从终端调试到 4 步上线多租户智能体服务【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope我们什么时候才敢把一个会执行 shell 命令、会写文件的智能体放进生产环境AgentScope 2.0 是阿里通义实验室开源的生产级多智能体框架覆盖本地终端调试、沙箱隔离执行、权限管控、多租户服务上线的完整链路运行门槛只有 Python ≥ 3.11。这篇文章按先跑通、再谈安全、最后上线的顺序走一遍文中所有路径都能在仓库里直接验证。五分钟终端对话launch_console 替你处理交互细节 ️最快验证框架的方式是先让它在终端里跟人说话。examples/console/main.py 里智能体由LocalWorkspace组装内置文件工具、Skill 加载、文件系统长期记忆都从工作区带出来最后launch_console(agent)一行打开聊天界面流式输出、每次工具调用的人机确认、CtrlC 中断以及中断后的上下文恢复它都已处理好。配好模型 Key 即可运行export DASHSCOPE_API_KEYsk-... python examples/console/main.py复杂任务里智能体会把工作拆成可跟踪的计划边执行边更新状态终端里能看到每一步两层组件各管什么SDK 与 Agent Service 职责对照我们装第一个智能体之前先确认一件事哪些组件负责把智能体搭出来哪些负责把它变成产品。AgentScope 把这两件事放在不同层SDK 层可以完全离线使用服务层在其之上提供多租户能力层关键组件职责SDK 层ReAct 智能体Agent、工具箱Bash/Grep/Glob/Read/Write/Edit、任务规划、MCP 接入、Skill 动态加载、权限引擎、沙箱工作区、中间件、长期记忆组装并本地调试单个智能体Agent Service 层FastAPI 后端、预置 Web UI、IM 频道钉钉/飞书/Discord、RAG 知识库、定时任务、后台任务卸载、多租户存储把智能体做成多会话在线应用它的设计取向是不靠重型编排去约束模型而是信任模型自身的推理与工具调用把工程精力投到安全边界、执行环境和应用层。安全双保险先锁死代码跑在哪再定信任档位 代码到底在哪里跑8 种沙箱后端对照同一套工具箱可以绑定不同的执行后端切换后端时工具代码零改动——所有工具只面向工作区抽象具体落到哪个隔离环境由工作区决定。各后端实现集中在 src/agentscope/workspace/tests/ 目录里每类后端都有独立用例如workspace_docker_test.py、workspace_e2b_test.py后端运行位置何时选它Local本地文件系统本地开发图快首选Docker容器生产隔离多数团队的第一选择K8sKubernetes 集群已有集群、要多副本调度E2B / Daytona云沙箱无服务器、按需弹性Apple ContainermacOS 原生容器macOS 环境BubblewrapLinux 用户命名空间轻量隔离、无容器运行时OpenSandboxOpenSandbox 服务对接既有沙箱平台五种信任模式权限引擎怎么放行解决在哪里跑之后还要解决信它到什么程度。权限引擎按工具 规则做细粒度控制Bash 按命令子串匹配读写类工具按文件路径 glob 匹配规则之上再叠加五种全局模式从人在场一路覆盖到完全无人值守实现见 src/agentscope/permission/模式核心行为适用场景DEFAULT逐次询问命中放行规则或识别为安全只读命令如ls、git status才免问日常开发最稳妥ACCEPT_EDITS工作目录内的读写与常规文件操作自动放行人在场、快速迭代EXPLORE严格只读任何修改类工具或命令直接拒绝通读代码库、做方案BYPASS跳过所有检查只保留你显式配置的 deny / ask 规则沙箱内无人值守DONT_ASK把所有询问决策转成拒绝无人值守但仍要安全兜底一条实操细节值得强调BYPASS 模式下连工具自带的安全询问都不会执行所以必须配合显式 deny 规则锁住敏感路径否则等于没有护栏。想让无人值守保留安全底线用 DONT_ASK。从 Demo 到产品Agent Service 内置的产品化能力服务层基于 FastAPI租户之间、会话之间数据隔离会话与智能体状态可持久化到 SQL 或 Redissrc/agentscope/app/storage/ 提供RedisStorage与 SQL 后端。在此之上下面这些能力开箱即用IM 频道接入钉钉、飞书、Discord消息路由在服务层完成智能体团队主智能体按需创建子智能体通过内置团队工具协调分工源码见 src/agentscope/app/_tool/后台任务卸载耗时长的工具调用自动转入后台结果返回后唤醒智能体继续对话前端全程可感知定时任务与 RAG内置调度器与多租户知识库检索。三个可直接复用的示例仓库 examples/ 目录里的示例都是可运行脚本我们直接拿做法终端代码助手examples/console/先用PermissionMode.EXPLORE让智能体只读通读代码库确认无误后切到ACCEPT_EDITS动手改文件全程无需部署服务。IM 企业客服examples/rag/ examples/agent_service/index_and_search.py演示解析→切块→嵌入→入库→检索最小管线integrate_with_agent.py把知识库通过RAGMiddleware挂到智能体再把智能体挂到钉钉/飞书频道遇到不确定的操作权限系统会停下来找人确认。执行者 验证者流水线examples/pipeline/goal/GoalPipeline里一个智能体写代码另一个用结构化输出给出通过/不通过及理由不通过就把反馈原样带回重做最多迭代 N 轮两者共享同一工作区验证者检查的是真实产物而不是口头汇报。四步上线FastAPI 后端 预置 Web UI 前置条件三样Python ≥ 3.11硬门槛、Node.js ≥ 20Web UI 需要、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 后端默认端口 8000main.py里已配好 Redis 存储、三个 IM 频道与 MCP/Skill 资源库python main.py第 4 步启动 Web UI在页面里把 API 地址指向http://localhost:8000权限确认、定时任务、工具调用的完整交互即可体验cd agentscope/examples/web_ui pnpm install pnpm dev只想聊天不想部署的话跳过这四步直接跑 examples/console/main.py 即可。生产加固清单上线前逐项核对先隔离、后放权。无人值守任务最稳的组合是容器隔离 BYPASS 明确 deny 规则比默认模式 人工逐条点可控得多想保留安全底线就用 DONT_ASK。接上下文中间件。长对话的上下文会持续膨胀内置上下文中间件支持自动压缩、工具结果卸载、系统提示词/RAG/记忆注入长任务务必接上。状态落库。会话与智能体状态持久化到 SQL 或 Redis服务重启不丢进度。观测接上。依赖里已内置 OpenTelemetry SDK 与 OTLP 导出器见 pyproject.toml追踪和指标可直接汇入现有监控体系。依赖按功能裁剪。[full]包拉齐了全部可选项生产环境按实际用到的频道、向量库、记忆后端选装对应 extra 更轻。延伸资源与关键目录更新日志docs/NEWS.md路线图docs/roadmap.md当前重心语音智能体TTS→多模态→实时多模态三步走、Agent Skill 生产化、A2UI / A2A 生态权限引擎源码src/agentscope/permission/沙箱工作区源码src/agentscope/workspace/更多示例examples/agent_service/、examples/web_ui/、examples/long_term_memory/mem0/ReMe/agentic memory、examples/realtime/、examples/a2a/【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考