Skip to content

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

docs: update the documentations in the AgentScope repo (#1128)

DavdGaocdf327a2a14b
diff --git a/.github/scripts/update_news.py b/.github/scripts/update_news.py
new file mode 100755
index 000000000..9dccc0ed3
--- /dev/null
+++ b/.github/scripts/update_news.py
@@ -0,0 +1,152 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Script to automatically update NEWS section in README files.
+Reads the first 10 news items from docs/NEWS.md and updates README.md and
+README_zh.md.
+"""
+
+from pathlib import Path
+
+
+def read_news_items(news_file: Path, max_items: int = 10) -> list[str]:
+ """
+ Read news items from NEWS.md file.
+
+ Args:
+ news_file (`Path`):
+ Path to the NEWS.md file
+ max_items (`int`, optional):
+ Maximum number of items to read
+
+ Returns:
+ `list[str]`:
+ List of news items
+ """
+ with open(news_file, "r", encoding="utf-8") as f:
+ content = f.read()
+
+ # Split by lines that start with "- **["
+ lines = content.strip().split("\n")
+ news_items = []
+
+ for line in lines:
+ if line.strip().startswith("- **["):
+ news_items.append(line)
+ if len(news_items) >= max_items:
+ break
+
+ return news_items
+
+
+def update_readme(
+ readme_file: Path,
+ news_items: list[str],
+) -> None:
+ """
+ Update the NEWS section in README file using HTML comment markers.
+
+ Args:
+ readme_file (`Path`):
+ Path to the README file
+ news_items (`list[str]`):
+ List of news items to insert
+ """
+ with open(readme_file, "r", encoding="utf-8") as f:
+ content = f.read()
+
+ # Use HTML comment markers to identify the NEWS section
+ begin_marker = "<!-- BEGIN NEWS -->"
+ end_marker = "<!-- END NEWS -->"
+
+ if begin_marker not in content or end_marker not in content:
+ print(f"⚠️ NEWS markers not found in {readme_file.name}")
+ print(
+ f" Please add '{begin_marker}' and '{end_marker}' to mark the "
+ f"NEWS section",
+ )
+ return
+
+ # Find positions of markers
+ begin_pos = content.find(begin_marker)
+ end_pos = content.find(end_marker)
+
+ if begin_pos == -1 or end_pos == -1 or begin_pos >= end_pos:
+ print(f"❌ Invalid NEWS markers in {readme_file.name}")
+ return
+
+ # Create new NEWS content
+ news_content = "\n".join(news_items)
+
+ # Replace content between markers
+ new_content = (
+ content[: begin_pos + len(begin_marker)]
+ + "\n"
+ + news_content
+ + "\n"
+ + content[end_pos:]
+ )
+
+ with open(readme_file, "w", encoding="utf-8") as f:
+ f.write(new_content)
+
+ print(f"✅ Updated {readme_file.name}")
+
+
+def main() -> None:
+ """Main function to update NEWS in README files."""
+ # Define paths
+ repo_root = Path(__file__).parent.parent.parent
+ news_file_en = repo_root / "docs" / "NEWS.md"
+ news_file_zh = repo_root / "docs" / "NEWS_zh.md"
+ readme_en = repo_root / "README.md"
+ readme_zh = repo_root / "README_zh.md"
+
+ # Update English README from NEWS.md
+ if news_file_en.exists():
+ print(f"📖 Reading news items from {news_file_en}")
+ news_items_en = read_news_items(news_file_en, max_items=10)
+ print(f"📰 Found {len(news_items_en)} English news items")
+
+ if news_items_en and readme_en.exists():
+ print(f"📝 Updating {readme_en.name}...")
+ update_readme(readme_en, news_items_en)
+ elif not news_items_en:
+ print("⚠️ No English news items found")
+ else:
+ print(f"⚠️ {readme_en} not found")
+ else:
+ print(f"❌ NEWS.md not found at {news_file_en}")
+
+ # Update Chinese README from NEWS_zh.md
+ if news_file_zh.exists() and news_file_zh.stat().st_size > 0:
+ print(f"📖 Reading news items from {news_file_zh}")
+ news_items_zh = read_news_items(news_file_zh, max_items=10)
+ print(f"📰 Found {len(news_items_zh)} Chinese news items")
+
+ if news_items_zh and readme_zh.exists():
+ print(f"📝 Updating {readme_zh.name}...")
+ update_readme(readme_zh, news_items_zh)
+ elif not news_items_zh:
+ print("⚠️ No Chinese news items found")
+ else:
+ print(f"⚠️ {readme_zh} not found")
+ else:
+ print(
+ f"⚠️ NEWS_zh.md not found or empty at {news_file_zh}, "
+ f"using English news for Chinese README",
+ )
+ # Fallback: use English news for Chinese README if NEWS_zh.md
+ # doesn't exist
+ if news_file_en.exists() and readme_zh.exists():
+ print(f"📖 Reading news items from {news_file_en} (fallback)")
+ news_items = read_news_items(news_file_en, max_items=10)
+ if news_items:
+ print(f"📝 Updating {readme_zh.name} with English news...")
+ update_readme(readme_zh, news_items)
+
+ print("✨ All done!")
+
+
+if __name__ == "__main__":
+ main()
diff --git a/.github/workflows/toc.yml b/.github/workflows/toc.yml
index 66764c476..a695ebe13 100644
--- a/.github/workflows/toc.yml
+++ b/.github/workflows/toc.yml
@@ -7,6 +7,11 @@ on:
branches-ignore:
- 'main'
+# Prevent concurrent runs that modify README files
+concurrency:
+ group: readme-updates-${{ github.ref }}
+ cancel-in-progress: false
+
jobs:
generateTOC:
name: TOC Generator
diff --git a/.github/workflows/update_news.yml b/.github/workflows/update_news.yml
new file mode 100644
index 000000000..4f609b44e
--- /dev/null
+++ b/.github/workflows/update_news.yml
@@ -0,0 +1,39 @@
+name: Update NEWS in README
+on:
+ push:
+ paths:
+ - 'docs/NEWS.md'
+ - 'docs/NEWS_zh.md'
+ branches-ignore:
+ - 'main'
+
+# Prevent concurrent runs that modify README files
+concurrency:
+ group: readme-updates-${{ github.ref }}
+ cancel-in-progress: false
+
+jobs:
+ updateNews:
+ name: NEWS Updater
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v6
+ with:
+ fetch-depth: 0
+
+ - name: Set up Python
+ uses: actions/setup-python@v6
+ with:
+ python-version: '3.10'
+
+ - name: Update NEWS in README files
+ run: python .github/scripts/update_news.py
+
+ - name: Commit changes
+ run: |
+ git config --local user.email "github-actions[bot]@users.noreply.github.com"
+ git config --local user.name "github-actions[bot]"
+ git add README.md README_zh.md
+ git diff --staged --quiet || git commit -m "docs: auto-sync NEWS section to README files"
+ git push
+
diff --git a/README.md b/README.md
index c131bba03..5bafdb90a 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,3 @@
-[**中文主页**](https://github.com/agentscope-ai/agentscope/blob/main/README_zh.md) | [**Tutorial**](https://doc.agentscope.io/) | [**Roadmap**](https://github.com/agentscope-ai/agentscope/blob/main/docs/roadmap.md) | [**FAQ**](https://doc.agentscope.io/tutorial/faq.html)
-
<p align="center">
<img
src="https://img.alicdn.com/imgextra/i1/O1CN01nTg6w21NqT5qFKH1u_!!6000000001621-55-tps-550-550.svg"
@@ -8,7 +6,11 @@
/>
</p>
-<h2 align="center">AgentScope: Agent-Oriented Programming for Building LLM Applications</h2>
+<span align="center">
+
+[**中文主页**](https://github.com/agentscope-ai/agentscope/blob/main/README_zh.md) | [**Tutorial**](https://doc.agentscope.io/) | [**Roadmap (Jan 2026 -)**](https://github.com/agentscope-ai/agentscope/blob/main/docs/roadmap.md) | [**FAQ**](https://doc.agentscope.io/tutorial/faq.html)
+
+</span>
<p align="center">
<a href="https://arxiv.org/abs/2402.14034">
@@ -29,16 +31,16 @@
alt="pypi"
/>
</a>
- <a href="https://doc.agentscope.io/">
+ <a href="https://discord.gg/eYMpfnkG8h">
<img
- src="https://img.shields.io/badge/Docs-English%7C%E4%B8%AD%E6%96%87-blue?logo=markdown"
- alt="docs"
+ src="https://img.shields.io/discord/1194846673529213039?label=Discord&logo=discord"
+ alt="discord"
/>
</a>
- <a href="https://agentscope.io/">
+ <a href="https://doc.agentscope.io/">
<img
- src="https://img.shields.io/badge/GUI-AgentScope_Studio-blue?logo=look&logoColor=green&color=dark-green"
- alt="workstation"
+ src="https://img.shields.io/badge/Docs-English%7C%E4%B8%AD%E6%96%87-blue?logo=markdown"
+ alt="docs"
/>
</a>
<a href="./LICENSE">
@@ -53,80 +55,45 @@
<img src="https://trendshift.io/api/badge/repositories/10079" alt="modelscope%2Fagentscope | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</p>
-## 📢 News
-- **[2026-01]** Hi community, we are launching AgentScope Biweekly Meetings to share ecosystem updates and development plans - join us! [Details & Schedule](https://github.com/agentscope-ai/agentscope/discussions/1126)
-- **[2026-01]** AgentScope integrates [database support](https://doc.agentscope.io/tutorial/task_memory.html) in the memory module now, as well as the [memory compression](https://doc.agentscope.io/tutorial/task_agent.html) feature. Check our [example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression) and [tutorial](https://doc.agentscope.io/tutorial/task_memory.html) for more details.
-- **[2025-12]** AgentScope supports [A2A(Agent-to-Agent) protocol](https://doc.agentscope.io/tutorial/task_a2a.html) now! Check our [example](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent) and [tutorial](https://doc.agentscope.io/tutorial/task_a2a.html) for more details.
-- **[2025-12]** AgentScope supports [TTS(Text-to-Speech)](https://doc.agentscope.io/tutorial/task_tts.html) now! Check our [example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts) and [tutorial](https://doc.agentscope.io/tutorial/task_tts.html) for more details.
-- **[2025-11]** AgentScope supports [Anthropic Agent Skill](https://claude.com/blog/skills) now! Check our [example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill) and [tutorial](https://doc.agentscope.io/tutorial/task_agent_skill.html) for more details.
-- **[2025-11]** AgentScope open-sources [Alias-Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/alias) for diverse real-world tasks and [Data-Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/data_juicer_agent) for data processing.
-- **[2025-11]** AgentScope supports [Agentic RL](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent) via integrating [Trinity-RFT](https://github.com/agentscope-ai/Trinity-RFT) library.
-- **[2025-11]** AgentScope integrates [ReMe](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory/reme) for enhanced long-term memory.
-- **[2025-11]** AgentScope launches [agentscope-samples](https://github.com/agentscope-ai/agentscope-samples) repository and upgrades [agentscope-runtime](https://github.com/agentscope-ai/agentscope-runtime) with Docker/K8s deployment and VNC-powered GUI sandboxes.
-- **[2025-11]** [Contributing Guide](./CONTRIBUTING.md) is online now! Welcome to contribute to AgentScope.
-- **[2025-09]** **RAG** module in AgentScope 1.0 is online now! Check our [tutorial](https://doc.agentscope.io/tutorial/task_rag.html) and [example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag) for more details.
-- **[2025-09]** **Voice agent** is online! `ReActAgent` supports Qwen-Omni and GPT-Audio natively now, check our [new example](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent) and [roadmap](https://github.com/agentscope-ai/agentscope/issues/773).
-- **[2025-09]** A new powerful 📋**Plan** module is online now! Check out the [tutorial](https://doc.agentscope.io/tutorial/task_plan.html) for more details.
-- **[2025-09]** **AgentScope Runtime** is open-sourced now! Enabling effective agent deployment with sandboxed tool execution for production-ready AI applications. Check out the [GitHub repo](https://github.com/agentscope-ai/agentscope-runtime).
-- **[2025-09]** **AgentScope Studio** is open-sourced now! Check out the [GitHub repo](https://github.com/agentscope-ai/agentscope-studio).
-- **[2025-08]** The new tutorial of v1 is online now! Check out the [tutorial](https://doc.agentscope.io) for more details.
-- **[2025-08]** 🎉🎉 AgentScope v1 is released now! This version fully embraces the asynchronous execution, providing many new features and improvements. Check out [changelog](https://github.com/agentscope-ai/agentscope/blob/main/docs/changelog.md) for detailed changes.
-
-
-## ✨ Why AgentScope?
-
-Easy for beginners, powerful for experts.
+## What is AgentScope?
+
+AgentScope is a production-ready, easy-to-use agent framework with essential abstractions that work with rising model capability and built-in support for finetuning.
+
+We design for increasingly agentic LLMs.
+Our approach leverages the models' reasoning and tool use abilities
+rather than constraining them with strict prompts and opinionated orchestrations.
+
+## Why use AgentScope?
+
+- **Simple**: start building your agents in 5 minutes with built-in ReAct agent, tools, skills, human-in-the-loop steering, memory, planning, realtime voice, evaluation and model finetuning
+- **Extensible**: large number of ecosystem integrations for tools, memory and observability; built-in support for MCP and A2A; message hub for flexible multi-agent orchestration and workflows
+- **Production-ready**: deploy and serve your agents locally, as serverless in the cloud, or on your K8s cluster with built-in OTel support
+
<p align="center">
-<img src="./assets/images/agentscope_v1_0822.png" alt="AgentScope Framework" width="80%"/>
+<img src="./assets/images/agentscope_20260120.png" width="90%" />
+<br/>
+The AgentScope Ecosystem
</p>
-- **Transparent to Developers**: Transparent is our **FIRST principle**. Prompt engineering, API invocation, agent building, workflow orchestration, all are visible and controllable for developers. No deep encapsulation or implicit magic.
-- **[Realtime Steering](https://doc.agentscope.io/tutorial/task_agent.html#realtime-steering)**: Native support for realtime interruption and customized handling.
-- **More Agentic**: Support [agentic tools management](https://doc.agentscope.io/tutorial/task_tool.html), [agentic long-term memory control](https://doc.agentscope.io/tutorial/task_long_term_memory.html) and agentic RAG, etc.
-- **Model Agnostic**: Programming once, run with all models.
-- **LEGO-style Agent Building**: All components are **modular** and **independent**.
-- **Multi-Agent Oriented**: Designed for **multi-agent**, **explicit** message passing and workflow orchestration, NO deep encapsulation.
-- **Highly Customizable**: Tools, prompt, agent, workflow, third-party libs & visualization, customization is encouraged everywhere.
-
-Quick overview of important features in **AgentScope 1.0**:
-
-| Module | Feature | Tutorial |
-|------------|----------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|
-| model | Support async invocation | [Model](https://doc.agentscope.io/tutorial/task_model.html) |
-| | Support reasoning model | |
-| | Support streaming/non-streaming returns | |
-| tool | Support async/sync tool functions | [Tool](https://doc.agentscope.io/tutorial/task_tool.html) |
-| | Support streaming/non-streaming returns | |
-| | Support user interruption | |
-| | Support post-processing | |
-| | Support group-wise tools management | |
-| | Support agentic tools management by meta tool | |
-| MCP | Support streamable HTTP/SSE/StdIO transport | [MCP](https://doc.agentscope.io/tutorial/task_mcp.html) |
-| | Support both **stateful** and **stateless** mode MCP Client | |
-| | Support client- & function-level fine-grained control | |
-| agent | Support async execution | |
-| | Support parallel tool calls | |
-| | Support realtime steering interruption and customized handling | |
-| | Support automatic state management | |
-| | Support agent-controlled long-term memory | |
-| | Support agent hooks | |
-| tracing | Support OpenTelemetry-based tracing in LLM, tools, agent and formatter | [Tracing](https://doc.agentscope.io/tutorial/task_tracing.html) |
-| | Support connecting to third-party tracing platforms (e.g. Alibaba Cloud CloudMonitor, Arize-Phoenix, Langfuse) | |
-| memory | Support long-term memory | [Memory](https://doc.agentscope.io/tutorial/task_long_term_memory.html) |
-| session | Provide session/application-level automatic state management | [Session](https://doc.agentscope.io/tutorial/task_state.html) |
-| evaluation | Provide distributed and parallel evaluation | [Evaluation](https://doc.agentscope.io/tutorial/task_eval.html) |
-| formatter | Support multi-agent prompt formatting with tools API | [Prompt Formatter](https://doc.agentscope.io/tutorial/task_prompt.html) |
-| | Support truncation-based formatter strategy | |
-| plan | Support ReAct-based long-term planning | [Plan](https://doc.agentscope.io/tutorial/task_plan.html) |
-| | Support manual plan specification | |
-| RAG | Support agentic RAG | [RAG](https://doc.agentscope.io/tutorial/task_rag.html) |
-| | Support multimodal RAG | |
-| A2A | Support A2A agent | [A2A](https://doc.agentscope.io/tutorial/task_a2a.html) |
-| ... | | |
-
-
-## 💬 Contact
+
+## News
+<!-- BEGIN NEWS -->
+- **[2026-01] `COMM`:** Biweekly Meetings launched to share ecosystem updates and development plans - join us! [Details & Schedule](https://github.com/agentscope-ai/agentscope/discussions/1126)
+- **[2026-01] `FEAT`:** Database support & memory compression in memory module. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression) | [Tutorial](https://doc.agentscope.io/tutorial/task_memory.html)
+- **[2025-12] `INTG`:** A2A (Agent-to-Agent) protocol support. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent) | [Tutorial](https://doc.agentscope.io/tutorial/task_a2a.html)
+- **[2025-12] `FEAT`:** TTS (Text-to-Speech) support. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts) | [Tutorial](https://doc.agentscope.io/tutorial/task_tts.html)
+- **[2025-11] `INTG`:** Anthropic Agent Skill support. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill) | [Tutorial](https://doc.agentscope.io/tutorial/task_agent_skill.html)
+- **[2025-11] `RELS`:** Alias-Agent for diverse real-world tasks and Data-Juicer Agent for data processing open-sourced. [Alias-Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/alias) | [Data-Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/data_juicer_agent)
+- **[2025-11] `INTG`:** Agentic RL via Trinity-RFT library. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent) | [Trinity-RFT](https://github.com/agentscope-ai/Trinity-RFT)
+- **[2025-11] `INTG`:** ReMe for enhanced long-term memory. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory/reme)
+- **[2025-11] `RELS`:** agentscope-samples repository launched and agentscope-runtime upgraded with Docker/K8s deployment and VNC-powered GUI sandboxes. [Samples](https://github.com/agentscope-ai/agentscope-samples) | [Runtime](https://github.com/agentscope-ai/agentscope-runtime)
+- **[2025-11] `DOCS`:** Contributing Guide is online - welcome to contribute! [Guide](./CONTRIBUTING.md)
+<!-- END NEWS -->
+
+[More news →](./docs/NEWS.md)
+
+## Community
Welcome to join our community on
@@ -138,70 +105,67 @@ Welcome to join our community on
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
## 📑 Table of Contents
-- [🚀 Quickstart](#-quickstart)
- - [💻 Installation](#-installation)
- - [🛠️ From source](#-from-source)
- - [🔄 Using uv (recommended for faster installs)](#-using-uv-recommended-for-faster-installs)
- - [📦 From PyPi](#-from-pypi)
-- [📝 Example](#-example)
- - [👋 Hello AgentScope!](#-hello-agentscope)
- - [🎯 Realtime Steering](#-realtime-steering)
- - [🛠️ Fine-Grained MCP Control](#-fine-grained-mcp-control)
- - [🧑‍🤝‍🧑 Multi-Agent Conversation](#-multi-agent-conversation)
- - [💻 AgentScope Studio](#-agentscope-studio)
-- [📖 Documentation](#-documentation)
-- [🤝 Contributing](#-contributing)
-- [⚖️ License](#-license)
-- [📚 Publications](#-publications)
-- [✨ Contributors](#-contributors)
+- [Quickstart](#quickstart)
+ - [Installation](#installation)
+ - [Using uv (recommended for faster installs)](#using-uv-recommended-for-faster-installs)
+ - [From PyPi](#from-pypi)
+- [Example](#example)
+ - [Hello AgentScope!](#hello-agentscope)
+ - [Voice Agent](#voice-agent)
+ - [Realtime Interruption](#realtime-interruption)
+ - [Fine-Grained MCP Control](#fine-grained-mcp-control)
+ - [Multi-Agent Conversation](#multi-agent-conversation)
+- [Documentation](#documentation)
+- [More Examples & Samples](#more-examples--samples)
+ - [Functionality](#functionality)
+ - [Agent](#agent)
+ - [Game](#game)
+ - [Workflow](#workflow)
+ - [Evaluation](#evaluation)
+ - [Training](#training)
+- [Contributing](#contributing)
+- [License](#license)
+- [Publications](#publications)
+- [Contributors](#contributors)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
-## 🚀 Quickstart
+## Quickstart
-### 💻 Installation
+### Installation
> AgentScope requires **Python 3.10** or higher.
-#### 🛠️ From source
+#### From PyPI
```bash
-# Pull the source code from GitHub
-git clone -b main https://github.com/agentscope-ai/agentscope.git
-
-# Install the package in editable mode
-cd agentscope
-pip install -e .
+pip install agentscope
```
-#### 🔄 Using uv (recommended for faster installs)
-
-[uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver, written in Rust.
+Or with uv:
```bash
-# Clone the repository
-git clone -b main https://github.com/agentscope-ai/agentscope.git
-cd agentscope
-
-# Install with uv
-uv pip install -e .
+uv pip install agentscope
```
-#### 📦 From PyPi
+#### From source
```bash
-pip install agentscope
-```
+# Pull the source code from GitHub
+git clone -b main https://github.com/agentscope-ai/agentscope.git
-Or with uv:
+# Install the package in editable mode
+cd agentscope
-```bash
-uv pip install agentscope
+pip install -e .
+# or with uv:
+# uv pip install -e .
```
-## 📝 Example
-### 👋 Hello AgentScope!
+## Example
+
+### Hello AgentScope!
Start with a conversation between user and a ReAct agent 🤖 named "Friday"!
@@ -244,18 +208,24 @@ async def main():
asyncio.run(main())
```
-### 🎯 Realtime Steering
+### Voice Agent
-Natively support **realtime interruption** in ``ReActAgent`` with robust memory preservation, and convert interruption into an **observable event** for agent to seamlessly resume conversations.
+Create a voice-enabled ReAct agent that can understand and respond with speech, even playing a multi-agent werewolf game with voice interactions.
-<p align="center">
- <img src="./assets/images/realtime_steering_zh.gif" alt="Realtime Steering" width="49%"/>
- <img src="./assets/images/realtime_steering_en.gif" alt="Realtime Steering" width="49%"/>
-</p>
-### 🛠️ Fine-Grained MCP Control
+https://github.com/user-attachments/assets/c5f05254-aff6-4375-90df-85e8da95d5da
+
+
+### Human-in-the-loop
+
+Support realtime interruption in ReActAgent: conversation can be interrupted via cancellation in realtime and resumed
+seamlessly via robust memory preservation.
-Developers can obtain the MCP tool as a **local callable function**, and use it anywhere (e.g. call directly, pass to agent, wrap into a more complex tool, etc.)
+<img src="./assets/images/realtime_steering_en.gif" alt="Realtime Steering" width="60%"/>
+
+### Flexible MCP Usage
+
+Use individual MCP tools as **local callable functions** to compose toolkits or wrap into a more complex tool.
```python
from agentscope.mcp import HttpStatelessClient
@@ -285,7 +255,20 @@ async def fine_grained_mcp_control():
# ...
```
-### 🧑‍🤝‍🧑 Multi-Agent Conversation
+### Agentic RL
+
+Train your agentic application seamlessly with Reinforcement Learning integration. We also prepare multiple sample projects covering various scenarios:
+
+| Example | Description | Model | Training Result |
+|--------------------------------------------------------------------------------------------------|-------------------------------------------------------------|------------------------|-----------------------------|
+| [Math Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/math_agent) | Tune a math-solving agent with multi-step reasoning. | Qwen3-0.6B | Accuracy: 75% → 85% |
+| [Frozen Lake](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/frozen_lake) | Train an agent to navigate the Frozen Lake environment. | Qwen2.5-3B-Instruct | Success rate: 15% → 86% |
+| [Learn to Ask](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/learn_to_ask) | Tune agents using LLM-as-a-judge for automated feedback. | Qwen2.5-7B-Instruct | Accuracy: 47% → 92% |
+| [Email Search](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/email_search) | Improve tool-use capabilities without labeled ground truth. | Qwen3-4B-Instruct-2507 | Accuracy: 60% |
+| [Werewolf Game](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/werewolves) | Train agents for strategic multi-agent game interactions. | Qwen2.5-7B-Instruct | Werewolf win rate: 50% → 80% |
+| [Data Augment](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/data_augment) | Generate synthetic training data to enhance tuning results. | Qwen3-0.6B | AIME-24 accuracy: 20% → 60% |
+
+### Multi-Agent Workflows
AgentScope provides ``MsgHub`` and pipelines to streamline multi-agent conversations, offering efficient message routing and seamless information sharing
@@ -316,116 +299,67 @@ async def multi_agent_conversation():
asyncio.run(multi_agent_conversation())
```
-### 💻 AgentScope Studio
-Use the following command to install and start AgentScope Studio, to trace and visualize your agent application.
+## Documentation
-```bash
-npm install -g @agentscope/studio
+- [Tutorial](https://doc.agentscope.io/tutorial/)
+- [FAQ](https://doc.agentscope.io/tutorial/faq.html)
+- [API Docs](https://doc.agentscope.io/api/agentscope.html)
-as_studio
-```
+## More Examples & Samples
-<p align="center">
- <img
- src="https://img.alicdn.com/imgextra/i1/O1CN01PG2MdF1Zc44A1QM6N_!!6000000003214-1-tps-1971-1080.gif"
- width="49%"
- alt="home"
- />
- <img
- src="https://img.alicdn.com/imgextra/i2/O1CN01pGHedL1L4ibmyPeiq_!!6000000001246-1-tps-1971-1080.gif"
- width="49%"
- alt="runtime"
- />
- <img
- src="https://img.alicdn.com/imgextra/i1/O1CN01HfFhy928SSJAcWQ8c_!!6000000007931-1-tps-1971-1080.gif"
- width="49%"
- alt="traces"
- />
- <img
- src="https://img.alicdn.com/imgextra/i1/O1CN01vovov821Arms9tEJ1_!!6000000006945-1-tps-1971-1080.gif"
- width="49%"
- alt="friday"
- />
-</p>
+### Functionality
+
+- [MCP](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/mcp)
+- [Anthropic Agent Skill](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill)
+- [Plan](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/plan)
+- [Structured Output](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/structured_output)
+- [RAG](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag)
+- [Long-Term Memory](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory)
+- [Session with SQLite](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/session_with_sqlite)
+- [Stream Printing Messages](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/stream_printing_messages)
+- [TTS](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts)
+- [Code-first Deployment](https://github.com/agentscope-ai/agentscope/tree/main/examples/deployment/planning_agent)
+- [Memory Compression](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression)
+
+### Agent
+
+- [ReAct Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/react_agent)
+- [Voice Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent)
+- [Deep Research Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/deep_research_agent)
+- [Browser-use Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/browser_agent)
+- [Meta Planner Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/meta_planner_agent)
+- [A2A Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent)
+
+### Game
+
+- [Nine-player Werewolves](https://github.com/agentscope-ai/agentscope/tree/main/examples/game/werewolves)
+
+### Workflow
+
+- [Multi-agent Debate](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_debate)
+- [Multi-agent Conversation](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_conversation)
+- [Multi-agent Concurrent](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_concurrent)
+
+### Evaluation
+
+- [ACEBench](https://github.com/agentscope-ai/agentscope/tree/main/examples/evaluation/ace_bench)
+
+### Tuner
+
+- [Tune ReAct Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent)
-## 📖 Documentation
-
-- Tutorial
- - [Installation](https://doc.agentscope.io/tutorial/quickstart_installation.html)
- - [Key Concepts](https://doc.agentscope.io/tutorial/quickstart_key_concept.html)
- - [Create Message](https://doc.agentscope.io/tutorial/quickstart_message.html)
- - [ReAct Agent](https://doc.agentscope.io/tutorial/quickstart_agent.html)
-- Workflow
- - [Conversation](https://doc.agentscope.io/tutorial/workflow_conversation.html)
- - [Multi-Agent Debate](https://doc.agentscope.io/tutorial/workflow_multiagent_debate.html)
- - [Concurrent Agents](https://doc.agentscope.io/tutorial/workflow_concurrent_agents.html)
- - [Routing](https://doc.agentscope.io/tutorial/workflow_routing.html)
- - [Handoffs](https://doc.agentscope.io/tutorial/workflow_handoffs.html)
-- FAQ
- - [FAQ](https://doc.agentscope.io/tutorial/faq.html)
-- Task Guides
- - [Model](https://doc.agentscope.io/tutorial/task_model.html)
- - [Prompt Formatter](https://doc.agentscope.io/tutorial/task_prompt.html)
- - [Tool](https://doc.agentscope.io/tutorial/task_tool.html)
- - [Memory](https://doc.agentscope.io/tutorial/task_memory.html)
- - [Long-Term Memory](https://doc.agentscope.io/tutorial/task_long_term_memory.html)
- - [Agent](https://doc.agentscope.io/tutorial/task_agent.html)
- - [Pipeline](https://doc.agentscope.io/tutorial/task_pipeline.html)
- - [Plan](https://doc.agentscope.io/tutorial/task_plan.html)
- - [State/Session Management](https://doc.agentscope.io/tutorial/task_state.html)
- - [Agent Hooks](https://doc.agentscope.io/tutorial/task_hook.html)
- - [MCP](https://doc.agentscope.io/tutorial/task_mcp.html)
- - [AgentScope Studio](https://doc.agentscope.io/tutorial/task_studio.html)
- - [Tracing](https://doc.agentscope.io/tutorial/task_tracing.html)
- - [Evaluation](https://doc.agentscope.io/tutorial/task_eval.html)
- - [Embedding](https://doc.agentscope.io/tutorial/task_embedding.html)
- - [Token](https://doc.agentscope.io/tutorial/task_token.html)
-- API
- - [API Docs](https://doc.agentscope.io/api/agentscope.html)
-- [Examples](https://github.com/agentscope-ai/agentscope/tree/main/examples)
- - Functionality
- - [MCP](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/mcp)
- - [Anthropic Agent Skill](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill)
- - [Plan](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/plan)
- - [Structured Output](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/structured_output)
- - [RAG](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag)
- - [Long-Term Memory](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory)
- - [Session with SQLite](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/session_with_sqlite)
- - [Stream Printing Messages](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/stream_printing_messages)
- - [TTS](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts)
- - [High-code Deployment](https://github.com/agentscope-ai/agentscope/tree/main/examples/deployment/planning_agent)
- - [Memory Compression](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression)
- - Agent
- - [ReAct Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/react_agent)
- - [Voice Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent)
- - [Deep Research Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/deep_research_agent)
- - [Browser-use Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/browser_agent)
- - [Meta Planner Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/meta_planner_agent)
- - [A2A Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent)
- - Game
- - [Nine-player Werewolves](https://github.com/agentscope-ai/agentscope/tree/main/examples/game/werewolves)
- - Workflow
- - [Multi-agent Debate](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_debate)
- - [Multi-agent Conversation](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_conversation)
- - [Multi-agent Concurrent](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_concurrent)
- - Evaluation
- - [ACEBench](https://github.com/agentscope-ai/agentscope/tree/main/examples/evaluation/ace_bench)
- - Tuner
- - [Tune ReAct Agent](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent)
-
-
-## 🤝 Contributing
+## Contributing
We welcome contributions from the community! Please refer to our [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines
on how to contribute.
-## ⚖️ License
+## License
AgentScope is released under Apache License 2.0.
-## 📚 Publications
+## Publications
If you find our work helpful for your research or application, please cite our papers.
@@ -435,30 +369,7 @@ If you find our work helpful for your research or application, please cite our p
```
@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}
+ 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},
@@ -466,26 +377,7 @@ If you find our work helpful for your research or application, please cite our p
}
@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}
+ 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},
@@ -493,7 +385,7 @@ If you find our work helpful for your research or application, please cite our p
}
```
-## ✨ Contributors
+## Contributors
All thanks to our contributors:
diff --git a/README_zh.md b/README_zh.md
index 0bc176b79..e8b5016c0 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -1,5 +1,3 @@
-[**English Homepage**](https://github.com/agentscope-ai/agentscope/blob/main/README.md) | [**Tutorial**](https://doc.agentscope.io/zh_CN/) | [**Roadmap**](https://github.com/agentscope-ai/agentscope/blob/main/docs/roadmap.md) | [**FAQ**](https://doc.agentscope.io/zh_CN/tutorial/faq.html)
-
<p align="center">
<img
src="https://img.alicdn.com/imgextra/i1/O1CN01nTg6w21NqT5qFKH1u_!!6000000001621-55-tps-550-550.svg"
@@ -8,7 +6,11 @@
/>
</p>
-<h2 align="center">AgentScope: Agent-Oriented Programming for Building LLM Applications</h2>
+<span align="center">
+
+[**English Homepage**](https://github.com/agentscope-ai/agentscope/blob/main/README.md) | [**Tutorial**](https://doc.agentscope.io/zh_CN/) | [**Roadmap (Jan 2026 -)**](https://github.com/agentscope-ai/agentscope/blob/main/docs/roadmap.md) | [**FAQ**](https://doc.agentscope.io/zh_CN/tutorial/faq.html)
+
+</span>
<p align="center">
<a href="https://arxiv.org/abs/2402.14034">
@@ -29,16 +31,16 @@
alt="pypi"
/>
</a>
- <a href="https://doc.agentscope.io/">
+ <a href="https://discord.gg/eYMpfnkG8h">
<img
- src="https://img.shields.io/badge/Docs-English%7C%E4%B8%AD%E6%96%87-blue?logo=markdown"
- alt="docs"
+ src="https://img.shields.io/discord/1194846673529213039?label=Discord&logo=discord"
+ alt="discord"
/>
</a>
- <a href="https://agentscope.io/">
+ <a href="https://doc.agentscope.io/">
<img
- src="https://img.shields.io/badge/GUI-AgentScope_Studio-blue?logo=look&logoColor=green&color=dark-green"
- alt="workstation"
+ src="https://img.shields.io/badge/Docs-English%7C%E4%B8%AD%E6%96%87-blue?logo=markdown"
+ alt="docs"
/>
</a>
<a href="./LICENSE">
@@ -53,82 +55,45 @@
<img src="https://trendshift.io/api/badge/repositories/10079" alt="modelscope%2Fagentscope | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
</p>
-## 📢 新闻
-- **[2026-01]** 我们将启动 AgentScope 双周会议,分享生态系统的最新动态和开发计划 - 欢迎加入我们![详情和时间表](https://github.com/agentscope-ai/agentscope/discussions/1126)
-- **[2026-01]** AgentScope 已集成[数据库支持](https://doc.agentscope.io/zh_CN/tutorial/task_memory.html) 到记忆模块中,并新增[记忆压缩](https://doc.agentscope.io/zh_CN/tutorial/task_agent.html)功能。欢迎查看我们的[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression)和[文档](https://doc.agentscope.io/tutorial/task_memory.html)。
-- **[2025-12]** AgentScope 已支持 [A2A(Agent-to-Agent) 通信协议](https://doc.agentscope.io/tutorial/task_a2a.html)!查看 [样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent) 和 [教程](https://doc.agentscope.io/zh_CN/tutorial/task_a2a.html) 了解更多详情。
-- **[2025-12]** AgentScope 已支持 [TTS(Text-to-Speech) 模型](https://doc.agentscope.io/zh_CN/tutorial/task_tts.html) !欢迎查看 [样例]() 和 [教程](https://doc.agentscope.io/zh_CN/tutorial/task_tts.html) 了解更多详情。
-- **[2025-11]** AgentScope 已支持 [Anthropic Agent Skill](https://claude.com/blog/skills) !欢迎查看 [样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill) 和 [教程](https://doc.agentscope.io/zh_CN/tutorial/task_agent_skill.html) 了解更多详情。
-- **[2025-11]** AgentScope 开源 [Alias-Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/alias) 用于处理多样化的真实任务,以及 [Data-Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/data_juicer_agent) 用于自然语言驱动的数据处理。
-- **[2025-11]** AgentScope 通过集成 [Trinity-RFT](https://github.com/agentscope-ai/Trinity-RFT) 实现对 [Agentic RL](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent) 的支持。
-- **[2025-11]** AgentScope 集成 [ReMe](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory/reme) 增强长期记忆能力。
-- **[2025-11]** AgentScope 推出 [agentscope-samples](https://github.com/agentscope-ai/agentscope-samples) 样例库,并升级 [agentscope-runtime](https://github.com/agentscope-ai/agentscope-runtime) 支持 Docker/K8s 部署和 VNC 驱动的图形化沙盒。
-- **[2025-11]** [Contributing Guide](./CONTRIBUTING.md) 已更新,欢迎贡献到 AgentScope!
-- **[2025-09]** AgentScope 1.0 **RAG** 模块已上线!欢迎查看 [文档](https://doc.agentscope.io/zh_CN/tutorial/task_rag.html) 和 [样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag)。
-- **[2025-09]** **Voice agent** 已上线!`ReActAgent` 已原生支持 Qwen-Omni 和 GPT-Audio 系列模型,欢迎查看 [样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent) 和 [roadmap](https://github.com/agentscope-ai/agentscope/issues/773)。
-- **[2025-09]** 一个全新功能强大的 📋**Plan** 模块已经上线 AgentScope!查看[文档](https://doc.agentscope.io/zh_CN/tutorial/task_plan.html)了解更多详情。
-- **[2025-09]** **AgentScope Runtime** 现已开源!支持沙盒化工具执行的高效智能体部署,助力打造生产级AI应用。查看 [GitHub 仓库](https://github.com/agentscope-ai/agentscope-runtime)。
-- **[2025-09]** **AgentScope Studio** 现已开源!查看 [GitHub 仓库](https://github.com/agentscope-ai/agentscope-studio)。
-- **[2025-08]** v1 版本 Tutorial 已上线!查看 [tutorial](https://doc.agentscope.io/zh_CN/) 了解更多详情。
-- **[2025-08]** 🎉🎉 AgentScope v1现已发布!在完全拥抱异步执行的基础上提供许多新功能和改进。查看 [changelog](https://github.com/agentscope-ai/agentscope/blob/main/docs/changelog.md) 了解详细变更。
-
-
-## ✨ Why AgentScope?
-
-浅显入门,精深致用。
+## What is AgentScope?
+
+AgentScope 是一款企业级开箱即用的智能体框架,提供灵活的核心抽象以适配不断进化的模型能力,并原生支持模型微调。
+
+我们为新一代自主智能的大语言模型而生。 我们的理念是释放模型的推理与工具调用潜能,而不是用僵化的提示工程和预设流程束缚它们的手脚。
+
+## Why use AgentScope?
+
+- **简单**: 使用内置的 ReAct 智能体、工具、技能、人机协作、记忆、计划、实时语音、评估和模型微调轻松构建智能体应用
+- **可扩展**: 大量生态系统集成,包括工具、记忆和可观察性;内置 MCP 和 A2A 支持;消息中心(MsgHub)提供灵活的多智能体编排能力
+- **生产就绪**: 在本地、云端 Serverless 或 K8s 集群上轻松部署智能体应用,并内置 OTel 可观察性支持
+
<p align="center">
-<img src="./assets/images/agentscope_v1_0822.png" alt="AgentScope Framework" width="80%"/>
+<img src="./assets/images/agentscope_20260120.png" width="90%" alt="AgentScope 生态系统" />
+<br/>
+AgentScope 生态
</p>
-- **对开发者透明**: 透明是 AgentScope 的**首要原则**。无论提示工程、API调用、智能体构建还是工作流程编排,坚持对开发者可见&可控。拒绝深度封装或隐式魔法。
-- **[实时介入](https://doc.agentscope.io/zh_CN/tutorial/task_agent.html#realtime-steering)**: 原生支持**实时**中断和**自定义**中断处理。
-- **更智能化**: 支持[智能体工具管理](https://doc.agentscope.io/zh_CN/tutorial/task_tool.html)、[智能体长期记忆控制](https://doc.agentscope.io/zh_CN/tutorial/task_long_term_memory.html)和智能化RAG等。
-- **模型无关**: 一次编程,适配所有模型。
-- **“乐高式”智能体构建**: 所有组件保持**模块化**且**相互独立**。
-- **面向多智能体**:专为**多智能体**设计,**显式**的消息传递和工作流编排,拒绝深度封装。
-- **高度可定制**: 工具、提示、智能体、工作流、第三方库和可视化,AgentScope 支持&鼓励开发者进行定制。
-
-AgentScope v1.0 新功能概览:
-
-| 模块 | 功能 | 文档 |
-|------------|----------------------------------------------|-------------------------------------------------------------------------------|
-| model | 支持异步调用 | [Model](https://doc.agentscope.io/zh_CN/tutorial/task_model.html) |
-| | 支持推理模型 | |
-| | 支持流式/非流式返回 | |
-| | 支持工具API | |
-| tool | 支持异步/同步工具函数 | [Tool](https://doc.agentscope.io/zh_CN/tutorial/task_tool.html) |
-| | 支持工具函数流式/非流式返回 | |
-| | 支持用户打断 | |
-| | 支持工具函数的后处理 | |
-| | 支持分组工具管理 | |
-| | 支持智能体通过 Meta Tool 自主管理工具 | |
-| MCP | 支持 Streamable HTTP/SSE/StdIO 传输 | [MCP](https://doc.agentscope.io/zh_CN/tutorial/task_mcp.html) |
-| | 支持**有状态**和**无状态**两种模式的MCP客户端 | |
-| | 支持客户端和函数级别的精细控制 | |
-| agent | 支持异步执行 | |
-| | 支持并行工具调用 | |
-| | 支持用户实时介入和自定义的中断处理 | |
-| | 支持自动状态管理 | |
-| | 允许智能体自主控制长期记忆 | |
-| | 支持智能体钩子函数 | |
-| tracing | 支持基于 OpenTelemetry 的 LLM、工具、智能体和格式化器追踪 | [Tracing](https://doc.agentscope.io/zh_CN/tutorial/task_tracing.html) |
-| | 支持连接到第三方追踪平台(如阿里云云监控、Arize-Phoenix、Langfuse) | |
-| memory | 支持长期记忆 | [Memory](https://doc.agentscope.io/zh_CN/tutorial/task_long_term_memory.html) |
-| session | 提供会话/应用级状态管理 | [Session](https://doc.agentscope.io/zh_CN/tutorial/task_state.html) |
-| evaluation | 提供分布式和并行评估 | [Evaluation](https://doc.agentscope.io/zh_CN/tutorial/task_eval.html) |
-| formatter | 支持多Agent提示格式化与工具API | [Prompt Formatter](https://doc.agentscope.io/zh_CN/tutorial/task_prompt.html) |
-| | 支持基于截断的格式化策略 | |
-| plan | 支持任务分解和计划制定 | [Plan](https://doc.agentscope.io/zh_CN/tutorial/task_plan.html) |
-| | 支持开发者手动设定计划 | |
-| RAG | 支持 agentic RAG | [RAG](https://doc.agentscope.io/tutorial/task_rag.html) |
-| | 支持多模态 RAG | |
-| A2A | 支持 A2A 智能体 | [A2A](https://doc.agentscope.io/tutorial/task_a2a.html) |
-| ... | | |
-
-## 💬 联系我们
-
-欢迎加入我们的社区,获取最新的更新和支持!
+
+## 📢 新闻
+<!-- BEGIN NEWS -->
+- **[2026-01] `社区`:** AgentScope 双周会议启动,分享生态更新和开发计划 - 欢迎加入![详情与安排](https://github.com/agentscope-ai/agentscope/discussions/1126)
+- **[2026-01] `功能`:** 记忆模块新增数据库支持和记忆压缩。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression) | [教程](https://doc.agentscope.io/tutorial/task_memory.html)
+- **[2025-12] `集成`:** A2A(智能体间通信)协议支持。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_a2a.html)
+- **[2025-12] `功能`:** TTS(文本转语音)支持。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_tts.html)
+- **[2025-11] `集成`:** Anthropic Agent Skill 支持。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_agent_skill.html)
+- **[2025-11] `发布`:** 面向多样化真实任务的 Alias-Agent 和数据处理的 Data-Juicer Agent 开源。[Alias-Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/alias) | [Data-Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/data_juicer_agent)
+- **[2025-11] `集成`:** 通过 Trinity-RFT 库实现智能体强化学习。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent) | [Trinity-RFT](https://github.com/agentscope-ai/Trinity-RFT)
+- **[2025-11] `集成`:** ReMe 增强长期记忆。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory/reme)
+- **[2025-11] `发布`:** agentscope-samples 样例库上线,agentscope-runtime 升级支持 Docker/K8s 部署和 VNC 图形沙盒。[样例库](https://github.com/agentscope-ai/agentscope-samples) | [Runtime](https://github.com/agentscope-ai/agentscope-runtime)
+- **[2025-11] `文档`:** 贡献指南上线 - 欢迎参与贡献![指南](./CONTRIBUTING_zh.md)
+<!-- END NEWS -->
+
+[更多新闻 →](./docs/NEWS_zh.md)
+
+## 联系我们
+
+欢迎加入我们的社区!
| [Discord](https://discord.gg/eYMpfnkG8h) | 钉钉 |
|----------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
@@ -136,74 +101,71 @@ AgentScope v1.0 新功能概览:
<!-- 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)
- - [🛠️ 从源码安装](#-%E4%BB%8E%E6%BA%90%E7%A0%81%E5%AE%89%E8%A3%85)
- - [🔄 使用 uv 安装(推荐,安装更快)](#-%E4%BD%BF%E7%94%A8-uv-%E5%AE%89%E8%A3%85%E6%8E%A8%E8%8D%90%E5%AE%89%E8%A3%85%E6%9B%B4%E5%BF%AB)
- - [📦 从PyPi安装](#-%E4%BB%8Epypi%E5%AE%89%E8%A3%85)
-- [📝 样例](#-%E6%A0%B7%E4%BE%8B)
- - [👋 Hello AgentScope!](#-hello-agentscope)
- - [🎯 实时介入](#-%E5%AE%9E%E6%97%B6%E4%BB%8B%E5%85%A5)
- - [🛠️ 细粒度 MCP 控制](#-%E7%BB%86%E7%B2%92%E5%BA%A6-mcp-%E6%8E%A7%E5%88%B6)
- - [🧑‍🤝‍🧑 多智能体对话](#-%E5%A4%9A%E6%99%BA%E8%83%BD%E4%BD%93%E5%AF%B9%E8%AF%9D)
- - [💻 AgentScope Studio](#-agentscope-studio)
-- [📖 文档](#-%E6%96%87%E6%A1%A3)
-- [🤝 贡献](#-%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)
+## 📑 目录
+
+- [快速开始](#快速开始)
+ - [安装](#安装)
+ - [从 PyPI 安装](#从-pypi-安装)
+ - [从源码安装](#从源码安装)
+- [样例](#样例)
+ - [Hello AgentScope!](#hello-agentscope)
+ - [语音智能体](#语音智能体)
+ - [人机协作](#人机协作)
+ - [细粒度 MCP 控制](#细粒度-mcp-控制)
+ - [智能体强化学习](#智能体强化学习)
+ - [多智能体工作流](#多智能体工作流)
+- [文档](#文档)
+- [更多样例](#更多样例)
+ - [功能](#功能)
+ - [智能体](#智能体)
+ - [游戏](#游戏)
+ - [工作流](#工作流)
+ - [评估](#评估)
+ - [训练](#训练)
+- [贡献](#贡献)
+- [许可](#许可)
+- [论文](#论文)
+- [贡献者](#贡献者)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
-## 🚀 快速开始
+## 快速开始
-### 💻 安装
+### 安装
-> AgentScope需要**Python 3.10**或更高版本。
+> AgentScope 需要 **Python 3.10** 或更高版本。
-#### 🛠️ 从源码安装
+#### 从 PyPI 安装
```bash
-# 从 GitHub 拉取源码
-git clone -b main https://github.com/agentscope-ai/agentscope.git
-
-# 以可编辑模式安装包
-cd agentscope
-pip install -e .
+pip install agentscope
```
-#### 🔄 使用 uv 安装(推荐,安装更快)
-
-[uv](https://github.com/astral-sh/uv) 是一个用 Rust 编写的快速 Python 包安装程序和解析器。
+或使用 uv:
```bash
-# 克隆仓库
-git clone -b main https://github.com/agentscope-ai/agentscope.git
-cd agentscope
-
-# 使用 uv 安装
-uv pip install -e .
+uv pip install agentscope
```
-#### 📦 从PyPi安装
+#### 从源码安装
```bash
-pip install agentscope
-```
+# 从 GitHub 拉取源码
+git clone -b main https://github.com/agentscope-ai/agentscope.git
-或者使用 uv:
+# 以可编辑模式安装包
+cd agentscope
-```bash
-uv pip install agentscope
+pip install -e .
+# 或使用 uv:
+# uv pip install -e .
```
-## 📝 样例
+## 样例
-### 👋 Hello AgentScope!
+### Hello AgentScope!
-使用 AgentScope 显式地创建一个名为“Friday”的助手🤖,并与之对话。
+开始与名为"Friday"的 ReAct 智能体 🤖 进行对话!
```python
from agentscope.agent import ReActAgent, UserAgent
@@ -244,18 +206,23 @@ async def main():
asyncio.run(main())
```
-### 🎯 实时介入
+### 语音智能体
-在 ``ReActAgent`` 中原生支持**实时介入**功能,提供面向打断的记忆处理机制,将中断转换为智能体的**可观察事件**,让智能体能够无缝恢复对话。
+创建支持语音的 ReAct 智能体,能够理解语音并进行语音回复,还可以使用语音交互玩多智能体狼人杀游戏。
-<p align="center">
- <img src="./assets/images/realtime_steering_zh.gif" alt="Realtime Steering" width="49%"/>
- <img src="./assets/images/realtime_steering_en.gif" alt="Realtime Steering" width="49%"/>
-</p>
-### 🛠️ 细粒度 MCP 控制
+https://github.com/user-attachments/assets/559af387-fd6f-4f0c-b882-cd4778214801
-开发者能够以**本地可调用函数**的方式获得 MCP 工具,并以任意方式使用(例如直接调用、装备给智能体,或将其包装为更复杂的工具等)
+
+### 人机协作
+
+在 ReActAgent 中支持实时打断:可以通过取消操作实时中断对话,并通过强大的记忆保留机制无缝恢复。
+
+<img src="./assets/images/realtime_steering_zh.gif" alt="Realtime Steering" width="60%"/>
+
+### 灵活的 MCP 控制
+
+AgentScope 支持将单个 MCP 工具作为**本地可调用函数**使用,装备给智能体或封装为更复杂的工具。
```python
from agentscope.mcp import HttpStatelessClient
@@ -270,24 +237,37 @@ async def fine_grained_mcp_control():
url=f"https://mcp.amap.com/mcp?key={os.environ['GAODE_API_KEY']}",
)
- # 将MCP工具获取为**本地可调用函数**,并在任何地方使用
+ # 将 MCP 工具获取为**本地可调用函数**,并在任何地方使用
func = await client.get_callable_function(func_name="maps_geo")
- # 选项1:直接调用
+ # 选项 1:直接调用
await func(address="天安门广场", city="北京")
- # 选项2:作为工具传递给智能体
+ # 选项 2:作为工具传递给智能体
toolkit = Toolkit()
toolkit.register_tool_function(func)
# ...
- # 选项3:包装为更复杂的工具
+ # 选项 3:包装为更复杂的工具
# ...
```
-### 🧑‍🤝‍🧑 多智能体对话
+### 智能体强化学习
+
+通过强化学习集成无缝训练智能体应用。我们还准备了涵盖各种场景的样例项目:
+
+| 样例 | 描述 | 模型 | 训练结果 |
+|--------------------------------------------------------------------------------------------------|----------------------------|------------------------|-----------------------------|
+| [Math Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/math_agent) | 通过多步推理调优数学求解智能体。 | Qwen3-0.6B | Accuracy: 75% → 85% |
+| [Frozen Lake](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/frozen_lake) | 训练智能体进行冰湖游戏。 | Qwen2.5-3B-Instruct | Success rate: 15% → 86% |
+| [Learn to Ask](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/learn_to_ask) | 使用 LLM 作为评判获得自动反馈,从而调优智能体。 | Qwen2.5-7B-Instruct | Accuracy: 47% → 92% |
+| [Email Search](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/email_search) | 在训练数据没有标注真值的情况下提升工具使用能力。 | Qwen3-4B-Instruct-2507 | Accuracy: 60% |
+| [Werewolf Game](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/werewolves) | 训练智能体进行战略性多智能体游戏互动。 | Qwen2.5-7B-Instruct | 狼人胜率:50% → 80% |
+| [Data Augment](https://github.com/agentscope-ai/agentscope-samples/tree/main/tuner/data_augment) | 生成合成训练数据以增强调优结果。 | Qwen3-0.6B | AIME-24 accuracy: 20% → 60% |
+
+### 多智能体工作流
-AgentScope 提供 ``MsgHub`` 和多种 pipeline 来简化多智能体对话的构建,提供高效的消息路由和无缝信息共享
+AgentScope 提供 ``MsgHub`` 和 pipeline 来简化多智能体对话,提供高效的消息路由和无缝信息共享
```python
from agentscope.pipeline import MsgHub, sequential_pipeline
@@ -317,115 +297,65 @@ asyncio.run(multi_agent_conversation())
```
-### 💻 AgentScope Studio
+## 文档
-使用以下命令安装并启动 AgentScope Studio,以追踪和可视化基于 AgentScope 构建的智能体应用。
+- [教程](https://doc.agentscope.io/zh_CN/tutorial/)
+- [常见问题](https://doc.agentscope.io/zh_CN/tutorial/faq.html)
+- [API 文档](https://doc.agentscope.io/zh_CN/api/agentscope.html)
-```bash
-npm install -g @agentscope/studio
+## 更多样例
-as_studio
-```
+### 功能
-<p align="center">
- <img
- src="https://img.alicdn.com/imgextra/i1/O1CN01PG2MdF1Zc44A1QM6N_!!6000000003214-1-tps-1971-1080.gif"
- width="49%"
- alt="home"
- />
- <img
- src="https://img.alicdn.com/imgextra/i2/O1CN01pGHedL1L4ibmyPeiq_!!6000000001246-1-tps-1971-1080.gif"
- width="49%"
- alt="runtime"
- />
- <img
- src="https://img.alicdn.com/imgextra/i1/O1CN01HfFhy928SSJAcWQ8c_!!6000000007931-1-tps-1971-1080.gif"
- width="49%"
- alt="traces"
- />
- <img
- src="https://img.alicdn.com/imgextra/i1/O1CN01vovov821Arms9tEJ1_!!6000000006945-1-tps-1971-1080.gif"
- width="49%"
- alt="friday"
- />
-</p>
+- [MCP](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/mcp)
+- [Anthropic 智能体技能](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill)
+- [计划](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/plan)
+- [结构化输出](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/structured_output)
+- [RAG](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag)
+- [长期记忆](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory)
+- [基于 SQLite 的会话管理](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/session_with_sqlite)
+- [流式打印消息](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/stream_printing_messages)
+- [TTS](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts)
+- [高代码部署](https://github.com/agentscope-ai/agentscope/tree/main/examples/deployment/planning_agent)
+- [记忆压缩](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression)
+
+### 智能体
+
+- [ReAct 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/react_agent)
+- [语音智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent)
+- [Deep Research 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/deep_research_agent)
+- [Browser-use 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/browser_agent)
+- [Meta Planner 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/meta_planner_agent)
+- [A2A 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent)
+
+### 游戏
+
+- [九人制狼人杀](https://github.com/agentscope-ai/agentscope/tree/main/examples/game/werewolves)
+
+### 工作流
+
+- [多智能体辩论](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_debate)
+- [多智能体对话](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_conversation)
+- [多智能体并发](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_concurrent)
+
+### 评估
+
+- [ACEBench](https://github.com/agentscope-ai/agentscope/tree/main/examples/evaluation/ace_bench)
+
+### 微调
+
+- [调优 ReAct 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent)
+
+
+## 贡献
+我们欢迎社区的贡献!请参阅我们的 [贡献指南](./CONTRIBUTING_zh.md) 了解如何贡献到 AgentScope。
-## 📖 文档
-
-- 教程
- - [安装](https://doc.agentscope.io/zh_CN/tutorial/quickstart_installation.html)
- - [核心概念](https://doc.agentscope.io/zh_CN/tutorial/quickstart_key_concept.html)
- - [创建消息](https://doc.agentscope.io/zh_CN/tutorial/quickstart_message.html)
- - [ReAct Agent](https://doc.agentscope.io/zh_CN/tutorial/quickstart_agent.html)
-- 工作流
- - [对话(Conversation)](https://doc.agentscope.io/zh_CN/tutorial/workflow_conversation.html)
- - [多智能体辩论(Multi-Agent Debate)](https://doc.agentscope.io/zh_CN/tutorial/workflow_multiagent_debate.html)
- - [智能体并发(Concurrent Agents)](https://doc.agentscope.io/zh_CN/tutorial/workflow_concurrent_agents.html)
- - [路由(Routing)](https://doc.agentscope.io/zh_CN/tutorial/workflow_routing.html)
- - [交接(Handoffs)](https://doc.agentscope.io/zh_CN/tutorial/workflow_handoffs.html)
-- 常见问题
- - [FAQ](https://doc.agentscope.io/zh_CN/tutorial/faq.html)
-- 任务指南
- - [模型](https://doc.agentscope.io/zh_CN/tutorial/task_model.html)
- - [提示格式化器](https://doc.agentscope.io/zh_CN/tutorial/task_prompt.html)
- - [工具](https://doc.agentscope.io/zh_CN/tutorial/task_tool.html)
- - [记忆](https://doc.agentscope.io/zh_CN/tutorial/task_memory.html)
- - [长期记忆](https://doc.agentscope.io/zh_CN/tutorial/task_long_term_memory.html)
- - [智能体](https://doc.agentscope.io/zh_CN/tutorial/task_agent.html)
- - [管道(Pipeline)](https://doc.agentscope.io/zh_CN/tutorial/task_pipeline.html)
- - [计划](https://doc.agentscope.io/zh_CN/tutorial/task_plan.html)
- - [状态/会话管理](https://doc.agentscope.io/zh_CN/tutorial/task_state.html)
- - [智能体钩子函数](https://doc.agentscope.io/zh_CN/tutorial/task_hook.html)
- - [MCP](https://doc.agentscope.io/zh_CN/tutorial/task_mcp.html)
- - [AgentScope Studio](https://doc.agentscope.io/zh_CN/tutorial/task_studio.html)
- - [追踪](https://doc.agentscope.io/zh_CN/tutorial/task_tracing.html)
- - [智能体评测](https://doc.agentscope.io/zh_CN/tutorial/task_eval.html)
- - [嵌入(Embedding)](https://doc.agentscope.io/zh_CN/tutorial/task_embedding.html)
- - [Token计数](https://doc.agentscope.io/zh_CN/tutorial/task_token.html)
-- API
- - [API文档](https://doc.agentscope.io/zh_CN/api/agentscope.html)
-- [示例](https://github.com/agentscope-ai/agentscope/tree/main/examples)
- - 功能演示
- - [MCP](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/mcp)
- - [Anthropic 智能体技能](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill)
- - [计划](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/plan)
- - [结构化输出](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/structured_output)
- - [RAG](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag)
- - [长期记忆](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory)
- - [基于DB的会话管理](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/session_with_sqlite)
- - [流式获取打印消息](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/stream_printing_messages)
- - [TTS](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts)
- - [高代码部署](https://github.com/agentscope-ai/agentscope/tree/main/examples/deployment/planning_agent)
- - [记忆压缩](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression)
- - 智能体
- - [ReAct 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/react_agent)
- - [语音智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent)
- - [Deep Research 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/deep_research_agent)
- - [Browser-use 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/browser_agent)
- - [Meta Planner 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/meta_planner_agent)
- - [A2A 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent)
- - 游戏
- - [九人制狼人杀](https://github.com/agentscope-ai/agentscope/tree/main/examples/game/werewolves)
- - 工作流
- - [多智能体辩论](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_debate)
- - [多智能体对话](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_conversation)
- - [多智能体并发](https://github.com/agentscope-ai/agentscope/tree/main/examples/workflows/multiagent_concurrent)
- - 评测
- - [ACEBench](https://github.com/agentscope-ai/agentscope/tree/main/examples/evaluation/ace_bench)
- - 微调
- - [微调 ReAct 智能体](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent)
-
-
-## 🤝 贡献
-
-我们欢迎并鼓励社区成员为 AgentScope 做出贡献!请参阅我们的 [贡献指南](./CONTRIBUTING.md) 了解更多详情。
-
-## ⚖️ 许可
+## 许可
AgentScope 基于 Apache License 2.0 发布。
-## 📚 论文
+## 论文
如果我们的工作对您的研究或应用有帮助,请引用我们的论文。
@@ -435,30 +365,7 @@ 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}
+ 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},
@@ -466,26 +373,7 @@ AgentScope 基于 Apache License 2.0 发布。
}
@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}
+ 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},
@@ -493,10 +381,10 @@ AgentScope 基于 Apache License 2.0 发布。
}
```
-## ✨ 贡献者
+## 贡献者
感谢所有贡献者:
<a href="https://github.com/agentscope-ai/agentscope/graphs/contributors">
- <img src="https://contrib.rocks/image?repo=agentscope-ai/agentscope&max=999&columns=12&anon=1" />
+ <img src="https://contrib.rocks/image?repo=agentscope-ai/agentscope&max=999&columns=12&anon=1" alt="贡献者" />
</a>
diff --git a/assets/images/agentscope_20260120.png b/assets/images/agentscope_20260120.png
new file mode 100644
index 000000000..eecaac223
Binary files /dev/null and b/assets/images/agentscope_20260120.png differ
diff --git a/assets/images/agentscope_v1_0822.png b/assets/images/agentscope_v1_0822.png
deleted file mode 100644
index 14950eb4c..000000000
Binary files a/assets/images/agentscope_v1_0822.png and /dev/null differ
diff --git a/docs/NEWS.md b/docs/NEWS.md
new file mode 100644
index 000000000..f5c5d9921
--- /dev/null
+++ b/docs/NEWS.md
@@ -0,0 +1,22 @@
+<!-- This is the source of truth for all NEWS items. -->
+<!-- The first 10 items are automatically synced to README.md and README_zh.md via GitHub Actions. -->
+<!-- To update news in READMEs, modify this file and push to trigger the workflow. -->
+
+- **[2026-01] `COMM`:** Biweekly Meetings launched to share ecosystem updates and development plans - join us! [Details & Schedule](https://github.com/agentscope-ai/agentscope/discussions/1126)
+- **[2026-01] `FEAT`:** Database support & memory compression in memory module. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression) | [Tutorial](https://doc.agentscope.io/tutorial/task_memory.html)
+- **[2025-12] `INTG`:** A2A (Agent-to-Agent) protocol support. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent) | [Tutorial](https://doc.agentscope.io/tutorial/task_a2a.html)
+- **[2025-12] `FEAT`:** TTS (Text-to-Speech) support. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts) | [Tutorial](https://doc.agentscope.io/tutorial/task_tts.html)
+- **[2025-11] `INTG`:** Anthropic Agent Skill support. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill) | [Tutorial](https://doc.agentscope.io/tutorial/task_agent_skill.html)
+- **[2025-11] `RELS`:** Alias-Agent for diverse real-world tasks and Data-Juicer Agent for data processing open-sourced. [Alias-Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/alias) | [Data-Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/data_juicer_agent)
+- **[2025-11] `INTG`:** Agentic RL via Trinity-RFT library. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent) | [Trinity-RFT](https://github.com/agentscope-ai/Trinity-RFT)
+- **[2025-11] `INTG`:** ReMe for enhanced long-term memory. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory/reme)
+- **[2025-11] `RELS`:** agentscope-samples repository launched and agentscope-runtime upgraded with Docker/K8s deployment and VNC-powered GUI sandboxes. [Samples](https://github.com/agentscope-ai/agentscope-samples) | [Runtime](https://github.com/agentscope-ai/agentscope-runtime)
+- **[2025-11] `DOCS`:** Contributing Guide is online - welcome to contribute! [Guide](./CONTRIBUTING.md)
+- **[2025-09] `FEAT`:** RAG module released. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag) | [Tutorial](https://doc.agentscope.io/tutorial/task_rag.html)
+- **[2025-09] `FEAT`:** Voice agent support - ReActAgent now supports Qwen-Omni and GPT-Audio natively. [Example](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent) | [Roadmap](https://github.com/agentscope-ai/agentscope/issues/773)
+- **[2025-09] `FEAT`:** Plan module released. [Tutorial](https://doc.agentscope.io/tutorial/task_plan.html)
+- **[2025-09] `RELS`:** AgentScope Runtime open-sourced - enabling effective agent deployment with sandboxed tool execution. [GitHub](https://github.com/agentscope-ai/agentscope-runtime)
+- **[2025-09] `RELS`:** AgentScope Studio open-sourced. [GitHub](https://github.com/agentscope-ai/agentscope-studio)
+- **[2025-08] `DOCS`:** Tutorial v1 is online. [Tutorial](https://doc.agentscope.io)
+- **[2025-08] `RELS`:** AgentScope v1 released - fully embracing asynchronous execution with many new features and improvements. [Changelog](https://github.com/agentscope-ai/agentscope/blob/main/docs/changelog.md)
+
diff --git a/docs/NEWS_zh.md b/docs/NEWS_zh.md
new file mode 100644
index 000000000..7c0d85ffc
--- /dev/null
+++ b/docs/NEWS_zh.md
@@ -0,0 +1,21 @@
+<!-- This is the source of truth for all NEWS items. -->
+<!-- The first 10 items are automatically synced to README.md and README_zh.md via GitHub Actions. -->
+<!-- To update news in READMEs, modify this file and push to trigger the workflow. -->
+
+- **[2026-01] `社区`:** AgentScope 双周会议启动,分享生态更新和开发计划 - 欢迎加入![详情与安排](https://github.com/agentscope-ai/agentscope/discussions/1126)
+- **[2026-01] `功能`:** 记忆模块新增数据库支持和记忆压缩。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/short_term_memory/memory_compression) | [教程](https://doc.agentscope.io/tutorial/task_memory.html)
+- **[2025-12] `集成`:** A2A(智能体间通信)协议支持。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/a2a_agent) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_a2a.html)
+- **[2025-12] `功能`:** TTS(文本转语音)支持。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/tts) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_tts.html)
+- **[2025-11] `集成`:** Anthropic Agent Skill 支持。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/agent_skill) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_agent_skill.html)
+- **[2025-11] `发布`:** 面向多样化真实任务的 Alias-Agent 和数据处理的 Data-Juicer Agent 开源。[Alias-Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/alias) | [Data-Juicer Agent](https://github.com/agentscope-ai/agentscope-samples/tree/main/data_juicer_agent)
+- **[2025-11] `集成`:** 通过 Trinity-RFT 库实现智能体强化学习。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/tuner/react_agent) | [Trinity-RFT](https://github.com/agentscope-ai/Trinity-RFT)
+- **[2025-11] `集成`:** ReMe 增强长期记忆。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/long_term_memory/reme)
+- **[2025-11] `发布`:** agentscope-samples 样例库上线,agentscope-runtime 升级支持 Docker/K8s 部署和 VNC 图形沙盒。[样例库](https://github.com/agentscope-ai/agentscope-samples) | [Runtime](https://github.com/agentscope-ai/agentscope-runtime)
+- **[2025-11] `文档`:** 贡献指南上线 - 欢迎参与贡献![指南](./CONTRIBUTING_zh.md)
+- **[2025-09] `功能`:** RAG 模块发布。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/functionality/rag) | [教程](https://doc.agentscope.io/zh_CN/tutorial/task_rag.html)
+- **[2025-09] `功能`:** 语音智能体支持 - ReActAgent 原生支持 Qwen-Omni 和 GPT-Audio。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent/voice_agent) | [Roadmap](https://github.com/agentscope-ai/agentscope/issues/773)
+- **[2025-09] `功能`:** Plan 模块发布。[教程](https://doc.agentscope.io/zh_CN/tutorial/task_plan.html)
+- **[2025-09] `发布`:** AgentScope Runtime 开源 - 支持沙盒化工具执行的高效智能体部署。[GitHub](https://github.com/agentscope-ai/agentscope-runtime)
+- **[2025-09] `发布`:** AgentScope Studio 开源。[GitHub](https://github.com/agentscope-ai/agentscope-studio)
+- **[2025-08] `文档`:** v1 版本教程上线。[教程](https://doc.agentscope.io/zh_CN/)
+- **[2025-08] `发布`:** AgentScope v1 发布 - 全面拥抱异步执行,诸多新功能和改进。[变更日志](https://github.com/agentscope-ai/agentscope/blob/main/docs/changelog.md)
diff --git a/docs/roadmap.md b/docs/roadmap.md
index 779e018a2..93d392d1d 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -4,7 +4,79 @@
Offering **agent-oriented programming (AOP)** as a new programming paradigm to organize the design and implementation of next-generation LLM-empowered applications.
-## Short-term Goals
+## Current Focus (January 2026 - )
+
+### 🎙️ Voice Agent
+
+**Voice agents** are a domain we are highly focused on, and AgentScope will continue to invest in this direction.
+
+AgentScope aims to build **production-ready** voice agents rather than demonstration prototypes. This means our voice agents will:
+
+- Support **production-grade** deployment, including seamless frontend integration
+- Support **tool invocation**, not just voice conversations
+- Support **multi-agent** voice interactions
+
+#### Development Roadmap
+
+Our development strategy for voice agents consists of **three progressive milestones**:
+
+1. **TTS Models** → 2. **Multimodal Models** → 3. **Real-time Multimodal Models**
+
+---
+
+#### Phase 1: TTS (Text-to-Speech) Models
+
+- **Build TTS model base class infrastructure**
+ - Design and implement a unified TTS model base class
+ - Establish standardized interfaces for TTS model integration
+
+- **Horizontal API expansion**
+ - Support mainstream TTS APIs (e.g., OpenAI TTS, Google TTS, Azure TTS, ElevenLabs, etc.)
+ - Ensure consistent behavior across different TTS providers
+
+---
+
+#### Phase 2: Multimodal Models (Non-Realtime)
+
+- **Enable ReAct agents with multimodal support**
+ - Integrate multimodal models (e.g., qwen3-omni, gpt-audio) into existing ReAct agent framework
+ - Support audio input/output in non-realtime mode
+
+- **Advanced multimodal agent capabilities**
+ - Enable tool invocation within multimodal conversations
+ - Support multi-agent workflows with multimodal communication
+
+---
+
+#### Phase 3: Real-time Multimodal Models
+
+
+- **Beyond request-response**: Explore streaming, interrupt handling, and concurrent multimodal processing
+- **New programming paradigms**: Design agent programming models specifically tailored for real-time interactions
+- **Production readiness**: Ensure low-latency performance, stability, and scalability for production deployment
+
+### 🛠️ Agent Skill
+
+Provide **production-ready** agent skill integration solutions.
+
+### 🌐 Ecosystem Expansion
+
+- **A2UI (Agent-to-UI)**: Enable seamless agent-to-user interface interactions
+- **A2A (Agent-to-Agent)**: Enhance agent-to-agent communication capabilities
+
+### 🚀 Agentic RL
+
+- Support using [Tinker](https://tinker-docs.thinkingmachines.ai/) backend to tune agent applications on devices without GPU.
+- Support tuning agent applications based on their run history.
+- Integrate with AgentScope Runtime to provide better environment abstraction.
+- Add more tutorials and examples on how to build complex judge functions with the help of evaluation module.
+- Add more tutorials and examples on data selection and augmentation.
+
+### 📈 Code Quality
+
+Continuous refinement and improvement of code quality and maintainability.
+
+# Completed Milestones
### AgentScope V1.0.0 Roadmap