
如何在 Apifox 中发布多语言的 API 文档?
模型上下文协议(Model Context Protocol, MCP)旨在搭建大模型和外部工具之间的信息传递通道。通过 MCP 协议,开发者不用为每个外部工具编写复杂的接口,百炼应用也能够接入海量第三方工具。
现在,百炼智能体和工作流应用已支持接入两种 MCP 服务。使用 MCP 服务的详细方法,请参考快速入门。
根据是否收取部署费用,有以下两种计费模式:
您可以开通百炼预置的 MCP 服务,也可以部署其他来源的 MCP 服务,并在智能体和工作流应用中使用这些 MCP 服务。
开通后,您可以使用百炼预置的 MCP 服务。以“开通 Amap Maps MCP 服务”为例:
您可以通过百炼智能体应用和工作流应用使用 MCP 服务。
在智能体应用中,大模型会根据用户的问题,智能判断是否调用 MCP 服务。
说明:DeepSeek、QwQ 系列模型不支持使用 MCP 服务。
前往百炼应用管理,打开一个智能体应用。
您可以同时添加至多 5 个 MCP 服务,智能体将根据用户需求调用合适的 MCP 服务。
以下是几个常见的 MCP 服务使用场景,供您参考。
路程规划逐步思考气温趋势
请确认已添加 Amap Maps MCP 服务,帮助智能体获取地理信息。
在右侧对话窗格中发送一条测试消息:“现在出发,从杭州萧山国际机场到杭州西湖景区。请你提供三种公共交通出行方案”。您将看到智能体多次调用 MCP 服务,完成路径规划和时间估算。
MCP 服务可能有多个工具。在工作流应用中,每个 MCP 节点只能使用一个工具。您需要手动指定 MCP 节点的输入参数,再传递输出参数到下一个节点。
使用“Amap Maps”MCP 服务的“maps_weather”工具,您可以快速构建一个城市天气查询工作流。
为了快速构建工作流,示例工作流无法回答与天气查询无关的问题。
前往百炼应用管理,新建一个对话型工作流应用。
删除开始节点的两个默认参数。
说明:这一步将用户的自然语言解析为 MCP 节点需要的城市名称。
从左侧工具栏中拖入一个大模型节点,命名为“信息提取”。请将此节点连接到开始节点,并按照指引填写参数。
除以下参数外,其他参数保持默认即可:
参数名 | 参数值 |
模型配置 | 通义千问-Max |
System Prompt | 你是一个信息提取专家,你的任务是帮助“查询天气工具”解析正确的输入参数。—“查询天气工具”的描述如下:名称:maps_weather描述:根据城市名称或者标准adcode查询指定城市的天气输入参数:city [string] 城市名称或者adcode输出参数:result [string] 城市的天气预报—你的输出是“查询天气工具”的输入,你只需要输出城市的名称即可。注意:你一次只能输出一个城市。 |
User Prompt | 参数名 参数值 模型配置 通义千问-Max System Prompt 你是一个信息提取专家,你的任务是帮助“查询天气工具”解析正确的输入参数。—“查询天气工具”的描述如下:名称:maps_weather描述:根据城市名称或者标准adcode查询指定城市的天气输入参数:city [string] 城市名称或者adcode输出参数:result [string] 城市的天气预报—你的输出是“查询天气工具”的输入,你只需要输出城市的名称即可。注意:你一次只能输出一个城市。 User Prompt |
说明:使用 MCP 节点前,您通常需要将用户的自然语言转换为 MCP 节点的输入参数。因此,您需要在 System Prompt 里描述 MCP 服务的功能和输入输出信息,限定大模型的输出格式。
使用高德 MCP 服务提供的天气查询工具,接收一个城市名,返回该城市的天气信息。
从左侧工具栏中拖入一个 MCP 节点,按照图示选择 maps_weather 工具,确认节点配置。
请将 MCP 节点命名为“天气查询工具”,然后将此节点连接到“信息提取”节点。
说明:点击节点左上角的箭头按钮,即可展开或收起节点配置。
点击 MCP 节点内 maps_weather 工具的配置按钮,修改输入为“引用:信息提取/result”。
说明:将 MCP 服务返回的结果整理成自然语言,方便用户阅读。
从左侧工具栏中拖入一个大模型节点,命名为“信息总结”。请将此节点连接到“天气查询工具”节点,并按照指引填写参数。
除以下参数外,其他参数保持默认即可:
参数名 | 参数值 |
模型配置 | 通义千问-Max |
System Prompt | 你是一个信息处理助手,你的任务是将用户输入的信息整合为自然语言。 |
User Prompt | 您需要键入”/”来呼出变量菜单,选中“天气查询工具 > result” |
将结果传递到结束节点后,用户才可以看到天气信息。
请将此节点连接到“信息总结”节点,并按照指引填写参数。
除以下参数外,其他参数保持不变。
参数名 | 参数值 |
输入框 | 键入”/”来呼出变量菜单,选中“信息总结 > result |
点击右上角“测试”按钮,输入“查询杭州天气”,即可看到工作流输出“杭州”的天气信息。
除了百炼预置的 MCP 服务外,您还可以部署开源社区和其他来源的自定义 MCP 服务。百炼会将您的自定义 MCP 服务部署至阿里云函数计算 FC。
以部署开源社区的 Knowledge Graph Memory MCP 服务为例:
1、创建 MCP 服务
前往MCP 管理,点击创建 MCP 服务。
2、配置 MCP 服务
按照以下指引填写配置,确认无误后提交部署。
服务名称和描述:填写 MCP 服务的名称和功能简介。
安装方式:当前仅支持 npx。
说明:npx 是一个随 npm 一起安装的工具,用于快速执行 npm 包中的命令行工具或可执行文件,它允许在不全局安装包的情况下直接运行命令 ,从而简化了项目内部模块的使用流程。
部署方式:学习和测试 MCP 服务时,建议选择“按次付费”。详细计费规则请参考计费说明。
部署地域:选择 MCP 服务的部署位置。推荐与您其他云服务保持在同一地域,以优化性能。若不确定如何选择,可选用“北京”地域。
MCP 服务配置:您可以直接使用以下配置代码。
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}
说明:通常情况下,MCP 服务提供商会提供详细的配置代码,粘贴至此处即可。以Knowledge Graph Memory MCP 服务为例,您可以在MCP 广场找到这个 MCP 服务,单击进入详情页,找到标题为 NPX
的配置代码。
3、使用 MCP 服务
部署完成后,您可以将自定义 MCP 服务接入智能体应用和工作流应用。
MCP 最先由 Anthropic 提出,是一个开源、标准的协议。MCP 的详细介绍和具体实现,请参考 MCP 官网。
百炼支持部署自定义 MCP 服务,目前仅支持 npx 的安装方式,未来会支持 uvx 和 SSE 的安装方式。详细部署方法请参考快速入门。
目前仅支持接入百炼应用,暂不支持在其他 MCP 客户端使用。
目前暂不支持访问用户本地资源(例如本地数据库)。
智能体编排应用暂不支持 MCP 协议。请您通过智能体或工作流应用接入 MCP 服务。
DeepSeek、QwQ 系列模型暂不支持调用 MCP 服务,请尝试使用其他模型。
智能体应用会根据提示词智能判断是否调用 MCP 服务。请先尝试调整提示词,如果问题无法解决,请再尝试更换效果更好的大模型(如通义千问-Max)。
文章转载自:阿里云百炼MCP Server 快速入门