外部调用

集成至第三方应用

阿里云百炼支持配置 MCP 服务至 Cherry Studio 和 Cursor，支持自动配置和手动配置。以 Amap Maps 服务为例。

通过 SDK 进行开发集成

通过 MCP SDK 调用阿里云百炼 MCP 服务，编码更加灵活。

以下是一个基于 Qwen Agent 框架、调用 Amap Maps MCP 服务的智能体应用实例，支持查询杭州市天气。

1. 安装 Qwen Agent 框架。

   pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"

2. 配置百炼 API Key 到环境变量 。

3. 新建文件hangzhou_weather.py，代码实例如下：

   Python

   # -*- coding: utf-8 -*-
   # 使用amap-maps工具查询杭州天气
   
   import os
   from qwen_agent.agents import Assistant
   
   
   def query_hangzhou_weather():
       """查询杭州今日天气"""
       # 检查环境变量
       api_key = os.getenv('DASHSCOPE_API_KEY')
       if not api_key:
           print("错误：请设置环境变量 DASHSCOPE_API_KEY")
           print("例如：export DASHSCOPE_API_KEY=your_api_key")
           return
       
       llm_cfg = {'model': 'qwen-max'}
       system = (
           '你是一个天气查询智能体。你将调用名为 阿里云百炼_Amap Maps 的 MCP 服务来查询天气信息。'
           '请优先调用工具获取结构化的天气数据，并对天气情况做简明解释。'
       )
       
       # 配置MCP工具
       tools = [{
           "mcpServers": {
               "阿里云百炼_Amap Maps": {
                   "command": "npx",
                   "args": [
                       "mcp-remote",
                       "https://dashscope.aliyuncs.com/api/v1/mcps/amap-maps/sse",
                       "--header",
                       "Authorization:${AUTH_HEADER}"
                   ],
                   "env": {
                       "AUTH_HEADER": f"Bearer {api_key}"
                   }
               }
           }
       }]
       
       # 创建智能体
       bot = Assistant(
           llm=llm_cfg,
           name='天气查询智能体',
           description='天气信息查询',
           system_message=system,
           function_list=tools,
       )
   
       # 查询杭州天气
       messages = []
       query = "查询杭州今日的天气情况"
       messages.append({'role': 'user', 'content': query})
   
       print("正在查询杭州今日天气...")
       print("=" * 50)
       
       # 执行查询并收集所有响应
       all_responses = []
       for response in bot.run(messages):
           all_responses.append(response)
       
       # 提取最终的assistant回复内容
       final_content = ""
       if all_responses:
           last_response = all_responses[-1]
           if isinstance(last_response, list):
               for item in last_response:
                   if isinstance(item, dict) and item.get('role') == 'assistant' and 'content' in item:
                       final_content = item['content']
           elif isinstance(last_response, dict) and 'content' in last_response:
               final_content = last_response['content']
       
       # 输出最终结果
       if final_content:
           print(final_content)
       else:
           print("未能获取到天气信息")
   
   
   if __name__ == '__main__':
       query_hangzhou_weather()
   

4. 运行代码，结果如下：

   

   运行代码时，若提示npx不是内部或外部命令，请先安装Node.js。