主题
语音热词配置
语音热词功能用于提升 ASR（自动语音识别）对特定词汇的识别准确率。当产品涉及专有名词（品牌名、产品名、角色名、菜谱名等）时，通过配置热词可显著降低误识别率。
⚠ 入口位置：语音热词的配置入口在产品配置页顶部信息卡片中的「热词配置」按钮，作用于产品级（该产品下所有绑定设备共用同一份热词表），与智能体的其他交互策略配置分开。
1 功能说明
核心能力：
- 单产品最多支持 4000 条热词；
- 支持配置「误识别词」（改写源），实现 ASR 后处理改写；
- 支持单条新增、批量文本输入、Excel 文件上传三种方式；
- 支持模板下载和热词导出；
- 热词在建联时生效。
2 热词与改写机制
平台采用「热词加权 + ASR 后处理改写」双链路方案：
音频 → ASR（热词加权提升识别概率） → 后处理改写服务（严格匹配误识别词并替换） → 最终文本| 列名 | 是否必填 | 说明 |
|---|---|---|
| 热词/目标词 | 必填 | 期望 ASR 识别概率更高的词 / 改写后的正确文本 |
| 误识别词 | 选填 | ASR 可能识别出的错误/同音/近音文本，匹配后自动替换为目标词 |
示例：
| 热词/目标词 | 误识别词 |
|---|---|
| joyinside | |
| 京东京造 | 京东金造 |
「joyinside」「京东京造」都是热词，「京东金造」会改写成「京东京造」。
⚠ 误识别词不能重复，即一个误识别词只能对应一个目标词。
3 配置流程
方式一：单条新增
- 进入「产品管理」→ 目标产品卡片 → 「产品配置」；
- 在顶部信息卡片中点击「热词配置」按钮进入编辑面板；
- 点击「新增」按钮，新增一条空白行；
- 填写「热词/目标词」（必填）和「误识别词」（选填）；
- 保存。
方式二：批量输入
- 点击「批量导入」；
- 在「批量输入」文本框中输入多个热词，以逗号分隔；
- 选择「批量上传」（增量合并）或「全量覆盖」（替换现有）。
方式三：文件上传
- 点击「模板下载」获取 Excel 模板；
- 按模板格式填写热词和误识别词；
- 点击「批量导入」→ 文件上传区域上传填好的文件（支持 .xls / .xlsx）；
- 选择「批量上传」或「全量覆盖」。
其他操作：
- 搜索：支持模糊搜索已配置的热词、误识别词；
- 文件导出：以 Excel 形式导出当前全部热词配置；
- 删除：单条删除。
4 音频格式选择
热词编辑页顶部有「音频格式」下拉框（如 pcm），用于指定当前产品的上行音频格式，确保 ASR 引擎正确解析音频流。
5 约束与限制
| 约束项 | 说明 |
|---|---|
| 单产品总词条数 | ≤ 4000 条 |
| 单词条长度 | ≤ 20 字符（汉字个数 / 英文字母数） |
| 支持语种 | 中文、英文 |
| 文件大小 | 单文件 ≤ 10MB |
| 生效时机 | 建联时生效（修改后新建连的会话生效） |
| 误识别词唯一性 | 同一产品内不允许重复的误识别词 |
| 词条内容限制 | 仅支持中文汉字、英文单词和空格，不支持特殊符号和 Emoji |
6 生效时机
- 热词在 WebSocket 建联时加载到该会话（热词有服务端缓存）；
- 修改热词后需设备断开并重新建立连接才能生效；
- 已在对话中的会话不受影响，需等下次建连。
7 Q&A
Q：热词和误识别词改写是什么关系？ A：热词（目标词）是希望 ASR 更准确识别的正确词汇；误识别词是 ASR 可能错误输出的文本。当 ASR 输出严格匹配到某个误识别词时，系统会自动将其替换为对应的目标词。
Q：修改热词后多久生效？ A：热词在 WebSocket 建联时加载，因此修改后需要设备重新建连（断开并重新连接）才能生效。已在对话中的会话不受影响。
Q：不填误识别词可以吗？ A：可以。仅填写目标词时，系统只做热词加权（提升该词在 ASR 解码阶段的识别概率），不做后处理改写。
Q：不同产品之间的热词会互相影响吗？ A：不会。热词是产品级配置，每个产品独立维护自己的热词表，仅作用于绑定到该产品下的设备。
Q：lite 版产品支持热词吗？ A：支持。语音热词是产品级配置，标准版和 lite 版产品都可以配置。