README_zh.md
English Homepage | 文档 | 路线图
</span> <p align="center"> <a href="https://arxiv.org/abs/2402.14034"></a>
<a href="https://pypi.org/project/agentscope/">
</a>
<a href="https://pypi.org/project/agentscope/">
</a>
<a href="https://discord.gg/eYMpfnkG8h">
</a>
<a href="./LICENSE">
</a>
<a href="https://deepwiki.com/agentscope-ai/agentscope">
</a>
AgentScope 2.0 是一款面向生产、易于使用的智能体框架,提供与不断进化的模型能力相匹配的核心抽象。
AgentScope 的目标是充分发挥大模型的推理与工具调用能力, 而非用严格的提示词和固化的编排方式来束缚它们。
集成: 支持飞书(Lark)与 Discord 频道。飞书 | Discord功能: 支持消息频道 —— 将智能体接入即时通讯平台。样例 | 文档集成: 内置集成 GitHub MCP Registry 与 ClawHub。样例 | 文档功能: 支持 MCP & Skill Hub —— 浏览 hub、安装到个人库、再添加到工作区。样例 | 文档集成: 集成 Daytona 工作区/沙箱实现。 文档集成: 集成 K8s,OpenSandbox 工作区/沙箱实现。 文档集成: 集成 ReMe 长期记忆。 样例 | 文档功能: 支持 Agentic Memory。 样例 | 文档功能: 支持分布式 & 多租户 & 多会话 RAG 服务。 文档功能: 支持多模态 RAG。 样例 | 文档欢迎加入我们的社区
| Discord | 钉钉 |
|---|---|
AgentScope 需要 Python 3.11 或更高版本。
uv pip install agentscope
# 从 GitHub 拉取源码
git clone -b main https://github.com/agentscope-ai/agentscope.git
# 以可编辑模式安装
cd agentscope
uv pip install -e .
SDK 层 —— 用一整套丰富的构建模块组合出你的智能体:
| 构建模块 | 包含内容 |
|---|---|
| ReAct | 推理-行动循环,支持结构化输出、实时中断与恢复、以及批量(顺序 / 并发)工具执行 |
| 工具集 | 智能体自主工具管理(囊括 Python 工具、MCP 与 Skill);内置编码工具(Shell、文件编辑、搜索)与任务/规划工具开箱即用 |
| 模型 | LLM、Embedding、TTS,覆盖主流厂商(OpenAI、Anthropic、Gemini、DashScope、DeepSeek、Moonshot、xAI、Ollama) |
| 上下文 | 自动压缩、工具结果卸载、以及上下文注入(系统提示、RAG、记忆),均由内置中间件实现 |
| 事件系统 | 统一事件总线,将推理、工具调用与多模态内容(文本、图像、音频)流式推送到前端 |
| 权限与 HITL | 对工具和资源的细粒度控制、确认、bypass 模式 |
| 中间件 | 贯穿整个循环的可组合钩子 —— 回复、推理、行动、模型调用、权限检查、上下文压缩、系统提示 |
| 记忆 | Agentic Memory,可切换后端(ReMe、Mem0) |
| 工作空间 / 沙箱 | 隔离工具与代码执行 —— local、Docker、Apple Container、Bubblewrap、E2B、OpenSandbox、Daytona、K8s |
使用 AgentScope 2.0,启动你的第一个智能体:
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!")):
# 处理事件流,例如打印消息、更新 UI 等
match evt.type:
case EventType.REPLY_START:
...
case EventType.MODEL_CALL_START:
...
case EventType.TEXT_BLOCK_START:
...
case EventType.TEXT_BLOCK_DELTA:
...
case EventType.TEXT_BLOCK_END:
...
# 处理其他事件类型
asyncio.run(main())
AgentScope 提供开箱即用的智能体服务 —— 一个基于 FastAPI 的后端,并在 examples/web_ui 中附带预构建的 Web UI,将你的智能体变成一个多租户、多会话的应用,并自带一整套丰富的能力:
| 能力 | 包含内容 |
|---|---|
| 服务 | 多租户、多会话隔离、FastAPI 后端、预构建 Web UI |
| 智能体团队 | Leader–Worker 编排、内置团队工具、任务规划 |
| 消息渠道 | 将智能体接入 IM 平台 —— 飞书(Lark)、Discord、自定义渠道、消息路由 |
| RAG 服务 | Blob 存储、索引 Worker、多租户检索 |
| MCP & 技能 Hub | 浏览 Hub(GitHub MCP Registry、ClawHub)、安装到你的库、添加到工作空间 |
| 资源共享 | 面向 group 与 org 的资源管理,共享模型、MCP 服务、技能与工作空间 |
| 持久化 | 智能体状态与会话的 SQL & NoSQL 持久化 |
| 调度 | 定时任务、智能体唤醒、后台任务卸载 |
以上能力皆可组合,你只需少量胶水代码,就能在此服务之上搭建起自己的应用。
<table> <tr> <td align="center"> <sub><b>智能体团队</b> —— leader 智能体派生 worker,并通过内置的团队工具进行协调。</sub>
</td>
<sub><b>任务规划</b> —— 智能体将复杂工作拆解为可追踪的计划,并在执行过程中持续更新。</sub>
</td>
<sub><b>bypass 模式下的权限控制</b> —— 智能体端到端运行,无需为工具调用确认而暂停。</sub>
</td>
<sub><b>工具后台执行</b> —— 长时间运行的工具被转入后台;其结果稍后唤醒智能体并恢复对话。</sub>
</td>
运行以下命令启动智能体服务后端和 Web UI:
git clone -b main https://github.com/agentscope-ai/agentscope.git
cd agentscope/examples/agent_service
# 启动智能体服务后端
python main.py
然后打开另一个终端启动 Web UI:
cd agentscope/examples/web_ui
# 启动 webui
pnpm install
pnpm dev
我们欢迎社区的贡献!请参阅我们的 贡献指南 了解如何贡献。
AgentScope 基于 Apache License 2.0 发布。
如果我们的工作对您的研究或应用有帮助,请引用我们的论文。
@article{agentscope_v1,
author = {Dawei Gao, Zitao Li, Yuexiang Xie, Weirui Kuang, Liuyi Yao, Bingchen Qian, Zhijian Ma, Yue Cui, Haohao Luo, Shen Li, Lu Yi, Yi Yu, Shiqi He, Zhiling Luo, Wenmeng Zhou, Zhicheng Zhang, Xuguang He, Ziqian Chen, Weikai Liao, Farruh Isakulovich Kushnazarov, Yaliang Li, Bolin Ding, Jingren Zhou}
title = {AgentScope 1.0: A Developer-Centric Framework for Building Agentic Applications},
journal = {CoRR},
volume = {abs/2508.16279},
year = {2025},
}
@article{agentscope,
author = {Dawei Gao, Zitao Li, Xuchen Pan, Weirui Kuang, Zhijian Ma, Bingchen Qian, Fei Wei, Wenhao Zhang, Yuexiang Xie, Daoyuan Chen, Liuyi Yao, Hongyi Peng, Zeyu Zhang, Lin Zhu, Chen Cheng, Hongzhu Shi, Yaliang Li, Bolin Ding, Jingren Zhou}
title = {AgentScope: A Flexible yet Robust Multi-Agent Platform},
journal = {CoRR},
volume = {abs/2402.14034},
year = {2024},
}
感谢所有贡献者:
<a href="https://github.com/agentscope-ai/agentscope/graphs/contributors"> </a>