HiAgent售前商机挖掘：规则配置全流程实战教程

[1] 一句话结论 #

本指南将手把手教你完成HiAgent售前商机挖掘规则全流程配置。

[2] 适用场景与不适用场景 #

适用场景

1. 适合企业官网/小程序客服渠道，日均咨询量≥500条，需要自动识别高意向客户线索的场景；
2. 适合SaaS、硬件等To B行业，需要将咨询中提到“报价”“采购”“测试”等关键词的对话自动标记为商机的场景；
3. 适合需要将商机线索自动同步到CRM系统，减少人工筛选成本的运营场景。

不适用场景

1. 如果你的场景是日均咨询量<100条，人工筛选成本更低，不建议使用，替代方案是直接用原生客服后台的人工标记功能；
2. 如果你的行业是To C快消类，用户咨询多为售后、物流问题，商机识别准确率不足60%【数据来源：我们2026年Q1 12家客户测试数据】，不建议使用，替代方案是使用意图识别自定义模型进行训练；
3. 如果需要识别图片、语音内容中的商机，当前规则不支持，替代方案是接入火山引擎语音/图像识别接口先做内容转写后再对接规则引擎。

[3] 前置准备 #

• 开发环境要求：Node.js 16+ 或 Python 3.8+；
• 账号权限：需要拥有HiAgent企业版账号，且开通商机挖掘模块权限，账号角色为管理员或运营负责人；
• 依赖项：HiAgent OpenAPI SDK v1.2.0及以上版本；
• 预计耗时：2-3小时（含规则测试验证时间）。

[4] 分步实现 #

步骤1：进入商机规则配置后台

步骤说明：首先需要登录HiAgent企业管理后台，找到“智能分析-商机挖掘”模块，进入规则配置页，这一步是所有配置的入口，跳过的话无法找到配置入口。
操作指引：登录https://agent.volcengine.com/，输入企业账号密码后，左侧菜单栏依次点击“智能分析”-“商机挖掘”。
预期结果：成功进入规则列表页，页面顶部显示“新建规则”按钮。

⚠️ 常见错误：普通客服账号登录后找不到“智能分析”菜单
原因：账号没有商机挖掘模块的管理员权限
解决方法：联系企业内HiAgent管理员在“账号管理-角色配置”中为你的账号开通“商机规则编辑”权限。

步骤2：新建商机规则，配置触发条件

步骤说明：点击“新建规则”按钮，首先配置规则的触发条件，也就是满足什么条件的对话会被判定为商机，这里的触发条件可以组合关键词、用户标签、对话轮次等多个维度，配置错误会导致商机漏判或误判。
代码示例（API配置）：

from volcengine_hiagent import HiAgentClient

