ms-agent

几行代码让 AI 自己拆任务、调工具、出结果

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4410

维护状态较活跃

是否开源是

定价模式 free

项目预览

项目数据

分类开发框架

开发团队modelscope

所属国家

官网地址

GitHubhttps://github.com/modelscope/ms-agent

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agentic-insight,agentic-search,chat-bot,code-generation,deep-research,memory

GitHub 星标★ 4410

30天Star增速

HF 下载量

上线时间2023-08-03 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-13

浏览次数0

项目介绍

MS-Agent 是一个轻量级 Python 框架，用于让 AI 智能体自主执行复杂任务。它把任务拆解、工具调用、代码生成、搜索与记忆等能力封装成可复用的组件，开发者无需从零搭建调度逻辑，就能构建能规划、能动手、能反思的 agent 应用。框架内置 agentic-insight、agentic-search、deep-research、code-generation、memory 等模块，支持聊天机器人、深度研究、代码自动生成等场景。相比重型编排平台，它强调轻量与灵活，适合快速验证 agent 想法并嵌入现有系统。核心价值在于降低 agentic 执行的门槛：用少量代码即可让模型自主分解目标、调用工具、维护上下文并产出结果，同时保留对流程的控制权，便于二次开发和集成到生产环境。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

Python 3.12 及以上（安装全部运行时扩展 [all] 需要）
pip 与 git 可用
ModelScope 访问令牌（API Key），新终端或 .env 中需重新设置
可访问 GitHub 与 ModelScope 的网络环境

安装与启动步骤

1克隆项目源码

README 建议从源码安装以获得最新 WebUI、TUI 和完整扩展，而不是直接用旧版 PyPI 包。下载后进入项目根目录。
```
git clone https://github.com/modelscope/ms-agent.git
cd ms-agent
```
2准备 Python 环境

创建并激活 Python 3.12+ 虚拟环境；每打开一个新终端都要重新激活环境。
```
python3.12 -m venv .venv
source .venv/bin/activate
```
3安装全部依赖

安装包含 WebUI 在内的所有运行时扩展。macOS 默认 zsh 会把方括号当通配符，必须保留单引号。
```
pip install -e '.[all]'
```
4获取并配置 API Key

到 ModelScope 访问令牌页面获取 API Key，在终端重新设置，或按配置指南保存到 .env 文件中供后续使用。
5启动 WebUI

激活环境后运行该命令启动网页界面，可在浏览器中查看本地项目、会话与工具调用过程。终端用户也可改用 TUI/CLI。
```
ms-agent ui
```

如何确认成功

执行 ms-agent ui 后终端出现服务启动信息，浏览器打开其提示的本地地址即可看到 WebUI 界面并开始对话。

常见问题

Q：为什么不直接 pip install ms-agent？

A：PyPI 上的 1.6.0 是旧版本，WebUI 和依赖集较旧，也没有当前 TUI，且不提供 retrieval、cinema 扩展。新环境建议按 README 从源码安装。

Q：macOS 上安装命令报方括号相关错误？

A：macOS 默认 shell 是 zsh，会把 [all] 当成文件名通配符，因此命令里必须写成 pip install -e '.[all]'，保留单引号。

Q：换一个新终端后命令不可用或模型报错？

A：需要重新激活 Python 虚拟环境，并重新设置 API Key，或提前把 Key 保存到 .env 文件中。

Q：除了 WebUI 还能怎么用？

A：可以在终端用 TUI 聊天、用 CLI 跑单个任务或脚本调用，也可把 Python SDK 集成进自己的应用；定时任务用 ms-agent cron，Agent Hub 用 ms-agent agent。

注意事项

安装全部扩展需要 Python 3.12+，版本过低会失败。
API Key 属于敏感信息，不要写入代码或提交到仓库。
更多安装差异与已知问题参见官方安装指南文档；模型配置、工具与 MCP、Agent Skills 均有对应文档章节。

核心亮点

内置任务拆解、工具调用、记忆等模块，开箱即用，省去自建调度逻辑
覆盖深度研究、代码生成、搜索、聊天等场景，一个框架多用途
Python 实现、轻量设计，易于嵌入现有系统并二次开发

不足之处

项目处于成长阶段，文档和示例丰富度可能不足
生态与第三方工具集成数量相比成熟框架仍有差距

适用场景

快速搭建能自主搜索并撰写研究报告的深度研究助手
为现有产品加入可调用工具、生成代码的智能体能力
构建带长期记忆的多轮任务型聊天机器人

替代项目

LangChain、AutoGen

上一篇：eve

下一篇：Agents.jl