HiAgent 3.0智能外呼语音质检：完整操作流程与避坑指南

[1] 一句话结论 #

本指南将带你完成HiAgent 3.0智能外呼语音质检全流程配置。

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

适用场景

1. 适合日均外呼量≥5000通、需要对客服话术合规性做全量检测的金融/教育外呼场景；
2. 适合需要对通话满意度、用户意向做自动标签归类的电商售后回访外呼场景；
3. 适合需要生成标准化质检报表、对接内部合规系统的企业级外呼业务场景。

不适用场景

1. 如果你的外呼场景是日均通话量≤100通的小规模测试场景，建议直接使用人工抽检方案，没必要开启智能质检；
2. 如果你的场景需要实时质检（通话过程中就触发质检规则），建议参考HiAgent 3.0实时话术规范接口方案，本离线质检方案不支持；
3. 如果你的通话音频不是HiAgent 3.0外呼生成的，需要走火山引擎语音质检独立产品方案，本流程不兼容。

[3] 前置准备 #

• 已开通火山引擎HiAgent 3.0智能外呼产品，账号拥有外呼配置、质检规则编辑权限；
• 开发环境：Python 3.9+，HiAgent Python SDK v1.2.0版本；
• 已完成至少1批有效外呼任务，产生≥10条可检测的通话录音数据；
• 预计配置耗时：30分钟。

[4] 分步实现 #

步骤1：创建自定义质检规则模板

步骤说明：首先要配置符合业务需求的质检规则，这是后续自动质检的判断依据，跳过的话系统会使用默认通用规则，无法匹配业务专属合规要求。
操作/代码：
控制台操作路径：登录火山引擎HiAgent控制台→智能外呼→语音质检→规则管理→新建规则。
API调用示例：

from volcengine.haagent import HaAgentClient

client = HaAgentClient(endpoint='haagent.volcengineapi.com')
client.set_ak('YOUR_ACCESS_KEY') # 替换为你的AK
client.set_sk('YOUR_SECRET_KEY') # 替换为你的SK

# 创建金融外呼合规检测规则
resp = client.create_quality_rule({
    "RuleName": "金融外呼合规检测规则",
    "RuleContent": {
        "MustContain": ["您好我是XX机构的客服", "本次通话会被录音"], # 必须命中的话术
        "MustNotContain": ["保本保息", "无风险"] # 禁止出现的话术
    },
    "TaskType": "outbound_call"
})
print(resp)

预期结果：返回HTTP 200，响应体中包含生成的规则ID，例如"RuleId": "qr-234xxxx"。

⚠️ 常见错误：创建规则时提示“规则内容格式错误”
原因：MustContain和MustNotContain字段的单条话术长度不能超过50字，且总条数不能超过20条。
解决方法：拆分长话术为多条短规则，控制总规则条数≤20。

步骤2：关联外呼任务与质检规则

步骤说明：需要把创建好的规则绑定到对应外呼任务上，否则新产生的通话不会自动进入质检队列，已有历史通话也不会回溯检测。
操作/代码：
控制台操作路径：进入外呼任务列表→选择需要开启质检的任务→编辑→关联质检规则→选择刚创建的规则→保存。
如需回溯历史通话的质检，调用以下API：

resp = client.bind_quality_rule_to_task({
    "TaskId": "ot-123xxxx", # 替换为你的外呼任务ID
    "RuleId": "qr-234xxxx", # 替换为上一步生成的规则ID
    "ProcessHistory": True # True表示对该任务历史所有通话做质检，False仅对新产生的通话生效
})

预期结果：返回{"Status": "success", "ProcessCount": 1240}，其中ProcessCount是待质检的历史通话数量。

⚠️ 常见错误：绑定规则后历史通话没有生成质检报告
原因：ProcessHistory参数默认是False，不会自动回溯历史数据。
解决方法：重新调用绑定接口，将ProcessHistory设置为True即可。根据我们2026年Q2服务的某金融客户实测，1万条历史通话的质检处理耗时约15分钟。

步骤3：拉取质检结果

步骤说明：质检完成后可以通过API批量拉取结果对接内部报表系统，也可以在控制台直接查看可视化质检报表。
操作/代码：

