Skip to content

Build and run agents you can see, understand and trust.

docs(readme): revamp README with SDK/service feature tables; bump to 2.0.6 (#2262)

DavdGaod08d605e8528
diff --git a/README.md b/README.md
index 4ac319cba..0d0bda538 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,12 @@
alt="license"
/>
</a>
+ <a href="https://deepwiki.com/agentscope-ai/agentscope">
+ <img
+ src="https://img.shields.io/badge/DeepWiki-Ask_Devin-navy.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)"
+ alt="Ask DeepWiki"
+ />
+ </a>
</p>
<p align="center">
@@ -57,13 +63,7 @@
## What is AgentScope 2.0?
-AgentScope 2.0 is a production-ready, easy-to-use agent framework with essential abstractions that work with rising model capability and built-in support for .
-
-- [**Event System** →](https://docs.agentscope.io/latest/en/building-blocks/message-and-event) A unified event bus to the frontend and human-in-the-loop support.
-- [**Permission System** →](https://docs.agentscope.io/latest/en/building-blocks/permission-system) Fine-grained, configurable control over tools and resources.
-- [**Multi-tenancy & Multi-session Service** →](https://docs.agentscope.io/latest/en/deploy/agent-service) Production-grade serving with isolation across tenants and sessions.
-- [**Workspace / Sandbox Support** →](https://docs.agentscope.io/latest/en/building-blocks/workspace) Run tools and code in isolated environments, with built-in backends for local, Docker, E2B, OpenSandbox, and Daytona.
-- [**Extensible Middleware System** →](https://docs.agentscope.io/latest/en/building-blocks/middleware) Composable hooks to customize and extend the agent's reasoning-acting loop.
+AgentScope 2.0 is a production-ready, easy-to-use agent framework with essential abstractions that keep up with rising model capability.
We design for increasingly agentic LLMs.
Our approach leverages the models' reasoning and tool use abilities
@@ -105,8 +105,6 @@ Welcome to join our community on
```bash
uv pip install agentscope
-# or
-# pip install agentscope
```
#### From source
@@ -119,11 +117,23 @@ git clone -b main https://github.com/agentscope-ai/agentscope.git
cd agentscope
uv pip install -e .
-# or
-# pip install -e .
```
-## Hello AgentScope!
+## Agent
+
+The SDK layer — compose an agent from a rich set of building blocks:
+
+| Building block | What's inside |
+|---|---|
+| [**ReAct**](https://docs.agentscope.io/latest/en/building-blocks/agent/overview) | Reasoning-acting loop with structured output, realtime interruption & resume, and batched (sequential / concurrent) tool acting |
+| [**Toolkit**](https://docs.agentscope.io/latest/en/building-blocks/tool/overview) | Agentic tool management over Python tools, MCP servers, and skills; ships with built-in coding tools (shell, file edit, search) and task/plan tools |
+| [**Model**](https://docs.agentscope.io/latest/en/building-blocks/model/overview) | LLM, embedding, and TTS across major providers (OpenAI, Anthropic, Gemini, DashScope, DeepSeek, Moonshot, xAI, Ollama) |
+| [**Context**](https://docs.agentscope.io/latest/en/building-blocks/context/overview) | Automatic compaction, tool-result offload, and context injection (system prompt, RAG, memory) via built-in middleware |
+| [**Event System**](https://docs.agentscope.io/latest/en/building-blocks/message-and-event) | Unified event bus streaming reasoning, tool calls, and multimodal content (text, image, audio) to the frontend |
+| [**Permission & HITL**](https://docs.agentscope.io/latest/en/building-blocks/permission-system/overview) | Fine-grained control over tools and resources, confirmation, bypass mode |
+| [**Middleware**](https://docs.agentscope.io/latest/en/building-blocks/middleware) | Composable hooks across the loop — reply, reasoning, acting, model calling, permission checking, context compression, system prompt |
+| [**Memory**](https://docs.agentscope.io/latest/en/building-blocks/long-term-memory) | Agentic memory with switchable backends (ReMe, Mem0) |
+| [**Workspace / Sandbox**](https://docs.agentscope.io/latest/en/building-blocks/workspace/overview) | Isolated tool & code execution — local, Docker, Apple Container, Bubblewrap, E2B, OpenSandbox, Daytona, K8s |
Start your first agent with AgentScope 2.0:
@@ -179,9 +189,22 @@ async def main() -> None:
asyncio.run(main())
```
-## Hello Agent Service!
+## Agent Service — All You Need to Build Your App
+
+AgentScope ships a batteries-included **agent service** — a FastAPI backend with a pre-built Web UI (`examples/web_ui`) that turns your agents into a multi-tenant, multi-session application, with rich capabilities out of the box:
+
+| Capability | What you get |
+|---|---|
+| [**Serving**](https://docs.agentscope.io/latest/en/deploy/agent-service) | Multi-tenancy, multi-session isolation, FastAPI backend, pre-built Web UI |
+| [**Agent Team**](https://docs.agentscope.io/latest/en/deploy/agent-team) | Leader–worker orchestration, built-in team tools, task planning |
+| [**Channels**](https://docs.agentscope.io/latest/en/deploy/channel/overview) | Connect agents to IM platforms — Feishu (Lark), Discord, custom channels, message routing |
+| [**RAG Service**](https://docs.agentscope.io/latest/en/deploy/rag) | Blob storage, index worker, multi-tenant retrieval |
+| [**MCP & Skill Hub**](https://docs.agentscope.io/latest/en/deploy/hub/overview) | Browse hubs (GitHub MCP Registry, ClawHub), install into your library, add to a workspace |
+| [**Resource Sharing**](https://docs.agentscope.io/latest/en/deploy/sharing) | Group- and org-level management for sharing models, MCP servers, skills, and workspaces |
+| [**Persistence**](https://docs.agentscope.io/latest/en/deploy/agent-service#storage-backend) | SQL & NoSQL persistence of agent state and sessions |
+| [**Scheduling**](https://docs.agentscope.io/latest/en/deploy/agent-service) | Scheduled tasks, agent wakeup, background task offloading |
-An extensible FastAPI based **multi-tenancy**, **multi-session** agent service with pre-built Web UI in `examples/web_ui`
+Everything above is composable, so you can assemble your own application on top of the service with minimal glue code.
<table>
<tr>
diff --git a/README_zh.md b/README_zh.md
index aefe3efe6..f15d9e58a 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -49,25 +49,24 @@
alt="license"
/>
</a>
+ <a href="https://deepwiki.com/agentscope-ai/agentscope">
+ <img
+ src="https://img.shields.io/badge/DeepWiki-Ask_Devin-navy.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)"
+ alt="Ask DeepWiki"
+ />
+ </a>
</p>
<p align="center">
<img src="https://trendshift.io/api/badge/repositories/20310" alt="agentscope-ai%2Fagentscope | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</p>
-## 什么是 AgentScope 2.0?
+## What's AgentScope 2.0?
AgentScope 2.0 是一款面向生产、易于使用的智能体框架,提供与不断进化的模型能力相匹配的核心抽象。
-- [**事件系统** →](https://docs.agentscope.io/latest/zh/building-blocks/message-and-event) 统一的事件总线,服务于前端智能体应用与 human-in-the-loop 协作。
-- [**权限系统** →](https://docs.agentscope.io/latest/zh/building-blocks/permission-system) 对工具和资源进行细粒度、可配置的控制。
-- [**多租户与多会话服务** →](https://docs.agentscope.io/latest/zh/deploy/agent-service) 提供生产级服务,在租户与会话之间实现隔离。
-- [**工作区 / 沙箱支持** →](https://docs.agentscope.io/latest/zh/building-blocks/workspace) 在隔离环境中运行工具和代码,内置支持本地文件系统、Docker、E2B、OpenSandbox 和 Daytona 后端。
-- [**可扩展中间件系统** →](https://docs.agentscope.io/latest/zh/building-blocks/middleware) 可组合的钩子系统,用于自定义和扩展智能体的推理-行动循环。
-
-我们为日益自主的大语言模型而设计。
-我们的方法是充分发挥模型的推理与工具调用能力,
-而不是用严格的提示词和固化的编排方式来束缚它们。
+AgentScope 的目标是充分发挥大模型的推理与工具调用能力,
+而非用严格的提示词和固化的编排方式来束缚它们。
<img src="assets/images/agentscope.png" alt="agentscope" width="100%"/>
@@ -95,22 +94,6 @@ AgentScope 2.0 是一款面向生产、易于使用的智能体框架,提供
|----------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| <img src="https://gw.alicdn.com/imgextra/i1/O1CN01hhD1mu1Dd3BWVUvxN_!!6000000000238-2-tps-400-400.png" width="100" height="100"> | <img src="./assets/images/dingtalk_qr_code.png" width="100" height="100"> |
-<!-- START doctoc generated TOC please keep comment here to allow auto update -->
-<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
-## 📑 Table of Contents
-
-- [快速开始](#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B)
- - [安装](#%E5%AE%89%E8%A3%85)
- - [从 PyPI 安装](#%E4%BB%8E-pypi-%E5%AE%89%E8%A3%85)
- - [从源码安装](#%E4%BB%8E%E6%BA%90%E7%A0%81%E5%AE%89%E8%A3%85)
-- [Hello AgentScope!](#hello-agentscope)
-- [智能体服务](#%E6%99%BA%E8%83%BD%E4%BD%93%E6%9C%8D%E5%8A%A1)
-- [贡献](#%E8%B4%A1%E7%8C%AE)
-- [许可](#%E8%AE%B8%E5%8F%AF)
-- [论文](#%E8%AE%BA%E6%96%87)
-- [贡献者](#%E8%B4%A1%E7%8C%AE%E8%80%85)
-
-<!-- END doctoc generated TOC please keep comment here to allow auto update -->
## 快速开始
@@ -122,8 +105,6 @@ AgentScope 2.0 是一款面向生产、易于使用的智能体框架,提供
```bash
uv pip install agentscope
-# 或者
-# pip install agentscope
```
#### 从源码安装
@@ -136,11 +117,23 @@ git clone -b main https://github.com/agentscope-ai/agentscope.git
cd agentscope
uv pip install -e .
-# 或者
-# pip install -e .
```
-## Hello AgentScope!
+## 智能体(Agent)
+
+SDK 层 —— 用一整套丰富的构建模块组合出你的智能体:
+
+| 构建模块 | 包含内容 |
+|---|---|
+| [**ReAct**](https://docs.agentscope.io/latest/zh/building-blocks/agent/overview) | 推理-行动循环,支持结构化输出、实时中断与恢复、以及批量(顺序 / 并发)工具执行 |
+| [**工具集**](https://docs.agentscope.io/latest/zh/building-blocks/tool/overview) | 智能体自主工具管理(囊括 Python 工具、MCP 与 Skill);内置编码工具(Shell、文件编辑、搜索)与任务/规划工具开箱即用 |
+| [**模型**](https://docs.agentscope.io/latest/zh/building-blocks/model/overview) | LLM、Embedding、TTS,覆盖主流厂商(OpenAI、Anthropic、Gemini、DashScope、DeepSeek、Moonshot、xAI、Ollama) |
+| [**上下文**](https://docs.agentscope.io/latest/zh/building-blocks/context/overview) | 自动压缩、工具结果卸载、以及上下文注入(系统提示、RAG、记忆),均由内置中间件实现 |
+| [**事件系统**](https://docs.agentscope.io/latest/zh/building-blocks/message-and-event) | 统一事件总线,将推理、工具调用与多模态内容(文本、图像、音频)流式推送到前端 |
+| [**权限与 HITL**](https://docs.agentscope.io/latest/zh/building-blocks/permission-system/overview) | 对工具和资源的细粒度控制、确认、bypass 模式 |
+| [**中间件**](https://docs.agentscope.io/latest/zh/building-blocks/middleware) | 贯穿整个循环的可组合钩子 —— 回复、推理、行动、模型调用、权限检查、上下文压缩、系统提示 |
+| [**记忆**](https://docs.agentscope.io/latest/zh/building-blocks/long-term-memory) | Agentic Memory,可切换后端(ReMe、Mem0) |
+| [**工作空间 / 沙箱**](https://docs.agentscope.io/latest/zh/building-blocks/workspace/overview) | 隔离工具与代码执行 —— local、Docker、Apple Container、Bubblewrap、E2B、OpenSandbox、Daytona、K8s |
使用 AgentScope 2.0,启动你的第一个智能体:
@@ -196,9 +189,22 @@ async def main() -> None:
asyncio.run(main())
```
-## 智能体服务
+## 智能体服务 —— 构建应用所需的一切
+
+AgentScope 提供开箱即用的**智能体服务** —— 一个基于 FastAPI 的后端,并在 `examples/web_ui` 中附带预构建的 Web UI,将你的智能体变成一个多租户、多会话的应用,并自带一整套丰富的能力:
+
+| 能力 | 包含内容 |
+|---|---|
+| [**服务**](https://docs.agentscope.io/latest/zh/deploy/agent-service) | 多租户、多会话隔离、FastAPI 后端、预构建 Web UI |
+| [**智能体团队**](https://docs.agentscope.io/latest/zh/deploy/agent-team) | Leader–Worker 编排、内置团队工具、任务规划 |
+| [**消息渠道**](https://docs.agentscope.io/latest/zh/deploy/channel/overview) | 将智能体接入 IM 平台 —— 飞书(Lark)、Discord、自定义渠道、消息路由 |
+| [**RAG 服务**](https://docs.agentscope.io/latest/zh/deploy/rag) | Blob 存储、索引 Worker、多租户检索 |
+| [**MCP & 技能 Hub**](https://docs.agentscope.io/latest/zh/deploy/hub/overview) | 浏览 Hub(GitHub MCP Registry、ClawHub)、安装到你的库、添加到工作空间 |
+| [**资源共享**](https://docs.agentscope.io/latest/zh/deploy/sharing) | 面向 group 与 org 的资源管理,共享模型、MCP 服务、技能与工作空间 |
+| [**持久化**](https://docs.agentscope.io/latest/zh/deploy/agent-service#storage-backend) | 智能体状态与会话的 SQL & NoSQL 持久化 |
+| [**调度**](https://docs.agentscope.io/latest/zh/deploy/agent-service) | 定时任务、智能体唤醒、后台任务卸载 |
-一个基于 FastAPI 的可扩展**多租户**、**多会话**智能体服务,并在 `examples/web_ui` 中提供预构建的 Web UI
+以上能力皆可组合,你只需少量胶水代码,就能在此服务之上搭建起自己的应用。
<table>
<tr>
diff --git a/assets/images/agentscope.png b/assets/images/agentscope.png
index 0c02c6487..699b75683 100644
Binary files a/assets/images/agentscope.png and b/assets/images/agentscope.png differ
diff --git a/src/agentscope/_version.py b/src/agentscope/_version.py
index cc3b8b042..cd26e6b60 100644
--- a/src/agentscope/_version.py
+++ b/src/agentscope/_version.py
@@ -1,4 +1,4 @@
# -*- coding: utf-8 -*-
"""The version of agentscope."""
-__version__ = "2.0.6dev"
+__version__ = "2.0.6"