# 配置 ASR 热词 (/zh-CN/ai/build/custom-model-integration/asr-keywords) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 在对话式 AI 场景中,用户可能会说出品牌名、产品名、人名、地名、行业术语等专有词。你可以通过 RESTful API 或 Agents SDK 在创建对话式智能体时配置 ASR 热词,提升凤鸣 ASR 对这些词汇的识别效果。 ## 前提条件 [#前提条件] 开始前,请确保你已经: - 已参考[使用 RESTful API](/zh-CN/ai/get-started/quick-start) 或 [使用 Agents SDK](/zh-CN/ai/get-started/quick-start-agent) 实现与智能体对话的基本逻辑。 - 如通过 Agents SDK 配置热词,请安装包含 `FengmingSTT` 热词配置支持的 Agents SDK `v2.6.0` 及以上版本。 ## 实现方式 [#实现方式] 以下示例展示如何通过 Agents SDK 或 RESTful API 为凤鸣 ASR 配置热词。 Go Python TypeScript Restful API 创建 `FengmingSTT` 时,通过 `FengmingSTTOptions.Keywords` 传入热词列表: ```go // 其他智能体配置... agent := agentkit.NewAgent(client).WithStt( vendors.NewFengmingSTT(vendors.FengmingSTTOptions{ Keywords: []string{ "Agora", "Conversational AI", "RTC", }, }), ) // 其他智能体配置... ``` 创建 `FengmingSTT` 时,通过 `keywords` 传入热词列表: ```python # 其他智能体配置... agent = agent.with_stt( FengmingSTT( keywords=[ "Agora", "Conversational AI", "RTC", ] ) ) # 其他智能体配置... ``` 创建 `FengmingSTT` 时,通过构造参数中的 `keywords` 传入热词列表: ```typescript // 其他智能体配置... const agentWithKeywords = agent.withStt( new FengmingSTT({ keywords: [ 'Agora', 'Conversational AI', 'RTC', ], }) ); // 其他智能体配置... ``` 调用 [POST 创建对话式智能体](/zh-CN/api-reference/conversational-ai/rest-api/agent/join) 时,在请求体的 `properties.asr.keywords` 中传入热词列表: ```json { "asr": { "language": "zh-CN", "vendor": "fengming", "keywords": [ "Agora", "Conversational AI", "RTC" ] } } ``` ## 参数说明 [#参数说明] Go Python TypeScript Restful API | 参数 | 类型 | 描述 | | :--- | :--- | :--- | | `FengmingSTTOptions.Keywords` | []string | ASR 热词列表,用于提升指定词汇的识别效果,最多支持 128 个热词。 | | 参数 | 类型 | 描述 | | :--- | :--- | :--- | | `keywords` | List[str] | ASR 热词列表,用于提升指定词汇的识别效果,最多支持 128 个热词。 | | 参数 | 类型 | 描述 | | :--- | :--- | :--- | | `keywords` | string[] | ASR 热词列表,用于提升指定词汇的识别效果,最多支持 128 个热词。 | | 参数 | 类型 | 描述 | | :--- | :--- | :--- | | `properties.asr.keywords` | Array[String] | ASR 热词列表,用于提升指定词汇的识别效果,最多支持 128 个热词。 | :::info[信息] - 使用 RESTful API 时,仅当使用凤鸣 ASR 或未显式设置 `properties.asr.vendor` 时,可以设置 `properties.asr.keywords`。 - 如果配置了其他 ASR 供应商,同时设置热词,请求会报错。 - 热词数量最多支持 128 个。为避免影响整体识别效果,建议只配置当前业务确实需要增强识别的词汇。 ::: ## 与关键词打断的区别 [#与关键词打断的区别] ASR 热词和关键词打断都涉及关键词,但用途不同: | 能力 | 配置字段 | 作用 | | :--- | :--- | :--- | | ASR 热词 | `properties.asr.keywords` | 提升指定词汇的语音识别效果。 | | 关键词打断 | `properties.interruption.keywords_config.trigger_keywords` | 用户说出指定关键词时触发打断。 | ## 最佳实践 [#最佳实践] - 优先配置品牌名、产品名、人名、地名、型号、缩写等容易被误识别的词。 - 避免配置过多通用词、短词或语义过泛的词,例如“好的”“开始”“服务”等。 - 中英文混合场景下,可以同时配置中文词、英文词和常见读法,例如产品中文名、英文名和缩写。 - 上线前使用真实业务音频回归验证,重点检查热词本身和相近词的识别结果。