AgentScope

一句话定位

阿里通义实验室出品的”为越来越 agentic 的 LLM 设计”的生产级 Python agent 框架；2.0 版围绕一个统一的、纯异步、事件流式的 ReAct Agent 重构，强调”靠模型自身的推理/工具能力而非死板 prompt 编排”，内置 Claude-Code 风格的文件工具集、技能(skill)、权限引擎、上下文自动压缩、人在环 steering、MCP/A2A 与全链路 OTel 可观测，并自带 FastAPI 多租户/多会话 agent 服务与可换的本地/Docker/E2B 沙箱运行时。

设计理念 / 顶层架构

AgentScope 2.0 是一次面向”高能力模型”的重写，与 1.0 差异极大。核心设计取舍：

• 单一统一 Agent，而非继承体系：整个框架只有一个 Agent 类(src/agentscope/agent/_agent.py:94)，2484 行把 ReAct loop、压缩、工具批处理、权限、人在环、事件流全部收敛进去。扩展不靠子类化，而靠中间件(middleware)——on_reply / on_reasoning / on_acting / on_model_call / on_system_prompt / on_compress_context 等钩子(middleware/_base.py)，洋葱/管道两种模式。
• 纯异步 + 事件流为一等公民：对外主接口是 agent.reply_stream(...)(agent/_agent.py:191) 返回 AsyncGenerator[AgentEvent]，把 reply/model-call/text/thinking/tool-call/tool-result 等拆成 24 种细粒度事件(event/_event.py:14)，UI 直接消费；reply()(agent/_agent.py:216) 只是把事件流消费成最终 Msg。
• “模型即智能”哲学：README 明确 “leverage models’ reasoning and tool use rather than constrain them”。所以没有显式 planner，规划交给模型 + 一组 Task 工具；也删掉了 1.0 的 msghub/pipeline 多智能体编排模块(本仓 src/agentscope 下已不存在)，多 agent 改由”agent 即工具/服务”与 message hub 思路在 service 层承载。
• 包结构(src/agentscope/)：agent/(统一 Agent + ReAct/Context/Model 三组 config) · message/(Msg + 8 类 ContentBlock) · model/(8 家 provider chat model) · formatter/(把 Msg 转各家 API 格式) · tool/(Toolkit + Claude-Code 式内建工具 Bash/Read/Write/Edit/Glob/Grep + Task 规划工具) · skill/(SKILL.md 技能) · permission/(规则化权限引擎，5 种 mode) · mcp/(统一 MCP 客户端) · embedding/(向量) · state/(可序列化 AgentState) · middleware/(含 _tracing OTel) · workspace/(Local/Docker/E2B 沙箱) · app/(FastAPI 多租户服务) · event/ credential/ exception/。
• 入口 API：from agentscope.agent import Agent，配 model= + toolkit=Toolkit(tools=[...])，async for evt in agent.reply_stream(UserMsg(...))。

最小示例（取自 README）：

from agentscope.agent import Agent
from agentscope.tool import Toolkit, Bash, Grep, Glob, Read, Write, Edit
from agentscope.credential import DashScopeCredential
from agentscope.model import DashScopeChatModel
from agentscope.message import UserMsg
from agentscope.event import EventType
import os, asyncio

async def main() -> None:
    agent = Agent(
        name="Friday",
        system_prompt="You're a helpful assistant named Friday.",
        model=DashScopeChatModel(
            credential=DashScopeCredential(api_key=os.environ["DASHSCOPE_API_KEY"]),
            model="qwen3.6-plus",
        ),
        toolkit=Toolkit(tools=[Bash(), Grep(), Glob(), Read(), Write(), Edit()]),
    )
    async for evt in agent.reply_stream(UserMsg("Tony", "Hi, Friday!")):
        match evt.type:                      # 消费细粒度事件流驱动 UI
            case EventType.REPLY_START: ...
            case EventType.MODEL_CALL_START: ...
            case EventType.TEXT_BLOCK_DELTA: ...

asyncio.run(main())

组件实现（横向逐项）

设计权衡与特性

• “统一 Agent + 中间件” vs 多类继承：与多数框架用 “BaseAgent→ReActAgent→…” 继承树不同，AgentScope 2.0 把所有能力塞进一个 Agent，用 middleware 钩子横切扩展。优点是行为可预测、事件流统一；代价是单文件 2484 行、定制需懂钩子链与内部状态机。
• 强 ReAct、弱编排：刻意”相信模型”——无 planner、无强约束 prompt 编排，规划只给 Task 工具。这押注于高能力模型；若用弱模型，缺少脚手架可能不稳。
• 2.0 是断代式重写：1.0 的 msghub/pipeline 多智能体原语、memory 模块在 2.0 src/agentscope 下已不存在。多 agent 与记忆改由 service 层 / observe() / embedding 自接承载——查 1.0 教程会对不上。
• Claude-Code 同款电池：内建 Bash/Read/Write/Edit/Glob/Grep 文件工具 + SKILL.md 技能 + 5 档权限 mode + 文件读缓存，几乎是把 Claude Code 的 harness 能力开源化；且兼容 SKILL.md 技能格式。
• 可观测与生产是卖点：OTel 为强依赖(非可选)，FastAPI 多租户服务 + Docker/E2B 沙箱 + Redis 会话 + apscheduler 调度，明显面向”上云/上 K8s”而非玩具 demo。
• 待确认：① README 宣称内置 evaluation / multi-agent message hub，但本仓 src/agentscope 下未见独立 eval 包、msghub 已删，二者更像 roadmap/docs 层能力(待确认)；② embedding 模块存在但默认不与 Agent 记忆自动联动，需开发者自接。

关联

• component-taxonomy · single-vs-multi-agent · multi-agent-orchestration · context-engineering
• 同范式(single+电池/平台)：connectonion · 源码：agents-example/agentscope/