Skip to content

Commit f9b8851

Browse files
ok Merge branch 'main' of github.com:modelscope/ms-agent into release/1.5
2 parents f9b7175 + 6be931b commit f9b8851

File tree

124 files changed

+8006
-1314
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

124 files changed

+8006
-1314
lines changed

README.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -60,14 +60,17 @@ MS-Agent is a lightweight framework designed to empower agents with autonomous e
6060
- Support financial data collection via [Akshare](https://github.com/akfamily/akshare) and [Baostock](http://baostock.com/mainContent?file=home.md)
6161
- Support DagWorkflow for workflow orchestration
6262
- Optimize the DeepResearch workflow for stability and efficiency
63+
- FinResearch official documentation: [FinResearch Doc](https://ms-agent-en.readthedocs.io/en/latest/Projects/FinResearch.html)
64+
- DEMO: [FinResearchStudio](https://modelscope.cn/studios/ms-agent/FinResearch)
65+
- Examples: [FinResearchExamples](https://www.modelscope.cn/models/ms-agent/fin_research_examples)
6366

6467
* 🚀 Nov 07, 2025: Release MS-Agent v1.4.0, which includes the following updates:
6568
- 🔥 We present [**MS-Agent Skills**](projects/agent_skills/README.md), an **Implementation** of [Anthropic-Agent-Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) Protocol.
6669
- 🔥 Add [Docs](https://ms-agent-en.readthedocs.io/en) and [中文文档](https://ms-agent.readthedocs.io/zh-cn)
6770
- 🔥 Support Sandbox Framework [ms-enclave](https://github.com/modelscope/ms-enclave)
6871

6972
* 🚀 Sep 22, 2025: Release MS-Agent v1.3.0, which includes the following updates:
70-
- 🔥 Support [Code Scratch](projects/code_scratch/README.md)
73+
- 🔥 Support [Code Scratch](projects/code_genesis/README.md)
7174
- Support `Memory` for building agents with long-term and short-term memory
7275
- Enhance the DeepResearch workflow
7376
- Support RAY for accelerating document information extraction
@@ -408,7 +411,7 @@ This project provides a framework for **Code Scratch**, enabling agents to auton
408411
Generate a complete ai workspace homepage with the following command:
409412
410413
```shell
411-
PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_agent/cli/cli.py run --config projects/code_scratch --query 'Build a comprehensive AI workspace homepage' --trust_remote_code true
414+
PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_agent/cli/cli.py run --config projects/code_genesis --query 'Build a comprehensive AI workspace homepage' --trust_remote_code true
412415
```
413416
414417
The generated code will be output to the `output` folder in the current directory.
@@ -418,7 +421,7 @@ The generated code will be output to the `output` folder in the current director
418421
- **Coding Phase**: Execute coding tasks in intelligent file groups → Generate complete code structure
419422
- **Refine Phase**: Auto-compilation → Error analysis → Iterative bug fixing → Human evaluation loop
420423
421-
For more details, refer to [Code Scratch](projects/code_scratch/README.md).
424+
For more details, refer to [Code Scratch](projects/code_genesis/README.md).
422425
423426
<br>
424427
@@ -523,7 +526,7 @@ OPENAI_API_KEY=xxx-xxx T2I_API_KEY=ms-xxx-xxx MANIM_TEST_API_KEY=xxx-xxx ms-agen
523526
524527
#### References
525528
526-
- [Complete Documentation](./docs/zh/Projects/短视频生成.md)
529+
- [Complete Documentation](./docs/zh/Projects/video-generation)
527530
528531
529532
<br>
@@ -546,7 +549,7 @@ We are committed to continuously improving and expanding the MS-Agent framework
546549
- [ ] Improve stabilises
547550
- [ ] **Multimodal Agentic Search** – Supporting large-scale multimodal document retrieval and generation of search results combining text and images.
548551
- [ ] Enhanced **Agent Skills** – Providing a richer set of predefined skills and tools to expand agent capabilities and enabling multi-skill collaboration for complex task execution.
549-
- [ ] **Agent-Workstation** - An unified WebUI with one-click local deployment support with combining all agent capabilities of MS-Agent, such as AgentChat, MCP, AgentSkills, DeepResearch, DocResearch, CodeScratch, etc.
552+
- [ ] **Agent-Workstation** - An unified WebUI with one-click local deployment support with combining all agent capabilities of MS-Agent, such as AgentChat, MCP, AgentSkills, DeepResearch, DocResearch, CodeGenesis, etc.
550553
551554
552555
## License

README_ZH.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -58,14 +58,17 @@ MS-Agent是一个轻量级框架,旨在为智能体提供自主探索能力。
5858
- 支持基于[Akshare](https://github.com/akfamily/akshare)[Baostock](http://baostock.com/mainContent?file=home.md)的金融数据获取工具
5959
- 支持以Dag形式编排工作流
6060
- 优化DeepResearch稳定性与效率
61+
- 官方文档: [金融深度研究](https://ms-agent.readthedocs.io/zh-cn/latest/Projects/fin-research.html)
62+
- 魔搭创空间DEMO: [FinResearchStudio](https://modelscope.cn/studios/ms-agent/FinResearch)
63+
- 报告样例: [FinResearchExamples](https://www.modelscope.cn/models/ms-agent/fin_research_examples)
6164

6265
* 🚀 2025.11.07:发布MS-Agent v1.4.0,包含以下更新:
6366
- 🔥 新增 [**MS-Agent Skills**](projects/agent_skills/README.md), 基于 [**Anthropic-Agent-Skills**](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) 协议实现.
6467
- 🔥 新增 [中文文档](https://ms-agent.readthedocs.io/zh-cn)[英文文档](https://ms-agent-en.readthedocs.io/en)
6568
- 🔥 支持沙箱框架 [ms-enclave](https://github.com/modelscope/ms-enclave)
6669

6770
* 🚀 2025.9.22:发布MS-Agent v1.3.0,包含以下更新:
68-
- 🔥 支持[Code Scratch](projects/code_scratch/README.md)
71+
- 🔥 支持[Code Scratch](projects/code_genesis/README.md)
6972
- 支持`Memory`用于构建具有长期和短期记忆的智能体
7073
- 增强DeepResearch工作流
7174
- 支持RAY加速文档信息提取
@@ -404,7 +407,7 @@ pip install ms-agent
404407
使用以下命令生成完整的 AI 工作空间主页:
405408

406409
```shell
407-
PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_agent/cli/cli.py run --config projects/code_scratch --query 'Build a comprehensive AI workspace homepage' --trust_remote_code true
410+
PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_agent/cli/cli.py run --config projects/code_genesis --query 'Build a comprehensive AI workspace homepage' --trust_remote_code true
408411
```
409412

410413
生成的代码将输出到当前目录的 `output` 文件夹中。
@@ -414,7 +417,7 @@ PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_
414417
- **编码阶段**:在智能文件组中执行编码任务 → 生成完整的代码结构
415418
- **完善阶段**:自动编译 → 错误分析 → 迭代错误修复 → 人工评估循环
416419

417-
更多详情,请参考 [Code Scratch](projects/code_scratch/README.md)
420+
更多详情,请参考 [Code Scratch](projects/code_genesis/README.md)
418421

419422
<br>
420423

@@ -521,7 +524,7 @@ OPENAI_API_KEY=xxx-xxx T2I_API_KEY=ms-xxx-xxx MANIM_TEST_API_KEY=xxx-xxx ms-agen
521524

522525
#### 3) 参考文档
523526

524-
- [完整文档](./docs/zh/Projects/短视频生成.md)
527+
- [完整文档](./docs/zh/Projects/video-generation)
525528

526529
<br>
527530

@@ -543,7 +546,7 @@ OPENAI_API_KEY=xxx-xxx T2I_API_KEY=ms-xxx-xxx MANIM_TEST_API_KEY=xxx-xxx ms-agen
543546
- [ ] 提升稳定度
544547
- [ ] 多模态检索增强生成 **Multimodal Agentic Search** - 支持大规模多模态文档检索和图文检索结果生成。
545548
- [ ] 增强的 **Agent Skills** - 提供更多预定义的技能和工具,提升智能体技能边界,并支持多技能协作,完成复杂任务执行。
546-
- [ ] 统一的WebUI **Agent-Workstation**,支持本地一键部署,集成了 MS-Agent 的所有智能体能力,如 AgentChat、MCP、AgentSkills、DeepResearch、DocResearch、CodeScratch 等。
549+
- [ ] 统一的WebUI **Agent-Workstation**,支持本地一键部署,集成了 MS-Agent 的所有智能体能力,如 AgentChat、MCP、AgentSkills、DeepResearch、DocResearch、CodeGenesis 等。
547550

548551

549552
## 许可证

docs/en/Components/Config.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
slug: Config
3+
title: Config & Parameters
4+
description: Ms-Agent Configuration & Parameters
5+
---
6+
17
# Config
28

39
MS-Agent uses a yaml file for configuration management, typically named `agent.yaml`, which allows different scenarios to read different configuration files. The specific fields contained in this file are:
@@ -98,7 +104,7 @@ tools:
98104
- map_geo
99105
```
100106
101-
For the complete list of supported tools and custom tools, please refer to [here](./工具.md)
107+
For the complete list of supported tools and custom tools, please refer to [here](./Tools.md)
102108
103109
## Others
104110

docs/en/Components/ContributorGuide.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
slug: ContributorGuide
3+
title: Contributor Guide
4+
description: Ms-Agent Contributor Guide
5+
---
6+
17
# Contributor Guide
28

39
## Workflow Contribution

docs/en/Components/LLMAgent.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
slug: LLMAgent
3+
title: LLMAgent for basic usage
4+
description: Ms-Agent LLMAgent for basic usage
5+
---
6+
17
# LLM Agent
28

39
The basic agent class in MS-Agent is [LLMAgent](https://github.com/modelscope/ms-agent/blob/main/ms_agent/agent/llm_agent.py). MS-Agent's conversational capabilities and tool invocation are all handled through this class. The diagram is as follows:
@@ -81,4 +87,4 @@ In this case, agent.yaml will use your custom agent class instead of loading the
8187

8288
1. A basic agent.yaml: https://www.modelscope.cn/models/ms-agent/simple_agent
8389
2. Agent with external code: https://www.modelscope.cn/models/ms-agent/simple_agent_code
84-
3. Using callbacks to complete complex workflows: https://github.com/modelscope/ms-agent/tree/main/projects/code_scratch
90+
3. Using callbacks to complete complex workflows: https://github.com/modelscope/ms-agent/tree/main/projects/code_genesis

docs/en/Components/SupportedModels.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
slug: SupportedModels
3+
title: Supported Models
4+
description: Ms-Agent Supported Models
5+
---
6+
17
# Supported Models
28

39
MS-Agent supports large model APIs with the standard OpenAI interface. In addition, to facilitate usage by different model providers, it also provides distinct configuration keys in YAML.

docs/en/Components/Tools.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
slug: Tools
3+
title: Tools
4+
description: Ms-Agent Tools
5+
---
6+
17
# Tools
28

39
## Tool List
@@ -145,7 +151,7 @@ ms-agent run --config xxx/xxx --mcp_server_file ./mcp.json
145151

146152
### Configuring yaml file
147153

148-
Additional tools can be added in tools within yaml. Refer to [Configuration and Parameters](./Config.md#Tool%20Configuration)
154+
Additional tools can be added in tools within yaml. Refer to [Configuration and Parameters](./Config.md) for details.
149155

150156
### Writing new tools
151157

@@ -207,12 +213,7 @@ class CustomTool(ToolBase):
207213
}),
208214
]
209215
}
210-
return {
211-
'custom_tool': [
212-
t for t in tools['custom_tool']
213-
if t['tool_name'] not in self.exclude_functions
214-
]
215-
}
216+
return tools
216217

217218
async def foo(self, foo_arg1) -> str:
218219
...

docs/en/Components/Workflow.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,14 @@
1+
---
2+
slug: Workflow
3+
title: Workflow
4+
description: Ms-Agent Workflow
5+
---
6+
17
# Workflow
28

39
MS-Agent supports workflow execution. Workflows are also configured by yaml files. Workflows are composed of different Agents to complete more complex tasks. Currently, MS-Agent's workflow supports two types of Agents:
410

5-
- LLMAgent: This Agent is introduced in [Basic Agent](./Basic%20Agent.md), which is a basic Agent loop that integrates LLM reasoning
11+
- LLMAgent: This Agent is introduced in [Basic Agent](./LLMAgent.md), which is a basic Agent loop that integrates LLM reasoning
612
- CodeAgent: Contains only a run method, which is a pure code execution process that can provide custom code implementation
713

814
## ChainWorkFlow

docs/en/GetStarted/Installation.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
---
2+
slug: Installation
3+
title: Installation
4+
description: Ms-Agent Installation Guide
5+
---
6+
17
# Installation
28

39
## Wheel Package Installation
@@ -18,7 +24,7 @@ cd ms-agent
1824
pip install -e .
1925
```
2026

21-
If using DeepResearch or CodeScratch, there may be additional dependencies. Please install according to the corresponding README documentation.
27+
If using DeepResearch or CodeGenesis, there may be additional dependencies. Please install according to the corresponding README documentation.
2228

2329
## Images
2430

docs/en/GetStarted/Introduction.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,17 @@
1+
---
2+
slug: Introduction
3+
title: Introduction
4+
description: Ms-Agent Introduction
5+
---
6+
17
# Quick Start
28

39
MS-Agent is the official Agent framework launched by the ModelScope community. This framework is committed to using a clear and simple universal capability framework to solve proprietary problems in several domains.
410

511
Currently, the domains we are exploring include:
612

713
- DeepResearch: Generate in-depth research reports in the scientific research field
8-
- CodeScratch: Generate runnable software project code from requirements
14+
- CodeGenesis: Generate runnable software project code from requirements
915
- General domain: MS-Agent adapts to general LLM conversation scenarios and is compatible with MCP tool calling
1016

1117
MS-Agent is also the backend agent framework for [mcp-playground](https://modelscope.cn/mcp/playground) on the ModelScope official website. If developers are interested in the above domains, or hope to learn Agent technology principles and conduct secondary development, welcome to use MS-Agent.
@@ -56,4 +62,4 @@ The above two examples have the same effect and both can conduct multi-turn conv
5662

5763
- A [more comprehensive example](https://github.com/modelscope/ms-agent/tree/main/examples)
5864
- DeepResearch [example](https://github.com/modelscope/ms-agent/tree/main/projects/deep_research)
59-
- CodeScratch [example](https://github.com/modelscope/ms-agent/blob/main/projects/code_scratch/README.md)
65+
- CodeGenesis [example](https://github.com/modelscope/ms-agent/blob/main/projects/code_genesis/README.md)

0 commit comments

Comments
 (0)