帮你快速理解、总结文档立即下载

配置改写

最近更新时间:2026-06-11 20:38:32

我的收藏

操作场景

当您使用 HTTP 转 MCP 方式将已有的 RESTful 接口封装为 MCP 工具时,工具对外暴露的参数结构与后端接口的实际报文格式往往并不一致。通过 报文动态调整 功能,您可以在不改动后端服务的前提下,对工具的请求参数和响应内容进行重命名、定位、固定注入和模板化改写,使 MCP 工具的输入输出更符合大模型调用习惯。

前提条件

已创建云原生 AI 网关实例。
已创建 HTTP 转 MCP 类型的 MCP Server 及其工具。

操作步骤

1. 登录 微服务平台控制台 ,在左侧导航栏单击 云原生智能网关 > 实例列表
2. 在实例列表页面,单击需要配置的网关实例的"ID",进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 MCP 管理,在服务列表中单击目标 HTTP 转 MCP 服务的 ID/名称,进入服务详情页。
4. 在服务详情页顶部单击 Tools 管理 页签,在 Tools 列表页面选择目标 Tool 后进入到 Tool 基本信息页面。
5. 在 tool 详情页面选择「参数改写」tab 页面后,单击配置参数改写
请求参数改写:
参数重命名:为对外参数设置映射到后端的真实字段名(后端字段名)。
参数位置(Position):指定参数在后端请求中的位置(如 Query、Header、Body 等)。
固定注入字段(InjectFields):为后端请求注入固定值字段(如固定的鉴权头、渠道标识等)。
响应模版改写:
响应模板(Response Body):使用 GJSON 语法从后端响应中提取并重组返回内容。
错误响应模板:自定义错误场景下返回给客户端的内容。
6. 单击 保存 使配置生效。

相关说明

配置时请遵守以下限制:
配置项
取值范围 / 限制
工具参数数量
≤ 20 个
标签键长度
≤ 128 字符
标签值长度
≤ 4096 字符
请求 Body 模板长度
≤ 16384 字符
响应 Body 模板长度
≤ 16384 字符
错误响应模板长度
≤ 2048 字符
响应模板采用 GJSON 语法提取字段,配置后建议在调试中验证输出是否符合预期。