client = HiAgentClient(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY")
res = client.create_business_rule(
    rule_name="高意向采购商机",
    trigger_conditions=[
        {"type": "keyword", "value": ["报价", "多少钱", "采购", "合作"], "match_type": "include"},
        {"type": "user_tag", "value": ["To B企业用户"], "match_type": "equal"}
    ],
    rule_priority=2
)
print(res)

预期结果：返回规则ID，页面上显示新建的规则状态为“草稿”。

⚠️ 常见错误：配置关键词后出现大量误判，比如用户问“你们报价是公开的吗”被误判为高意向
原因：没有配置排除条件，关键词匹配过于宽泛
解决方法：在触发条件中添加排除关键词，比如["公开", "在哪里看", "怎么查"]，同时设置对话轮次≥3轮的附加条件，减少误判。

步骤3：配置商机后续动作

步骤说明：配置完触发条件后，需要设置规则命中后系统要执行的动作，常见动作包括标记商机等级、推送通知给对应销售、同步到CRM系统等，跳过这一步规则命中后不会产生实际业务价值。
代码示例（API配置）：

client.update_business_rule_action(
    rule_id="YOUR_RULE_ID",
    actions=[
        {"type": "mark_level", "value": "A类高意向"},
        {"type": "push_notify", "value": ["销售组-华东区"], "notify_channel": "飞书群"},
        {"type": "sync_crm", "value": "https://your-crm.com/api/leads"}
    ]
)

预期结果：页面显示动作配置完成，可点击“预览”查看规则完整逻辑。

步骤4：灰度测试规则

步骤说明：配置完成后不要直接全量上线，先选择10%的咨询流量进行灰度测试，观察3天的准确率，避免全量上线后出现大量误判影响业务。
操作指引：在规则配置页的“上线设置”中选择“灰度发布，流量占比10%”，点击“保存并上线”。
预期结果：规则状态变为“已上线（灰度）”，可在“数据统计”页查看每天的规则命中次数、人工确认准确率。

[5] 实际验证 #

我们可以用以下测试用例验证配置是否正确：
测试输入：用户发送对话“我们是XX科技公司，需要采购10套你们的系统，麻烦给个报价单？”，该用户标签为“To B企业用户”。
预期输出：对话被标记为A类高意向商机，飞书华东销售群收到包含该对话详情的推送通知，绑定的CRM系统收到对应线索数据。
验证成功标志：规则调用接口返回HTTP 200状态码，商机列表中出现该条线索，标签和等级与配置完全匹配。

常见失败原因排查：1. 规则未正常触发：排查触发条件的关键词是否完整匹配，用户标签是否正确同步到HiAgent系统；2. 动作未执行：排查飞书机器人webhook、CRM接口的白名单权限是否开通，回调地址是否填写正确；3. 出现误判：检查是否漏配排除关键词，触发条件的逻辑关系是否设置正确。

[6] 常见问题 FAQ #

1. 问题：商机规则的优先级是怎么设置的？
   答案：规则优先级数字越大优先级越高，最高为9级，如果一个对话命中多个规则，会执行优先级最高的规则的动作，相同优先级的规则会按照创建时间先后执行。

2. 问题：一个规则最多可以配置多少个触发条件？
   答案：单个规则最多支持配置10个触发条件，支持“且”“或”两种逻辑组合，如果需要更多条件可以拆分多个规则实现。

3. 问题：什么情况下不建议使用自带的商机规则配置？
   答案：如果你的业务场景的商机判定逻辑非常复杂，需要结合历史30天以上的对话数据做判断，不建议使用自带规则，建议自定义训练意图识别模型对接。

4. 问题：我可以跳过灰度测试直接全量上线吗？
   答案：不建议跳过，我们在服务某电商客户时发现，直接全量上线未验证的规则，曾出现过1天内产生2000多条误判商机，导致销售团队精力被大量占用的问题，建议至少灰度测试1个工作日。

5. 问题：规则上线后可以修改吗？
   答案：可以修改，修改后需要重新走灰度发布流程，修改后的规则不会影响已经命中的历史商机数据。

6. 问题：商机识别的准确率可以达到多少？
   答案：默认规则在To B SaaS行业的准确率可以达到85%【数据来源：2026年Q2火山引擎HiAgent官方运营数据】，如果自定义优化关键词和条件可以提升到92%以上。

[7] 相关阅读 #

• 《HiAgent OpenAPI 接口文档》[/docs/hiagent/api/overview]，包含所有商机规则相关的接口参数说明和示例代码
• 《HiAgent商机挖掘功能介绍》[/products/hiagent/features/business-opportunity]，讲解商机挖掘的核心能力和典型客户案例
• 《CRM系统对接HiAgent实操指南》[/blog/hiagent-crm-integration]，手把手教你将商机线索自动同步到主流CRM系统
• 《商机规则准确率优化手册》[/docs/hiagent/guide/optimize-rule-accuracy]，提供提升商机识别准确率的7个实用技巧

[8] 参考资料 #

[1] 火山引擎HiAgent官方文档：商机挖掘规则配置指南，https://www.volcengine.com/docs/6719/1270412，2026年06月15日
[2] 2026年Q2 HiAgent产品运营白皮书，https://www.volcengine.com/docs/6719/1302145，2026年07月20日
本文基于HiAgent v3.1.0版本编写。

[9] 文章当前生产日期 #

2026-08-24