1. 意图禁用

1.1 背景

在大模型实时互动服务中，推荐使用互动应用来区分不同的业务线，这样不同的应用之间配置完全隔离。实际中不同客户对智能体的能力需求、管理方式不同，存在客户通过在同一个应用下使用不同角色来区分不同业务线的现象。针对这种场景，大模型实时互动服务会逐步支持角色级别的意图配置项。

当客户需要对特定角色禁用某些意图能力（如内容资源、网页搜索、Function Call等），将原本命中这些意图的用户问题使用角色Prompt来控制回复效果，可以使用意图禁用功能来实现该能力。

典型场景：

• 翻译场景：客户需要严格的对话能力，所有问题都只需要返回翻译后的文本，不需要对问题做回答，也不需要根据问题意图触发音乐播放和Function Call识别等。
• 第三方模型定制能力场景：客户希望部分能力（如网页搜索）走自己的模型服务（即角色配置第三方模型服务），但同时使用大模型实时互动系统的Function Call能力。

1.2 意图禁用功能说明

功能说明：

• 支持在创建智能体时、切换角色时通过disableIntents字段来配置禁用意图列表，该字段类型是字符串数组。配置后对应意图类型将不再触发，统一使用角色来回复，回复效果完全由角色Prompt控制。
• 需要客户在会话中使用了角色，如果会话无角色，该功能无法生效。

支持的禁用意图类型有：

1.3. 配置方式

1.3.1 创建智能体时配置

在服务端API中创建大模型互动实例(互动智能体)接口的 config 字段中增加 disableIntents：

1{
2    "config": "{\"disableIntents\": [\"WEB_SEARCH\", \"CONTENT\", \"VISION\"]}"
3}

1.3.2 切换角色时配置

通过服务端切换互动实例的角色（音色）接口、或者客户端更换音色/角色指令中，在scene_role_cfg字段中配置disableIntents字段。

服务端接口：

• 参考服务端API中切换互动实例的角色（音色）接口。

1{
2    "app_id": "YOUR_APP_ID",
3    "ai_agent_instance_id": 123456,
4    "scene_role_cfg": {
5        "name": "小度熊",
6        "prompt": "你是智能聊天助手小度熊，性格：热情且富有情感，能陪用户谈天说地，回复简明扼要。",
7        "disableIntents": [
8            "WEB_SEARCH",
9            "CONTENT",
10            "VISION"
11        ]
12    }
13}

客户端指令：

• 参考客户端和智能体之间的消息格式中更换音色/角色指令。

1[OP]:[switchSceneRole]:{"scene_role_cfg":{"name":"小度熊","prompt":"你是智能聊天助手小度熊，性格：热情且富有情感，能陪用户谈天说地，回复简明扼要。","disableIntents":["WEB_SEARCH","CONTENT","VISION"]}}}

1.3.4 禁用功能示例

禁用网页搜索、内容资源和视觉：

1{"disableIntents": ["WEB_SEARCH", "CONTENT", "VISION"]}

禁用除聊天外的所有意图：

1{"disableIntents": ["ALL"]}