云原生智能网关 服务来源(服务管理)

当需要将已有的注册中心或域名服务中的服务批量接入 AI 网关时,可以通过配置服务来源,实现 服务的自动同步和统一管理。服务来源分为三种类型。

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

一、操作场景

·MCP 注册中心:对接注册中心(如 TSF Nacos),同步原生 MCP Server,实现 MCP Tool 自动发现。

·普通注册中心:对接注册中心(如 TSF Nacos 2.x、TSF PolarisMesh),自动同步后端服务地址和元数据,适用于将后端服务批量接入 AI 网关。

·私有 DNS:对接腾讯云 Private DNS 进行域名解析,适用于通过域名访问的服务场景。

二、前置条件

·已开通 腾讯云 AI 网关服务

·已创建 AI 网关实例

·注册中心/TKE 实例与网关实例在同一 VPC 网络

三、步骤1:进入服务来源配置页面

1. 登录微服务平台控制台 ,在左侧导航栏选择 AI 网关进入实例列表。

2. 单击目标实例 ID/名称进入实例详情页,进入目标网关实例。

3. 在左侧导航栏,选择服务管理 > 服务来源;

4. 单击新建按钮。

四、步骤2:选择服务来源类型

系统提供三种服务来源类型,请根据你的实际场景选择。

五、场景一:配置 MCP 注册中心(同步原生 MCP Server)

适用场景:你的 MCP Server 已注册到 TSF Nacos,需要 AI 网关自动发现和同步 Tool。

参数配置:

参数名称 是否必选 说明
来源类型 是 选择 MCP 注册中心
来源产品 是 TSF Nacos(推荐)直接对接注册在 TSF Nacos 3.x 上的服务
服务来源名称 是 自定义名称,最长60个字符,支持中英文、数字及 -、_ 符号,不能以隔符开头和结尾,同网关实例下唯一
选择实例 是 选择已有的 Nacos 实例(仅显示与网关实例同 VPC 的实例)
用户名 是 Nacos 鉴权用户名
密码 是 Nacos 鉴权密码,支持英文字母、数字、空格及常见符号
描述 否 服务来源描述信息,最长200个字符

操作步骤:

1. 在新建服务来源弹窗中,选择来源类型为 MCP 注册中心;

2. 选择来源产品为 TSF Nacos;

3. 填写服务来源名称(如:mcp-nacos-prod);

4. 从下拉列表中选择 Nacos 实例;

5. 填写鉴权用户名和密码;

6. (可选)填写描述信息;

7. 单击 确定 完成创建。

同步效果:

·AI 网关将自动同步 Nacos 中注册的 MCP Server 服务。

·MCP Server 的 Tool 定义将自动发现并在控制台展示。

·服务实例变更时,网关自动感知并更新。

六、场景二:配置普通注册中心(批量接入后端服务)

适用场景:你的后端服务已注册到 TSF Nacos 2.x 或 TSF PolarisMesh,需要 AI 网关自动发现并接入这些服务。

参数配置:

参数名称 是否必选 说明
来源类型 是 选择 普通注册中心
来源产品 是 TSF Nacos(推荐):直接对接注册在 TSF Nacos 2.x 上的服务;TSF PolarisMesh:直接对接注册在 TSF PolarisMesh 上的服务
服务来源名称 是 自定义名称,最长60个字符,支持中英文、数字及 -、_ 符号,不能以分隔符开头和结尾,同网关实例下唯一
选择实例 是 选择已有的 Nacos / PolarisMesh 实例(仅显示与网关实例同 VPC 的实例)
用户名 是 注册中心鉴权用户名。支持英文字母、数字、空格及常见符号
密码 是 注册中心鉴权密码。支持英文字母、数字、空格及常见符号
描述 否 服务来源描述信息,最长200个字符

操作步骤:

1. 在新建服务来源弹窗中,选择来源类型为普通注册中心;

2. 选择来源产品为 TSF Nacos(推荐)或 TSF PolarisMesh;

3. 填写服务来源名称(如:nacos-prod、polaris-prod);

4. 从下拉列表中选择对应的注册中心实例;

5. 填写鉴权用户名和密码;

6. (可选)填写描述信息;

7. 单击确定完成创建。

同步效果:

·AI 网关将自动同步注册中心中已注册的后端服务(包含服务地址、端口等元数据)。

·服务实例变更时,网关自动感知并更新,无需手动维护服务列表。

·同步的服务可在“服务管理 > 服务”列表中查看,可直接用于创建模型服务的后端来源。

七、场景三:配置容器服务(批量接入 TKE 服务)

使用场景:对接腾讯云 TKE 集群,自动发现 Service

参数配置:

参数名称 是否必选 说明
来源产品 是 TKE 标准集群使直接对接部署在 TKE 标准集群上的服务
服务来源名称 是 2 ~ 60个字符,支持中英文大小写、数字及分隔符("-"、"_"),不能以数字和分隔符开头,不能以分隔符结尾
选择集群 是 仅支持选择和当前 AI 网关有相同 VPC 的可用集群
描述 否 服务来源描述信息,最长200个字符

八、场景四:配置私有 DNS(通过域名解析访问服务)

适用场景:你的后端服务通过域名访问,需要使用腾讯云 Private DNS 进行域名解析。

参数配置:

参数名称 是否必选 说明
来源类型 是 选择 私有 DNS
来源产品 是 腾讯云私有解析使用 Private DNS 进行域名解析
描述 否 服务来源描述信息,最长200个字符

操作步骤:

1. 在新建服务来源弹窗中,选择来源类型为私有 DNS;

2. 选择来源产品为腾讯云私有解析;

3. (可选)填写描述信息;

4. 单击确定完成创建。

配置说明:

·配置完成后,在创建服务时可选择该来源。

·后端地址支持填写域名(如:server.internal.example.com)。

·网关将通过 Private DNS 解析域名并转发请求。

九、步骤3:保存配置

1. 确认所有参数填写正确;

2. 单击确定按钮完成创建;

3. 系统自动跳转到服务来源列表页。

十、结果验证

配置完成后,可通过以下方式验证:

·在服务来源列表页,查看新建的来源记录。

·MCP 注册中心类型:在新建 MCP 服务时,可在服务来源下拉列表中选择该来源。

·普通注册中心类型:在新建服务时,可在服务来源下拉列表中选择该来源,同步的注册中心服务将作为可选后端。

·私有 DNS 类型:在新建服务时,选择该来源,后端地址可填写域名。

·在 MCP 管理 > MCP 服务 页面,新建服务时可在服务来源下拉列表中选择该来源。

十一、Q1: 为什么选择实例时看不到我的 Nacos 实例?

A: 请检查以下几点:

1. Nacos 实例与 AI 网关实例是否在同一 VPC 网络;

2. 你的账号是否有 Nacos 实例的查看权限;

3. Nacos 实例是否处于运行中状态。

十二、Q2: 一个服务来源可以关联多个 MCP 服务吗?

A: 可以。单个服务来源可以关联多个 MCP 服务,适用于以下场景:

·同一个 Nacos 实例中注册了多个 MCP Server。

·同一个 Nacos / PolarisMesh 实例中注册了多个后端服务。

·同一个 Private DNS 解析多个不同的域名。

十三、Q3: 服务来源配置错误导致同步失败,如何排查?

A: 请按以下步骤排查:

1. 进入服务来源详情页,查看错误信息;

2. MCP 注册中心:检查用户名/密码是否正确,Nacos 实例是否可访问;

3. 私有 DNS:检查域名解析记录是否正确配置;

4. 查看 AI 网关日志获取详细错误信息。

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