modelscope/ms-agent

MS‑Agent – 用于构建自主 AI 代理的轻量级、可扩展框架

是什么 – MS‑Agent 是一个开源的基于 Python 的框架，可让您构建、运行和管理长期运行的多步骤 AI 代理。它提供了一个 框架，协调模型调用、工具执行、权限检查和反馈循环，同时处理上下文压缩、记忆层和调度。相同的代理逻辑可从 Web UI、终端 UI、CLI 或通过共享 SDK 嵌入到其他 Python 应用程序中使用。

核心功能

• 可自定义的框架 – 可插入生命周期回调、钩子和策略检查，以塑造代理的规划、验证和执行步骤的方式。
• 上下文与记忆管理 – 分离的会话、活动上下文和项目级记忆存储；自动修剪和基于 LLM 的摘要可有效控制令牌使用量。
• 自主协作 – 主代理可生成专业子代理或运行 DAG 风格的工作流，为每个角色分配不同的模型、工具和技能。
• 可复用的技能 – 领域特定的流程被封装为 技能，可按需加载。基于执行轨迹的“技能进化”工作流会根据评估结果修订技能。
• 开放生态系统 – 支持多种模型提供商、ModelScope 的 MCP 工具协议、ACP/A2A 集成，以及一个 代理中心，可在本地或远程 ModelScope 仓库之间同步代理、技能和记忆。
• 多模态输入 – 图像、视频及其他模态可输入至代理（v1.6.0）。
• 内置应用 – 提供研究（DeepResearch/Agentic Insight）、代码生成（Code Genesis）、视频创作（Singularity Cinema）、金融分析（FinResearch）、文档研究等即用型流水线。

如何开始

1. 安装 Python SDK（需 Python 3.12+）。该包在 PyPI 上以 ms-agent 名称提供。
2. 选择一个接口：
   • WebUI – 克隆仓库后运行 ms-agent ui；浏览器工作区可让您创建项目、与代理聊天、查看工具活动并编辑文件。
   • TUI / CLI – 使用 ms-agent chat 或 ms-agent run … 进行基于终端的交互或脚本任务。
   • SDK – 在自己的代码中导入 ms_agent，以组装自定义代理、定义技能并程序化调用框架。
3. 在 WebUI 设置 → 模型面板中添加您的 ModelScope（或其他）API 密钥。

典型用例

• 深度研究 – 自主文献搜索、摘要和报告生成（Agentic Insight v2）。
• 软件开发 – 使用 Code Genesis 技能集进行多步骤代码生成、调试和文档编写。
• 内容创作 – 通过 Singularity Cinema 实现视频生成流水线。
• 金融分析 – 从 Akshare/Baostock 收集数据并执行多代理研究工作流。
• 通用 RAG / 知识搜索 – 在本地代码库和文档上集成 Sirchmunk 检索。

文档与社区

• 官方网站： https://modelscope.github.io/ms-agent/
• 文档（英文及中文）： https://ms-agent-en.readthedocs.io
• 支持用 Discord 和 WeChat 群组。
• 项目遵循 Apache-2.0 风格许可（参见 LICENSE）。

为何重要 – 通过抽象工具调用、记忆处理和工作流编排的底层实现，MS‑Agent 让开发者能够专注于代理的 逻辑。其模块化设计、多模态支持和内置应用使其成为研究助手、代码协作者及其他自主 AI 系统的实用基础。