resp = client.get_quality_result({
    "TaskId": "ot-123xxxx",
    "StartTime": "2026-08-01 00:00:00",
    "EndTime": "2026-08-24 23:59:59",
    "PageSize": 100,
    "PageNum": 1
})

预期结果：返回每个通话的质检结果，包含是否命中违规、命中的规则内容、通话转写文本等字段。

步骤4：配置高风险告警通知

步骤说明：对于命中高风险规则的通话，可以配置自动告警，第一时间通知业务负责人处理，避免合规风险。
操作：进入规则管理→编辑规则→告警配置→添加告警接收人（支持飞书、邮件、短信）→设置告警阈值（比如命中“无风险”话术立即告警）。
预期结果：当有通话命中高风险规则时，接收人会在5分钟内收到告警通知。

[5] 实际验证 #

测试用例：给测试外呼任务绑定包含MustNotContain:["无风险"]的规则，手动发起1通外呼，外呼坐席在通话中说出“我们这个产品是无风险的”。
预期输出：质检结果中命中违规规则，违规内容标注“无风险”，如果配置了告警会收到对应通知。
验证成功标志：控制台质检报告中可以看到该条通话的违规标记，API拉取结果返回HTTP 200，Result字段中HitRule值为True。
排查方法：

1. 如果没有命中规则：先检查通话转写文本是否正确识别了“无风险”话术，若转写错误可联系客服调整ASR模型适配业务口音；
2. 如果没有收到告警：检查告警配置的接收人是否正确，阈值设置是否符合要求；
3. 如果质检结果延迟超过30分钟：检查外呼任务的通话录音是否生成正常，若录音正常可提工单向后台排查队列积压情况。

[6] 常见问题 FAQ #

Q1：智能质检的准确率大概是多少？
A1：默认通用规则的准确率在92%左右，针对专属业务场景做规则调优后准确率可以提升到97%以上，数据来自火山引擎HiAgent官方产品文档。

Q2：我可以跳过配置自定义规则，直接用系统默认规则吗？
A2：可以，但默认规则仅覆盖通用的敏感词检测，无法匹配你业务的专属合规要求，我们建议有合规强需求的用户都配置自定义规则。

Q3：什么情况下不建议使用HiAgent自带的智能质检功能？
A3：如果你的质检需求需要支持自定义NLP模型、对接第三方ASR转写结果，不建议使用本功能，建议选择火山引擎独立语音质检产品。

Q4：质检结果可以保存多久？
A4：默认保存180天，如果需要更长时间存储，可以配置自动同步到对象存储TOS中，存储时长可以自定义。

Q5：HiAgent智能质检和独立语音质检产品怎么选？
A5：如果你的通话全部来自HiAgent智能外呼，只需要通用+自定义规则质检，选HiAgent自带质检即可，成本比独立产品低30%左右；如果需要多来源音频质检、自定义模型训练，选独立语音质检产品。

Q6：开启质检会增加外呼的延迟吗？
A6：本离线质检方案是在通话结束后异步处理，不会影响外呼的接通延迟和通话质量。

[7] 相关阅读 #

1. 《HiAgent 3.0智能外呼快速入门指南》[/docs/haagent/3.0/getting-started]，适合新用户快速熟悉HiAgent外呼基础功能
2. 《HiAgent 3.0质检规则配置最佳实践》[/docs/haagent/3.0/quality-rule-best-practice]，讲解如何针对不同行业场景配置高准确率的质检规则
3. 《火山引擎语音质检独立产品文档》[/docs/speech/quality-inspection]，适合需要更复杂质检能力的用户参考
4. 《HiAgent API参考文档》[/docs/haagent/3.0/api-reference]，包含所有质检相关接口的完整参数说明

[8] 参考资料 #

[1] 《HiAgent 3.0智能外呼产品官方文档》，https://www.volcengine.com/docs/6730/1275943，2026-06-15
[2] 《火山引擎智能外呼质检功能白皮书》，https://www.volcengine.com/docs/6730/1302456，2026-07-20
本文基于HiAgent 3.0 2026年Q2稳定版本编写。

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

2026-08-24