ok Merge branch 'main' of github.com:modelscope/ms-agent into release/1.1

Author: wangxingjun778

conf.yaml

@@ -7,8 +7,8 @@
 from ms_agent.tools.search.serpapi import SerpApiSearch
 
 
-def get_search_config():
-    config = load_base_config('conf.yaml')
+def get_search_config(config_file: str):
+    config = load_base_config(config_file)
     search_config = config.get('SEARCH_ENGINE', {})
     return search_config
 
@@ -75,14 +75,14 @@ def replace_env_vars(value: str) -> str:
     return value
 
 
-def get_web_search_tool():
+def get_web_search_tool(config_file: str):
     """
     Get the web search tool based on the configuration.
 
     Returns:
         SearchEngine: An instance of the SearchEngine class configured with the API key.
     """
-    search_config = get_search_config()
+    search_config = get_search_config(config_file=config_file)
 
     if search_config.get('engine', '') == SearchEngineType.EXA.value:
         return ExaSearch(

ms_agent/tools/search_engine.py

@@ -73,7 +73,6 @@ SEARCH_ENGINE:
 #### Python Example
 
 ```python
-
 from ms_agent.llm.openai import OpenAIChat
 from ms_agent.tools.search.search_base import SearchEngine
 from ms_agent.tools.search_engine import get_web_search_tool
@@ -97,20 +96,27 @@ def run_workflow(user_prompt: str, task_dir: str, reuse: bool,
 
 if __name__ == '__main__':
 
-    query: str = 'Survey of the Deep Research on the AI Agent within the recent 3 month, including the latest research papers, open-source projects, and industry applications.'  # noqa
+    query: str = 'Survey of the AI Agent within the recent 3 month, including the latest research papers, open-source projects, and industry applications.'  # noqa
     task_workdir: str = '/path/to/your_task_dir'
     reuse: bool = False
 
     # Get chat client OpenAI compatible api
+    # Free API Inference Calls - Every registered ModelScope user receives a set number of free API inference calls daily, refer to https://modelscope.cn/docs/model-service/API-Inference/intro for details.  # noqa
+    """
+    * `api_key` (str), your API key, replace `xxx-xxx` with your actual key. Alternatively, you can use ModelScope API key, refer to https://modelscope.cn/my/myaccesstoken  # noqa
+    * `base_url`: (str), the base URL for API requests, `https://api-inference.modelscope.cn/v1/` for ModelScope API-Inference
+    * `model`: (str), the model ID for inference, `Qwen/Qwen3-235B-A22B-Instruct-2507` can be recommended for document research tasks.
+    """
     chat_client = OpenAIChat(
-        api_key='sk-xxx',
-        base_url='https://your_base_url',
-        model='gemini-2.5-pro',
+        api_key='xxx-xxx',
+        base_url='https://api-inference.modelscope.cn/v1/',
+        model='Qwen/Qwen3-235B-A22B-Instruct-2507',
     )
 
     # Get web-search engine client
     # For the ExaSearch, you can get your API key from https://exa.ai
-    search_engine = get_web_search_tool()
+    # Please specify your config file path, the default is `conf.yaml` in the current directory.
+    search_engine = get_web_search_tool(config_file='conf.yaml')
 
     run_workflow(
         user_prompt=query,

projects/deep_research/README.md

@@ -0,0 +1,12 @@
+#Search Engine, Supported values: EXA, SERPAPI, ARXIV
+#SEARCH_ENGINE:
+#  engine: exa
+#  exa_api_key: $EXA_API_KEY
+
+#SEARCH_ENGINE:
+#  engine: serpapi
+#  serpapi_api_key: $SERPAPI_API_KEY
+#  provider: google
+
+SEARCH_ENGINE:
+  engine: arxiv

projects/deep_research/conf.yaml

@@ -23,20 +23,27 @@ def run_workflow(user_prompt: str, task_dir: str, reuse: bool,
 
 if __name__ == '__main__':
 
-    query: str = 'Survey of the Deep Research on the AI Agent within the recent 3 month, including the latest research papers, open-source projects, and industry applications.'  # noqa
+    query: str = 'Survey of the AI Agent within the recent 3 month, including the latest research papers, open-source projects, and industry applications.'  # noqa
     task_workdir: str = '/path/to/your_task_dir'
     reuse: bool = False
 
     # Get chat client OpenAI compatible api
+    # Free API Inference Calls - Every registered ModelScope user receives a set number of free API inference calls daily, refer to https://modelscope.cn/docs/model-service/API-Inference/intro for details.  # noqa
+    """
+    * `api_key` (str), your API key, replace `xxx-xxx` with your actual key. Alternatively, you can use ModelScope API key, refer to https://modelscope.cn/my/myaccesstoken  # noqa
+    * `base_url`: (str), the base URL for API requests, `https://api-inference.modelscope.cn/v1/` for ModelScope API-Inference
+    * `model`: (str), the model ID for inference, `Qwen/Qwen3-235B-A22B-Instruct-2507` can be recommended for document research tasks.
+    """
     chat_client = OpenAIChat(
-        api_key='sk-xxx',
-        base_url='https://your_base_url',
-        model='gemini-2.5-pro',
+        api_key='xxx-xxx',
+        base_url='https://api-inference.modelscope.cn/v1/',
+        model='Qwen/Qwen3-235B-A22B-Instruct-2507',
     )
 
     # Get web-search engine client
     # For the ExaSearch, you can get your API key from https://exa.ai
-    search_engine = get_web_search_tool()
+    # Please specify your config file path, the default is `conf.yaml` in the current directory.
+    search_engine = get_web_search_tool(config_file='conf.yaml')
 
     run_workflow(
         user_prompt=query,