云原生智能网关 配置改写

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

相关产品
云原生智能网关 产品页,含版本规格、价格与购买入口。

一、前提条件

·已创建云原生 AI 网关实例。

·已创建 HTTP 转 MCP 类型的 MCP Server 及其工具。

二、操作步骤

1. 登录 微服务平台控制台 ,在左侧导航栏单击 AI 网关 > 实例列表。

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 语法提取字段,配置后建议在调试中验证输出是否符合预期。

赞 (0)
上一篇 4天前
下一篇 4天前