agentscope-ai/agentscope
AI 工程用 Python 构建可带工具、记忆和沙箱的多智能体应用,并能部署成带 Web UI 的多租户服务。
项目介绍
AgentScope 2.0 是一个 Python 智能体框架,设计思路是让模型依靠自身的推理和工具调用能力,而不是用严格 prompt 和固定编排去限制它。它既提供组装单个智能体的积木——ReAct 循环、工具包、模型适配、上下文管理、事件流、权限控制、中间件、长期记忆、工作区与沙箱——也自带一套可直接运行的智能体服务:FastAPI 后端加预置 Web UI,支持多租户、多会话。适用对象是希望先快速做出智能体原型、再把它部署成服务的开发者。模型侧支持 OpenAI、Anthropic、Gemini、DashScope、DeepSeek、Moonshot、Volcengine、xAI、Ollama 等;工具可以来自 Python 函数、MCP 服务器或技能包。
近期加入的能力包括把多步任务写成 SOP、leader–worker 模式的 TeamPipeline、基于 WebRTC 的实时语音智能体、声音克隆、模型路由中间件,以及飞书、Discord 等 IM 渠道接入。完整概念可查看文档。
快速使用
环境要求:Python 3.11 及以上。从 PyPI 安装:
uv pip install agentscope
也可以从源码以可编辑模式安装:
git clone -b main https://github.com/agentscope-ai/agentscope.git
cd agentscope
uv pip install -e .
设置 DASHSCOPE_API_KEY 后,在终端运行一个最小智能体:
from agentscope.agent import Agent
from agentscope.console import launch_console
from agentscope.tool import Toolkit, Bash, Grep, Glob, Read, Write, Edit
from agentscope.credential import DashScopeCredential
from agentscope.model import DashScopeChatModel
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()]),
)
await launch_console(agent)
asyncio.run(main())
launch_console 会处理流式输出、工具调用确认和 Ctrl+C 中断。示例使用 DashScope 和 qwen3.6-plus 模型,可换成其他模型适配器。
要运行智能体服务,在 examples/agent_service 下用 python main.py 启动后端,再到 examples/web_ui 下执行 pnpm install 和 pnpm dev 启动 Web UI。服务后端需要按其自身配置提供模型凭据。
使用约束
框架要求 Python 3.11+。智能体服务由 FastAPI 后端和 pnpm 前端组成,跑完整栈需要同时具备 Python 和 Node 工具链。工具执行可放在本地、Docker、Apple Container、Bubblewrap、E2B、OpenSandbox、Daytona、Kubernetes 等沙箱中,具体可用哪些取决于运行环境。权限与人工确认机制允许逐次确认工具调用,也允许 bypass 模式;bypass 模式下智能体执行工具不再暂停,选择时需要明确意识到这一点。记忆后端可以切换(ReMe、Mem0)。项目采用 Apache-2.0 许可证,相关研究见 AgentScope 1.0 论文和更早的多智能体平台论文。
HotRepo 点评
2026-11-19 的 Python 日榜记录显示,AgentScope 为 36,293 Star、3,891 Fork,当天新增 75 Star,在该语言榜上的最好名次为第 21 名。这只是单日快照,不构成长期趋势,因此只能说明它在 Python 侧当天有持续关注度,不能据此判断更长时间的增长。快照期更值得注意的技术信号是覆盖范围:同一个代码库既提供底层智能体 SDK,又提供可部署的多租户服务、实时语音和团队编排,适合希望从脚本原型直接走到托管智能体应用、而不想中途更换框架的开发者。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
Hacker News 讨论
相关推荐
- agentscope-ai/agentscope-java面向 Java 的智能体框架,让长时间运行、分布式的 Agent 具备权限控制、事件流与持久记忆。
- bojieli/ai-agent-book一本免费开源的 AI Agent 原理与工程书,含全书正文、PDF/EPUB 与 109 个按章实验。
- AstrBotDevs/AstrBot一个可自托管的机器人框架,把大模型智能体接入现有聊天平台,带插件和沙箱。
- pinganbbOvO/ai-companion-kit给 QQ 聊天机器人加持久记忆、拟人回复和安卓手机控制能力的一套独立可拆包工具。
- QwenAudio/qwen-audio-agent为 AI Agent 提供实时语音运行时,让它在把任务交给后端 Agent 时仍能持续对话。