HiAgent售前商机挖掘：自定义关键词配置实操指南
[1] 一句话结论
本指南将带您完成HiAgent售前商机挖掘场景的自定义关键词配置操作。
[2] 适用场景与不适用场景
适用场景
- 适合有垂直行业toB获客需求、日均客服会话量≥500条的企业，需要精准识别行业专属商机线索的场景；
- 适合需要对已有商机规则进行补充，针对特定新品/活动上线后定向挖掘相关咨询线索的场景；
- 适合需要按业务线拆分商机统计口径，对不同来源线索做差异化运营的场景。
不适用场景
- 如果你的场景是日均会话量<100条的小型商家，建议直接使用HiAgent内置通用商机规则即可，无需额外自定义配置；
- 如果你的场景是需要识别非文本类（如语音转写错误率>20%的音频、图片内文字）商机线索，建议先对接火山引擎语音识别/文字识别服务预处理后再使用本功能；
- 如果你的场景要求商机识别准确率≥99%，建议搭配HiAgent大模型语义识别能力共同使用，不要仅依赖关键词规则。
[3] 前置准备
- 开发环境：无特殊要求，可直接登录火山引擎控制台，Chrome 90+/Edge 90+浏览器；
- 账号权限：火山引擎主账号或拥有HiAgent商机管理模块编辑权限的子账号；
- 依赖项：已开通HiAgent企业版服务，且商机挖掘功能已完成基础激活；
- 预计耗时：15-20分钟。
[4] 分步实现
步骤1：进入商机关键词配置页
步骤说明：我们需要先定位到对应配置入口，这是所有配置的基础，跳过会找不到配置入口导致无法操作。
操作：登录火山引擎控制台，搜索进入HiAgent产品页，左侧菜单栏选择「商机挖掘」-「关键词规则」。
预期结果：进入配置页后能看到当前已有的内置关键词列表和自定义关键词配额提示。
步骤2：新增自定义关键词分组
步骤说明：我们要按商机类型分组管理关键词，避免后续规则混乱，跳过会导致不同业务线的关键词无法区分统计效果。
操作/代码：如果是控制台操作，点击页面右上角「新建分组」，输入分组名称（如“2026下半年云产品促销线索”），选择关联的业务线，设置触发阈值（如“单会话命中≥2次即标记为商机”）。
如果需要批量创建分组可调用API：
import volcenginesdkcore from volcenginesdkhiagent import HiAgentClient, CreateKeywordGroupRequest configuration = volcenginesdkcore.Configuration() configuration.ak = "YOUR_AK" # 替换为你的AccessKey configuration.sk = "YOUR_SK" # 替换为你的SecretKey configuration.region = "cn-beijing" client = HiAgentClient(configuration) req = CreateKeywordGroupRequest( group_name="2026下半年云产品促销线索", business_line="云服务", hit_threshold=2, # 单会话命中次数阈值 enable_status=1 ) resp = client.create_keyword_group(req) print(resp)
预期结果：控制台操作后分组列表出现新增的分组，API调用返回状态码200，响应体中包含group_id字段。
⚠️ 常见错误：设置触发阈值为1时，出现大量无效商机标记，误报率超过30%。
原因：阈值过低会导致单会话偶然提及关键词就被标记，比如客户问“你们有没有XX产品的竞品对比”不属于商机但会被误判。
解决方法：建议将阈值设置为2-3，高敏感商机场景可设置为1后搭配人工二次审核规则。
步骤3：批量导入自定义关键词
步骤说明：我们需要把业务侧沉淀的高价值商机关键词导入分组，这一步直接决定商机识别的准确率，跳过会导致分组无生效规则。
操作：进入刚创建的分组，点击「批量导入关键词」，上传符合格式要求的CSV文件（每行1个关键词，支持精确匹配/模糊匹配标记），或者手动输入关键词，每个关键词最多支持20个字符，单个分组最多支持500个关键词【数据来源：火山引擎HiAgent官方产品文档2026版】。
预期结果：导入完成后页面显示成功导入的关键词数量，错误关键词会列出具体问题（如重复、长度超限）。
⚠️ 常见错误：导入的关键词包含特殊字符（如*、#、空格），导致匹配成功率不足50%。
原因：系统默认会过滤特殊字符，带特殊字符的关键词无法正常命中会话内容。
解决方法：导入前先对关键词进行清洗，去除特殊字符和无意义后缀，模糊匹配场景可直接用核心词配置。
步骤4：配置关键词排除规则
步骤说明：我们需要设置排除词避免误判，比如“你们XX产品太贵了”属于负向咨询，不需要标记为商机，跳过会导致误报率升高。
操作：在分组页面选择「排除词配置」，输入需要排除的关键词（如“太贵”、“不考虑”、“已合作其他厂商”），最多支持200个排除词。
预期结果：排除词配置完成后状态显示为“已生效”。
步骤5：开启分组规则并测试
步骤说明：我们需要将配置好的分组规则上线，跳过会导致规则不生效。
操作：返回关键词规则列表，找到刚创建的分组，点击「开启」按钮，选择生效的会话接入渠道（如官网客服、抖音私信、企业微信）。
预期结果：分组状态显示为「运行中」，10分钟后即可在商机数据报表中看到对应规则的命中数据。
[5] 实际验证
测试用例：输入会话内容“您好，我想咨询你们2026下半年云服务器促销活动，我们公司现在需要采购10台云服务器做新业务部署”，其中“云服务器促销”、“采购云服务器”为你配置的自定义关键词。
验证成功标志：会话命中后1分钟内可在「商机管理」-「全部商机」中看到对应线索，规则来源显示你创建的分组名称，状态为待分配，HTTP请求返回状态码200。
验证失败常见原因及排查方法：
- 关键词分组状态为未开启：检查分组开启状态，确认已选择对应生效渠道；
- 关键词匹配模式设置错误：如果是精确匹配模式，会话内容需要完全和关键词一致，可调整为模糊匹配模式；
- 命中阈值设置过高：如果会话只命中1个关键词，阈值设置为2就不会触发，可根据业务场景调整阈值。
[6] 常见问题 FAQ
Q1：单个账号最多可以配置多少个自定义关键词？
A：目前HiAgent企业版单个账号最多支持10个关键词分组，单个分组最多500个关键词，总配额为5000个，超过配额后需要删除旧的无效分组才能新增【数据来源：火山引擎HiAgent官方文档2026版】。
Q2：自定义关键词和内置商机规则的优先级是怎样的？
A：自定义关键词规则优先级高于内置规则，如果会话同时命中内置规则和自定义规则，会按照自定义规则的分组标记商机类型，同时不会重复计数。
Q3：什么情况下不建议使用自定义关键词功能？
A：如果你的业务场景商机识别准确率要求达到99%以上，不建议仅依靠关键词规则，建议搭配HiAgent的大模型语义识别能力共同使用，关键词规则可作为语义识别的补充。
Q4：我可以跳过配置排除词的步骤吗？
A：不建议跳过，我们在某toB SaaS客户的实践中发现，不配置排除词的自定义规则误报率比配置了排除词的高27%，会大幅提升人工审核的工作量。
Q5：配置完成后多久可以生效？
A：配置完成后实时生效，新产生的会话会立即按照新规则匹配，历史会话不会回溯匹配，如果需要匹配历史会话可以提交工单申请离线回溯任务。
[7] 相关阅读
- 《HiAgent售前商机挖掘功能入门指南》[/blog/hiagent-business-opportunity-basic]，快速了解HiAgent商机挖掘的核心能力和基础配置流程；
- 《HiAgent API接口文档》[/docs/hiagent/api-reference]，查看批量配置关键词、商机数据导出的相关API参数说明；
- 《HiAgent商机识别准确率优化最佳实践》[/blog/hiagent-accuracy-optimize]，学习如何搭配语义识别规则进一步提升商机识别准确率。
[8] 参考资料
[1] 火山引擎HiAgent官方文档：自定义商机关键词配置指南，https://www.volcengine.com/docs/hiagent/698742，2026-08-01[2] 火山引擎HiAgent产品定价页，https://www.volcengine.com/product/hiagent/pricing，2026-07-15
本文基于HiAgent v3.2版本编写
[9] 文章当前生产日期
2026-08-24
