文档中心

AgentKit

网关实例

配置专属网关插件

网关插件是安装在专属网关实例上的扩展能力模块，用于在请求或响应的处理链路中对数据进行干预。通过安装并配置插件规则，您可以实现认证凭据的位置转换、自定义签名与鉴权、审计与风控拦截，以及基于身份与权限策略的访问控制等能力，而无需修改后端服务。当前网关提供凭据转换、自定义服务扩展和 Identity 鉴权插件，本文介绍各插件的适用场景、安装方式和规则配置。

注意

插件能力支持 MCP 类型专属网关和智能体运行时类型专属网关。其中，凭据转换插件仅支持 MCP 类型专属网关；自定义服务扩展插件和 Identity 鉴权插件支持MCP 类型专属网关和智能体运行时类型专属网关。

插件类型

网关提供凭据转换、自定义服务扩展和 Identity 鉴权三种插件。

插件名称	用途	适用场景
凭据转换	将请求中的认证凭据按配置规则转换后发往后端服务，未匹配规则或请求中不存在对应凭据时，插件会自动跳过，不影响请求继续转发。仅支持 MCP 类型专属网关。	将 Header 或 Query 中的认证凭据写入 POST 请求的 JSON Body 指定路径。将 Header 中的认证凭据写入 GET 请求的 Query 参数。将凭据从原位置写入目标位置后，移除原 Header 或 Query 参数。屏蔽内部认证 Header，并通过自定义 Header 向外部服务传递凭据，避免泄露内部认证 Header。
自定义服务扩展	将自有服务接入网关处理链路，当选择外部函数服务作为扩展服务后，网关会在请求或响应处理过程中调用该函数，并根据函数返回结果修改请求头、请求体、响应头或响应体，也可以直接返回自定义响应。支持 MCP 类型和智能体运行时类型专属网关。	自定义签名或鉴权：生成签名并写入 Header、Query 或 Body。审计、风控与拦截：命中规则时直接返回响应，未命中时继续转发。
Identity 鉴权	根据已验证身份与权限策略，控制 MCP 工具及智能体运行时的访问。插件从请求 Header 中提取 Token，并使用指定的 Identity 权限空间进行鉴权。鉴权失败时，请求将被拒绝。支持 MCP 类型和智能体运行时类型专属网关。	需要限制仅具有指定 Identity 权限的调用方访问 MCP 服务。调用方使用非默认 Token Header 或 Token 前缀，需要在网关侧适配 Token 的传递方式。

前提条件

已创建专属网关实例。配置操作，请参见创建专属网关。

已创建处于运行中状态的 MCP 服务或智能体运行时。凭据转换插件仅需 MCP 服务；自定义服务扩展和 Identity 鉴权插件可选择 MCP 服务或智能体运行时作为生效资源。配置操作，请参见创建 MCP 服务、创建智能体运行时。

已部署函数服务，且函数处于已发布或可调用状态。配置操作，请参见部署函数服务。

使用 Identity 鉴权插件前，已在 Identity 中创建可用的权限策略空间，并已为需要访问资源的身份配置访问规则。配置操作，请参见创建访问规则。

安装插件

在左侧导航树中选择“网关 > 网关总览”，在“专属网关”页签下，单击目标 MCP 类型或智能体运行时类型专属网关的名称。

在“插件”页签单击目标插件“操作”列的“安装”按钮。

说明

MCP 类型专属网关支持凭据转换、自定义服务扩展和 Identity 鉴权插件；智能体运行时类型专属网关支持自定义服务扩展和 Identity 鉴权插件。

在弹出的对话框中，单击“确认安装”按钮，完成插件安装。

说明

插件安装成功后，当前网关将会具备该插件功能，但不会自动影响线上请求，需配置规则后才会生效。

（可选）卸载插件。后续如果确认插件不再使用，您可卸载插件。

在“插件”页签下，单击目标插件“操作”列的“卸载”按钮。

注意

卸载插件可能对此网关线上流量产生影响，请谨慎操作。

不支持卸载存在已启用规则的插件，如需卸载请参考下文“管理规则”部分，停用或删除全部规则。

弹出的对话框中，单击“确认卸载”按钮，完成插件卸载。

配置插件规则

添加规则

插件安装完成后，您需要添加插件规则后才能对线上请求生效。配置入口位于对应专属网关详情页的“插件”页签，当前不提供独立的插件管理入口。凭据转换插件仅支持在 MCP 服务维度配置规则；自定义服务扩展和 Identity 鉴权插件支持在 MCP 服务或智能体运行时维度配置规则。

在左侧导航树中选择“网关 > 网关总览”，在“专属网关”页签下，单击目标 MCP 类型或智能体运行时类型专属网关的名称。

选择“插件”页签，在插件列表中，单击目标插件“操作”列的“规则配置”按钮。

单击“添加规则”按钮，参考下表配置插件规则。

凭据转换规则参数配置

自定义服务扩展规则参数配置

Identity 鉴权规则参数配置

请参考下表，配置凭据转换规则。

说明

每个规则最多可配置 10 个配置组。

如果一则规则中配置了多个配置组，会按照配置组从上到下的顺序进行匹配，您可通过配置组右上方的“上移”“下移”按钮调整顺序。

参数	说明
基础配置
生效范围	选择插件生效的资源范围。凭据转换插件当前仅支持 MCP 服务。
生效资源	选择插件规则生效的 MCP 服务。仅可选择状态为运行中且未配置该插件规则的 MCP 服务，支持同时选择多个。说明如果凭据转换插件规则“生效资源”中的 MCP 服务被删除，系统将自动将其从该插件规则的“生效资源”中移除。
插件特定配置
匹配条件	匹配条件用于限定规则仅在指定请求下执行。配置说明可不配置匹配条件，不配置规则对所有请求生效。如需配置匹配条件，单击“添加匹配条件”按钮配置。每个配置组内最多可配置 5 个匹配条件。多个匹配条件之间是且的关系，即全部条件都匹配成功，规则才会执行。参数说明匹配对象：指定匹配的来源位置，当前支持 Header、Query和Method。字段名：需要匹配的Header或Query的字段名。Header名不区分大小写，系统加载时会统一转为小写。Query名必须区分大小写。匹配方式：字段值的匹配规则。精确匹配：字段值与匹配值完全一致时，才为命中规则。前缀匹配：字段值以匹配值开头时，即为命中规则。匹配值：与字段名对应的期望值，请求中该字段的值与此处配置完全一致时，命中规则。
转换配置	转换配置用于指定对凭据的具体处理方式，支持将凭据写入指定位置或删除指定参数。转换操作：选择对凭据的处理方式。 Set：读取原始凭据并写入目标位置。 Remove：删除指定目标参数，可用于将凭据写入目标位置后移除原始凭据。原凭据位置：仅转换操作为“Set”时需配置。原始凭据所在的位置，支持Header、Query。原凭据字段名：仅转换操作为“Set”时需配置。原始凭据对应的字段名，例如Authorization。目标位置：凭据写入的目标位置，支持Header、Query、Body。 Header：需配置目标字段名，凭据写入的目标Header字段名称，例如X-API-Key。字段名大小写不敏感，保存后将被统一转为小写。 Query：需配置目标字段名。凭据写入的目标Query参数名称，例如api_key。字段名区分大小写，请确保与后端服务实际接收的参数名一致。 Body：需配置 Body 格式，支持 JSON Body、表单 Body 。 JSON Body：适用于 Content-Type 为application/json的请求，请在“JSON Body 写入路径”中填写 JSON Pointer 路径，例如/api_key。表单 Body ：适用于 Content-Type 为application/x-www-form-urlencoded的请求，请在“表单 Body 字段名”中填写表单的字段名，如api_key。

规则添加成功后会立即启用，您可在规则列表中查看规则生效状态。

管理规则

插件规则添加完成后，您可以对规则进行启用、停用、编辑或删除操作，以管理其对线上请求的处理行为。

在左侧导航树中选择“网关 > 网关总览”，在“专属网关”页签下，单击 MCP 类型网关名称。

选择“插件”页签，单击目标插件“操作”列的“规则配置”按钮，在规则列表中管理目标规则。

停用/启用规则：单击目标规则“操作”列的“启用”/“停用”按钮。

说明

仅可启用已经停用的规则，或者停用已经启用的规则。

编辑规则：单击目标规则“操作”列的“编辑”按钮。

说明

仅支持编辑规则中的“插件特定配置”，不支持修改规则生效的资源。

删除规则：单击目标规则“操作”列的“删除”按钮。

注意

删除后不可恢复，请谨慎操作。

仅支持删除生效状态为未启用的规则，已启用的规则不支持删除，请停用后再删除。

最近更新时间：2026.10.26 14:05:34

这个页面对您有帮助吗？

有用

无用

参数	说明
基础配置
生效范围	选择插件生效的资源范围，支持 MCP 服务和智能体运行时。
生效资源	选择插件规则生效的 MCP 服务或智能体运行时。仅可选择运行中且未配置过该插件规则的资源。
插件特定配置
外接服务类型	选择外接服务的类型，当前仅支持函数服务。
函数服务	选择实际使用的外接函数服务，仅支持选择已发布或处于可调用状态的函数服务。若无可用函数服务请先创建，详见部署函数服务。
处理阶段	选择插件介入的阶段。请求阶段：在请求发往后端服务前调用函数。响应阶段：在后端服务返回响应后调用函数。
是否传递 Body	是否开启传递 Body 功能。开启：外接服务可读取并修改请求或响应 Body。关闭：Body 不会传递给外接服务，函数无法读取或修改请求/响应 Body。
超时时间	调用外接函数服务时的最长等待时间。默认值 30，单位为秒，若函数在该时间内未返回结果，视为调用超时。超时后的行为由失败时放行决定：开启失败时放行则跳过该插件继续处理请求，未开启失败时放行则返回错误信息。
失败时放行	是否开启失败时放行功能。开启：函数调用失败时将跳过该插件继续处理请求。未开启：函数调用失败将直接返回错误。

参数	说明
基础配置
生效范围	选择插件生效的资源范围。支持 MCP 服务和智能体运行时。
生效资源	选择插件规则生效的 MCP 服务或智能体运行时。仅可选择状态为运行中且未配置该插件规则的资源。所选资源需与 Identity 权限空间策略中配置的对象一致，否则对应规则无法生效。
插件特定配置
权限空间	选择用于鉴权的 Identity 权限空间。网关会使用该权限空间中的身份与权限策略校验访问请求。
Token 位置
Token Header 名称	必填。填写用于传递 Token 的请求 Header 名称。默认值为 X-Ve-TIP-Token。 Header 名称不区分大小写，保存时会统一转换为小写。如调用方通过其他 Header 传递 Token，请按实际 Header 名称配置。
Token 前缀	可选。填写 Token 值的前缀，例如 Bearer。匹配时忽略大小写，匹配成功后，网关会从 Header 值中移除该前缀，再使用剩余内容进行鉴权。