🧭
入门与版本
理解 AgentScope 2.x 定位、四大支柱、版本基线与文档站双站陷阱
建立心智模型
Appearance
AgentScope事件驱动的多 Agent 框架
掌握 Agent、Toolkit、上下文、权限、沙箱、Agent Service 与 Agent Team
AgentScope 是阿里巴巴通义实验室 SysML 团队主导的多 Agent 框架。2.x（2026-05-25 发布）以"安全、高效、灵活、完备"为目标，提供统一的 Agent 类与 reply / reply_stream 事件系统、统一管理工具 / MCP / Skills 的 Toolkit、工具执行前的 Permission 三态决策、Local / Docker / E2B 三后端 Workspace 沙箱，以及 FastAPI 多租户 Agent Service 与 Leader-Worker Agent Team。
可以把 AgentScope 的 Agent 类比为一个带生命周期的 React Component，把 Toolkit 类比为按需聚合的 npm 包，把 Middleware 类比为 Koa / Redux 的洋葱模型中间件，把 Event 流类比为 SSE chunk。这个类比只用来建立直觉，不代表实现相同。
AgentScope 原生语义：Agent 是无状态 ReAct 循环引擎，通过 reply() 同步返回最终 Msg，或 reply_stream() 异步产出结构化事件；工具、MCP、Skills 统一由 Toolkit 装配并受 Permission 拦截；上下文压缩与卸载由 ContextConfig 与 Offloader（通常即 Workspace）承担；可观测性、RAG、长期记忆都以 Middleware 形式挂载。
agentscope 2.0.4（PyPI，2026-07-07）为基线，要求 Python >=3.11。docs.agentscope.io（复数）为 2.x 来源；doc.agentscope.io（单数）停滞在 1.0.21，不要使用。