δΈζδΈ»ι‘΅ | Tutorial | Roadmap | FAQ
Easy for beginners, powerful for experts.
- 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: Interrupt the agent at ANY time, and customize the handling.
- 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.
- Developer-friendly: Low-code development, visual tracing & monitoring. From developing to deployment, all in one place.
Quick overview of AgentScope's new features in v1.0:
Module | Feature | Tutorial |
---|---|---|
model | Support async invocation | Model |
Support reasoning model | ||
Support streaming/non-streaming returns | ||
Support tools API | ||
tool | Support async/sync tool functions | Tool |
Support streaming/non-streaming returns | ||
Support user interruption | ||
Support post-processing | ||
Support group-wise tool management | ||
Support agent-controlled tools management | ||
MCP | Support streamable HTTP/SSE/StdIO transport | MCP |
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 tracing model, agent, tool | Tracing |
Support connecting to third-party tracing platforms (e.g. Arize-Phoenix, Langfuse) | ||
memory | Support long-term memory | Memory |
session | Provide session/application-level state management | Session |
evaluation | Provide distributed and parallel evaluation | Evaluation |
formatter | Support multi-agent prompt formatting with tools API | Prompt Formatter |
... |
- [2025-08] The new tutorial of v1 is online now! Check out the tutorial 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 for detailed changes.
Welcome to join our community on
Discord | DingTalk |
---|---|
AgentScope requires Python 3.10 or higher.
# 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
Start with a conversation between user and a ReAct agent π€ named "Friday"!
from agentscope.agent import ReActAgent, UserAgent
from agentscope.model import DashScopeChatModel
from agentscope.formatter import DashScopeChatFormatter
from agentscope.memory import InMemoryMemory
from agentscope.tool import Toolkit, execute_python_code, execute_shell_command
import os, asyncio
async def main():
toolkit = Toolkit()
toolkit.register_tool_function(execute_python_code)
toolkit.register_tool_function(execute_shell_command)
agent = ReActAgent(
name="Friday",
sys_prompt="You're a helpful assistant named Friday.",
model=DashScopeChatModel(
model_name="qwen-max",
api_key=os.environ["DASHSCOPE_API_KEY"],
stream=True,
),
memory=InMemoryMemory(),
formatter=DashScopeChatFormatter(),
toolkit=toolkit,
)
user = UserAgent(name="user")
msg = None
while True:
msg = await agent(msg)
msg = await user(msg)
if msg.get_text_content() == "exit":
break
asyncio.run(main())
- Tutorial
- Workflow
- FAQ
- Task Guides
- API
Use the following command to install and start AgentScope Studio, to trace and visualize your agent application.
npm install -g @agentscope/studio
as_studio
AgentScope is released under Apache License 2.0.
If you find our work helpful for your research or application, please cite our papers.
AgentScope: A Flexible yet Robust Multi-Agent Platform
@article{agentscope,
author = {Dawei Gao and
Zitao Li and
Xuchen Pan and
Weirui Kuang and
Zhijian Ma and
Bingchen Qian and
Fei Wei and
Wenhao Zhang and
Yuexiang Xie and
Daoyuan Chen and
Liuyi Yao and
Hongyi Peng and
Ze Yu Zhang and
Lin Zhu and
Chen Cheng and
Hongzhu Shi and
Yaliang Li and
Bolin Ding and
Jingren Zhou}
title = {AgentScope: A Flexible yet Robust Multi-Agent Platform},
journal = {CoRR},
volume = {abs/2402.14034},
year = {2024},
}
All thanks to our contributors: