云原生智能网关 意图管理

一、操作场景

典型适用场景：

·垂直行业业务分流：银行、政务等客户按自身业务线定义意图，将不同业务的请求路由到各自专属的模型服务。

·多渠道统一意图体系：企业同时运营手机银行问答、坐席辅助、智能外呼等多个模型 API，背后是同一套业务意图分类。在意图管理中定义一次，各模型 API 分别引用，并可各自配置不同的目标模型服务。

·意图定义集中维护：业务边界调整时，只需在意图管理中修改一次，所有引用方自动生效最新定义，无需逐个模型 API 同步。

二、前提条件

·已创建 AI 网关实例，且实例处于运行中状态。

·已明确需要区分的业务意图及其边界。

·若需立即将意图用于路由，还需已创建对应的目标模型服务。

三、内置意图

网关预置 5 个意图类型，覆盖通用场景。内置意图为只读，不支持编辑和删除，可直接在模型 API 的意图识别路由规则中引用。

在内置意图页签中，可通过右上角搜索框按意图名称搜索，单击 ID 右侧的复制图标可复制意图 ID。

四、步骤1：进入意图管理

1. 登录 AI 网关控制台，在左侧导航栏选择 AI 网关 > 实例管理，单击目标实例 ID，进入目标实例详情页。

2. 在左侧导航栏选择流量管理 > 意图管理。

3. 页面提供两个页签：

·内置意图：展示 5 个系统预置意图类型，只读。

·自定义意图：展示当前网关下已创建的自定义意图类型，页签名称后括号内为数量。

五、步骤2：新建自定义意图类型

1. 切换至自定义意图页签。

2. 单击新建意图类型，打开对话框。

注意：说明：

注意：当网关下存在多个相近业务意图时（如「存款业务」与「贷款业务」同属金融但业务不同），建议为每个意图补充 2-3 条典型提问示例，可显著提升识别准确率。若各意图之间区分度本身很高，可不填写。

六、步骤3：保存并在模型 API 中引用

1. 单击保存，返回列表页，新建的意图类型立即出现在自定义意图页签中。

2. 该意图类型随即可在当前网关下任意模型 API 的意图识别路由规则中被引用。配置方式详见 意图识别路由 相关文档。

注意：说明：

注意：意图管理只负责定义意图类型，不涉及目标模型服务的配置。某个意图应路由到哪个模型服务，由各模型 API 在自己的路由规则中单独配置。因此同一个意图类型被多个模型 API 引用时，各模型 API 可以指向不同的目标模型服务。

七、编辑自定义意图

1. 在列表中单击目标意图类型操作列的编辑，打开编辑意图类型对话框。

2. 修改意图名称、意图描述，或增删示例问法。

3. 单击保存。

八、删除自定义意图

在列表中单击目标意图类型操作列的删除，在弹窗中按提示确认。

注意：删除前请先单击查看引用确认该意图类型是否仍被模型 API 的路由规则引用。删除已被引用的意图类型会影响对应模型 API 的路由行为。

九、配置示例

以银行客户为例，在意图管理中定义以下 4 个自定义意图类型：

上述意图类型各定义一次后，可在「手机银行智能问答」「坐席辅助助手」「智能外呼」等多个模型 API 中分别引用。各模型 API 可为同一意图类型配置不同的目标模型服务，实现意图定义统一、目标模型灵活。

十、注意事项

·内置意图不可编辑删除。如需调整通用场景的意图边界，可新建一个自定义意图类型替代使用。

·意图描述直接影响识别准确率。描述应说明该意图「覆盖什么」，必要时也说明「不覆盖什么」，避免与相近意图产生歧义。

·示例问法在相近意图场景下建议填写。网关下意图数量较多、业务相近时，缺少示例问法会明显降低区分准确率。

·编辑即时生效于所有引用方。这是跨模型 API 复用带来的便利，同时也意味着一次修改会同时影响多个线上模型 API，修改前建议先查看引用情况评估影响范围。

·意图类型只定义不绑定模型。目标模型服务在各模型 API 的路由规则中配置，意图管理页面不涉及。

·意图数量建议适度控制。意图类别过多会降低识别模型的区分准确率，建议按实际业务线划分，避免过细拆分。