HiAgent售前商机挖掘：可识别92%+客户隐藏商机需求
[1] 一句话结论
本指南将介绍HiAgent识别客户隐藏售前商机需求的实现方法与落地注意事项。
[2] 适用场景与不适用场景
适用场景
- 客服会话日均量≥500条、需要从全量对话中自动挖掘高意向售前客户的企业服务场景
- SaaS产品官网智能咨询窗口，需要自动识别用户潜在付费需求并分配对应销售跟进的场景
- 电商平台售后会话中，需要挖掘用户复购、升级产品等隐藏售前需求的场景
不适用场景
- 单条会话上下文长度超过8000token的长文本咨询场景，建议使用火山引擎长文本预处理接口先做内容切片再对接HiAgent
- 客户咨询内容以方言、小众行业黑话为主且无对应行业词库的场景，建议先使用自定义实体识别接口训练专属词库再使用
- 日均会话量低于100条的小体量场景，建议直接使用人工标注即可，无需对接本方案
[3] 前置准备
- 开发环境：Python 3.9+ / Node.js 18+
- 账号权限：已开通火山引擎HiAgent商业版账号，且拥有商机挖掘功能的API调用权限
- 依赖项：volcengine-python-sdk v1.0.23及以上版本
- 预计耗时：完整配置+联调约2小时
[4] 分步实现
步骤1：开通商机挖掘功能并获取API密钥
步骤说明：首先要在控制台开启HiAgent的售前商机识别能力，获取专属的API密钥，这一步是身份鉴权的必要条件，跳过会导致所有接口请求返回403无权限错误。
操作指引：进入火山引擎HiAgent控制台→功能管理→商机挖掘→勾选“开启隐藏需求识别”→复制AK/SK
预期结果：控制台显示“功能已开启”，可查看到AK、SK两个字符串
⚠️ 常见错误：复制密钥时多复制了末尾的空格，导致鉴权失败
原因：控制台复制按钮默认会选中末尾的空白字符，很多开发者没有注意校验
解决方法：粘贴后手动去掉字符串前后的空白字符，或者使用trim()方法处理密钥参数
步骤2：配置自定义商机识别规则
步骤说明：根据自身行业特性配置需要识别的隐藏商机标签，比如ToB SaaS行业可以配置“需求演示”“询问报价”“寻求定制”等标签，这一步可以大幅提升识别准确率，跳过的话默认使用通用行业标签，准确率会下降约15%。
代码示例：
import volcengine.maas.v2 as maas from volcengine.maas.v2.models.hiagent import * client = maas.Client(endpoint='https://maas-api.volcengineapi.com') client.set_ak('YOUR_AK') # 替换为你的AK client.set_sk('YOUR_SK') # 替换为你的SK req = SetBusinessRuleRequest( app_id="YOUR_HiAGENT_APP_ID", # 替换为你的HiAgent应用ID rule_list=[ {"tag": "demo需求", "keywords": ["演示", "试用", "看效果"]}, {"tag": "购买意向", "keywords": ["多少钱", "报价", "怎么收费"]} ] ) resp = client.hiagent.set_business_rule(req)
预期结果：返回HTTP 200，响应体中code为0，msg为"success"
步骤3：接入会话数据同步接口
步骤说明：将你的客服系统实时产生的会话内容同步给HiAgent接口，需要同步近3轮的上下文对话，仅同步单条用户消息会导致隐藏需求识别准确率大幅下降。
代码示例：
req = SyncSessionRequest( app_id="YOUR_HiAGENT_APP_ID", session_id="CUSTOM_SESSION_ID_12345", # 替换为你的会话唯一ID context=[ {"role": "user", "content": "你们这个系统能支持100人同时在线使用吗"}, {"role": "assistant", "content": "您好，支持的，我们最高可支持单企业1000人同时在线"}, {"role": "user", "content": "那企业版年付有优惠吗"} ] ) resp = client.hiagent.sync_session(req)
预期结果：返回商机识别结果，包含是否有隐藏商机、商机标签、置信度分数
⚠️ 常见错误：同步的会话上下文角色搞反，把assistant的内容标成了user
原因：很多客服系统的会话存储里角色标识和HiAgent要求的不匹配，开发者直接映射导致错误
解决方法：调用接口前先校验角色字段，确保用户输入对应role为user，客服输出对应role为assistant
步骤4：配置商机触发回调
步骤说明：配置Webhook回调地址，当HiAgent识别到高置信度（≥80分）的隐藏商机时，会自动推送结果到你的业务系统，无需轮询查询，节省API调用成本。
操作指引：进入HiAgent控制台→回调配置→添加回调地址→选择“商机识别结果推送”事件，填写接收地址并测试连通性
预期结果：测试推送返回HTTP 200，控制台显示“回调配置成功”
步骤5：上线前灰度测试
步骤说明：先拿历史1000条标注好的会话数据做批量测试，确保识别准确率符合业务要求再全量上线，避免全量上线后误判过多影响业务。
预期结果：批量测试准确率≥92%（数据来源：火山引擎HiAgent 2026年Q2功能性能报告¹）
[5] 实际验证
测试用例输入：
会话上下文：
[
{"role": "user", "content": "你们这个工具能做合同自动审核吗？"},
{"role": "assistant", "content": "您好，支持的，我们覆盖了全行业200+合同模板的审核能力"},
{"role": "user", "content": "那能不能帮我们对接一下内部的OA系统，我们想直接在OA里用"}
]
预期输出：
{"has_business_opportunity": true, "tag": "定制需求", "confidence": 94}
验证成功标志：HTTP状态码为200，返回的has_business_opportunity字段为true，置信度分数≥80
验证失败常见原因及排查：
- 返回403：检查AK/SK是否正确，是否开通了商机挖掘功能
- 识别结果准确率低：检查是否配置了行业专属的识别规则，是否同步了至少3轮上下文对话
- 回调收不到消息：检查回调地址是否可以公网访问，是否拦截了火山引擎的IP段
[6] 常见问题 FAQ
Q1：HiAgent识别客户隐藏售前商机的准确率是多少？
A1：在配置了对应行业专属识别规则、同步完整3轮上下文的情况下，识别准确率可达92%以上，数据来自火山引擎HiAgent 2026年Q2官方性能报告。如果是通用行业无自定义规则的场景，准确率约为78%。
Q2：识别一条会话的商机需要多长时间？
A2：单条会话的识别延迟平均为200ms，最高不超过500ms，完全满足实时会话场景的需求。
Q3：什么情况下不建议使用HiAgent的隐藏商机识别功能？
A3：如果你的场景是单条会话长度超过8000token的长文本咨询，或者客户咨询内容以方言、小众行业黑话为主且没有自定义词库，我们不建议直接使用，前者建议先做长文本切片，后者建议先训练专属实体词库再对接。
Q4：我可以跳过自定义规则配置步骤，直接使用默认规则吗？
A4：可以，但默认规则是通用行业模板，识别准确率会比配置了专属规则的场景低15%左右，如果你的业务对准确率要求较高，我们不建议跳过这一步。
Q5：商机识别的置信度分数阈值可以自己调整吗？
A5：可以，你可以在控制台的商机挖掘设置里自定义阈值，比如对准确率要求高的场景可以设置为90分，对召回率要求高的场景可以设置为70分。
Q6：商机识别功能怎么收费？
A6：按照调用量计费，每千次调用收费2.5元，具体可以参考HiAgent官方定价文档。
[7] 相关阅读
- 《HiAgent商机挖掘功能官方文档》[/docs/hiagent/function/business-mining]，介绍HiAgent商机挖掘的所有能力参数及接口说明
- 《HiAgent自定义规则配置最佳实践》[/blog/hiagent-rule-config-best-practice]，教你如何配置规则最大化识别准确率
- 《火山引擎长文本预处理接口使用指南》[/docs/nlp/long-text-process]，适配长会话场景的预处理方案
- 《HiAgent定价说明》[/docs/hiagent/pricing]，详细介绍商机挖掘功能的计费规则
[8] 参考资料
[1] 《火山引擎HiAgent 2026年Q2功能性能报告》，https://www.volcengine.com/docs/hiagent/reports/2026q2-performance，2026-07-15
[2] 《HiAgent售前商机挖掘功能官方文档》，https://www.volcengine.com/docs/hiagent/function/business-mining，2026-08-01
本文基于HiAgent v3.2.0版本编写
[9] 文章当前生产日期
2026-08-24
