agentscope-ai/agentscope

中文主页 | 教程 (Tutorial) | 路线图 (Roadmap)

什么是 AgentScope 2.0？

AgentScope 2.0 是一个生产就绪、易于使用的智能体（Agent）框架。它提供了必要的核心抽象，能够适配不断发展的模型能力，并内置了对模型微调的支持。

我们致力于为日益智能化的 LLM 设计框架。我们的方法旨在充分利用模型的推理和工具使用能力，而不是通过严格的 Prompt 和主观的编排来限制它们。

为什么要使用 AgentScope？

简单：5 分钟内即可构建你的智能体。内置了 ReAct 智能体、工具、技能、人机协作（Human-in-the-loop）、记忆、规划、实时语音、评估以及模型微调功能。
可扩展：拥有庞大的生态集成，涵盖工具、记忆和可观测性；内置对 MCP 和 A2A 的支持；提供灵活的多智能体编排和工作流消息中心（Message Hub）。
生产就绪：支持在本地、云端 Serverless 或 K8s 集群中部署和提供智能体服务，并内置了 OTel 支持。

社区

欢迎加入我们的社区：

Discord	钉钉 (DingTalk)
(Discord 图标)	(钉钉图标)

快速开始

安装

AgentScope 要求 Python 3.11 或更高版本。

通过 PyPI 安装

uv pip install agentscope
# or
# pip install agentscope

从源码安装

# 从 GitHub 拉取源码
git clone -b main https://github.com/agentscope-ai/agentscope.git

# 以可编辑模式安装包
cd agentscope

uv pip install -e .
# or
# pip install -e .

你好，AgentScope！

使用 AgentScope 2.0 在 5 分钟内启动你的第一个智能体：

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())

智能体服务

这是一个基于 FastAPI 的可扩展的、支持多租户、多会话的智能体服务，并在 examples/web_ui 中提供了预构建的 Web UI。

git clone https://github.com/agentscope-ai/agentscope

cd agentscope/examples/agent_service

# 启动智能体服务后端
python main.py

然后打开另一个终端启动 Web UI：

cd agentscope/examples/web_ui

# 启动 webui
pnpm install
pnpm dev

体验聊天式界面并与你的智能体进行交互。

贡献指南

我们欢迎来自社区的贡献！请参阅我们的 CONTRIBUTING.md 了解如何参与贡献。

许可证

AgentScope 采用 Apache License 2.0 协议发布。

学术发表

如果你觉得我们的工作对你的研究或应用有帮助，请引用我们的论文。

[AgentScope 1.0: A Developer-Centric Framework for...]