# agentscope **Repository Path**: future310/agentscope ## Basic Information - **Project Name**: agentscope - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-24 - **Last Updated**: 2026-08-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
## 新闻
- **[2026-08] `功能`:** 支持 Console —— 在终端中测试与调试智能体。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/console) | [文档](https://docs.agentscope.io/latest/zh/building-blocks/console)
- **[2026-08] `集成`:** 支持飞书(Lark)与 Discord 频道。[飞书](https://docs.agentscope.io/latest/zh/deploy/channel/feishu) | [Discord](https://docs.agentscope.io/latest/zh/deploy/channel/discord)
- **[2026-08] `功能`:** 支持消息频道 —— 将智能体接入即时通讯平台。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent_service) | [文档](https://docs.agentscope.io/latest/zh/deploy/channel/overview)
- **[2026-08] `集成`:** 内置集成 GitHub MCP Registry 与 ClawHub。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent_service) | [文档](https://docs.agentscope.io/latest/zh/deploy/hub)
- **[2026-08] `功能`:** 支持 MCP & Skill Hub —— 浏览 hub、安装到个人库、再添加到工作区。[样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent_service) | [文档](https://docs.agentscope.io/latest/zh/deploy/hub)
- **[2026-07] `集成`:** 集成 Daytona 工作区/沙箱实现。 [文档](https://docs.agentscope.io/latest/en/building-blocks/workspace)
- **[2026-07] `集成`:** 集成 K8s,OpenSandbox 工作区/沙箱实现。 [文档](https://docs.agentscope.io/latest/en/building-blocks/workspace)
- **[2026-07] `集成`:** 集成 ReMe 长期记忆。 [样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/long_term_memory/reme) | [文档](https://docs.agentscope.io/latest/zh/building-blocks/long-term-memory)
- **[2026-06] `功能`:** 支持 Agentic Memory。 [样例](https://github.com/agentscope-ai/agentscope/tree/main/examples/long_term_memory/agentic_memory) | [文档](https://docs.agentscope.io/latest/zh/building-blocks/long-term-memory)
- **[2026-06] `功能`:** 支持分布式 & 多租户 & 多会话 RAG 服务。 [文档](https://docs.agentscope.io/latest/en/deploy/agent-team)
[更多新闻 →](./docs/NEWS_zh.md)
## 社区
欢迎加入我们的社区
| [Discord](https://discord.gg/eYMpfnkG8h) | 钉钉 |
|----------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
|
|
|
## 快速开始
### 安装
> AgentScope 需要 **Python 3.11** 或更高版本。
#### 从 PyPI 安装
```bash
uv pip install agentscope
```
#### 从源码安装
```bash
# 从 GitHub 拉取源码
git clone -b main https://github.com/agentscope-ai/agentscope.git
# 以可编辑模式安装
cd agentscope
uv pip install -e .
```
## 智能体(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,在终端中启动你的第一个智能体:
```python
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(),
]
),
)
# 在终端中与智能体对话 —— 流式输出、工具调用确认、
# Ctrl+C 中断均已内置处理
await launch_console(agent)
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) | 定时任务、智能体唤醒、后台任务卸载 |
以上能力皆可组合,你只需少量胶水代码,就能在此服务之上搭建起自己的应用。
智能体团队 —— leader 智能体派生 worker,并通过内置的团队工具进行协调。 |
任务规划 —— 智能体将复杂工作拆解为可追踪的计划,并在执行过程中持续更新。 |
bypass 模式下的权限控制 —— 智能体端到端运行,无需为工具调用确认而暂停。 |
工具后台执行 —— 长时间运行的工具被转入后台;其结果稍后唤醒智能体并恢复对话。 |