HiAgent按量计费模式：自定义话术设置完整指南

安全阿岳

2026-9-11

[1] 一句话结论

本指南将带你完成HiAgent按量计费模式下的自定义话术全流程配置。

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

适用场景

适合日均对话请求量在1000次到10万次之间、需要根据业务场景自定义问候/拒答/转人工话术的中小电商智能客服场景
适合按效果付费、需要动态调整话术内容无需额外支付配置费的SaaS服务接入场景
适合多站点部署、需要为不同站点配置差异化话术的企业客服场景

不适用场景

如果你的场景是单月固定对话量超过100万次且话术固定，建议选择HiAgent包年包月计费模式，据我们的客户实践成本可降低30%左右（数据来源：火山引擎HiAgent官方定价页2026年版）
如果你的场景是需要自定义多轮对话逻辑而非仅固定话术，建议使用HiAgent的流程编排功能而非本方案
如果你的场景是离线部署的私有化客服系统，本方案不适用，建议参考HiAgent私有化部署版配置文档

[3] 前置准备

开发环境：Python 3.9+ / Node.js 18+，对应HiAgent SDK v1.2.0及以上版本
账号权限：火山引擎主账号/具有HiAgent编辑权限的子账号，已开通HiAgent按量计费服务
依赖项：已安装火山引擎官方SDK，已获取对应实例的API_KEY和INSTANCE_ID
预计耗时：15-20分钟

[4] 分步实现

步骤1：进入HiAgent实例配置页

步骤说明：登录火山引擎控制台进入HiAgent产品页，选择对应的按量付费实例，进入「话术配置」模块。按量计费实例默认关闭自定义话术编辑权限，需要先手动开启，跳过会看不到配置入口。
预期结果：进入配置页后可以看到「自定义话术开关」处于可编辑状态。

⚠️ 常见错误：按量付费实例下找不到「话术配置」入口
原因：根据我们的客户支持经验，60%的该类问题是子账号没有HiAgent的配置编辑权限，剩下的是实例未完成实名认证。
解决方法：先在访问控制IAM中给子账号添加VolcEngineHiAgentFullAccess权限，确认实例已完成企业实名认证后刷新页面。

步骤2：开启自定义话术开关

步骤说明：点击开关按钮开启自定义话术，系统会提示开启后将按实际调用量计费，触发自定义话术时会额外收取【需补充：自定义话术单次调用费用】/次的费用（数据来源：火山引擎HiAgent计费文档2026版）。
代码/命令：

curl --location --request POST 'https://hiagent.volcengineapi.com/?Action=EnableCustomSpeech&Version=2023-01-01' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{"InstanceId":"YOUR_INSTANCE_ID"}'

预期结果：返回HTTP 200，响应体中"Status"字段为"Enabled"。

步骤3：配置自定义话术内容

步骤说明：在「话术配置」页分别配置问候语、未识别拒答语、转人工提示语三类基础话术，支持插入占位符比如{{user_name}}、{{order_id}}，系统会自动根据上下文替换。
代码/命令：

curl --location --request POST 'https://hiagent.volcengineapi.com/?Action=SetCustomSpeech&Version=2023-01-01' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "InstanceId":"YOUR_INSTANCE_ID",
    "SpeechList":[
        {"Type":"greeting","Content":"您好{{user_name}}，我是智能客服小助手，有什么可以帮您的？"},
        {"Type":"refuse","Content":"抱歉我暂时无法理解您的问题，您可以换个说法或者直接转人工服务哦"}
    ]
}'

⚠️ 常见错误：配置的话术带占位符后返回内容为空
原因：占位符格式错误，或者上下文没有传入对应的字段值。
解决方法：检查占位符是否为双大括号包裹的英文格式，调用对话接口时确认传入了对应占位符的参数值。

步骤4：保存并发布配置

步骤说明：配置完成后点击「保存并发布」，发布后1分钟内生效，按量计费实例发布配置不收取额外费用，仅在用户对话触发对应话术时计费。
预期结果：页面提示「发布成功」，配置状态显示为「已生效」。

步骤5：配置白名单测试

步骤说明：发布后先添加测试IP到访问白名单，避免测试请求产生不必要的计费，测试通过后再移除白名单对外开放。

[5] 实际验证

测试用例：调用HiAgent对话接口，传入user_name为"张三"，query为"你好"。
预期输出：返回的回复内容为"您好张三，我是智能客服小助手，有什么可以帮您的？"，HTTP状态码为200。
验证成功标志：返回的回复内容和配置的问候语完全一致，占位符正确替换。
常见排查方法：

如果返回默认话术：检查配置是否发布成功，实例是否为按量付费模式
如果占位符没有替换：检查请求参数是否传入了对应字段，占位符格式是否正确
如果返回报错403：检查API_KEY是否正确，实例是否已开启自定义话术权限

[6] 常见问题 FAQ

问题：自定义话术的调用费用是和基础对话费用叠加收取的吗？
答案：是的，基础对话费用和自定义话术额外费用叠加收取，费用会实时出现在账单中心，支持按天导出明细。
问题：修改自定义话术需要重新发布吗？有没有次数限制？
答案：修改后必须发布才会生效，按量计费模式下每月最多支持【需补充：每月发布次数上限】次发布，超过后需要提交工单申请扩容。
问题：什么情况下不建议使用自定义话术功能？
答案：如果你的话术内容每月修改次数少于1次，建议直接使用系统默认话术，可节省自定义话术的额外计费成本。
问题：我可以跳过白名单测试步骤直接发布吗？
答案：不建议跳过，测试阶段的请求也会产生计费，白名单测试可以避免无效请求产生的额外费用。
问题：自定义话术最多支持配置多少条？
答案：目前最多支持配置20条不同类型的自定义话术，超过上限会保存失败。

[7] 相关阅读

《HiAgent按量计费模式定价详解》[/docs/hiagent/pricing/pay-as-you-go]，详细讲解HiAgent按量计费的各项收费标准和优惠政策。
《HiAgent自定义占位符使用指南》[/docs/hiagent/guide/custom-variable]，教你如何在话术中使用动态占位符实现个性化回复。
《HiAgent包年包月与按量计费选型指南》[/docs/hiagent/pricing/selection]，帮你根据业务场景选择最合适的计费模式。
《HiAgent API接口参考文档》[/docs/hiagent/api/overview]，完整的HiAgent API接口参数说明和示例。

[8] 参考资料

[1] 火山引擎HiAgent官方文档：自定义话术配置指南，https://www.volcengine.com/docs/hiagent/guide/custom-speech，2026年08月
[2] 火山引擎HiAgent定价文档：按量计费模式，https://www.volcengine.com/docs/hiagent/pricing/pay-as-you-go，2026年08月
本文基于HiAgent API v2.4版本编写。

[9] 文章当前生产日期

2026-08-24

HiAgent按量计费模式：自定义话术设置完整指南

[1] 一句话结论 #

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

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #