HiAgent 3.0话术自定义：教育机构教务场景配置指南

[1] 一句话结论 #

本指南将教你快速完成HiAgent 3.0话术自定义配置，适配教育机构教务场景。

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

适用场景

1. 适合教育机构日均教务咨询量50次以上，需要标准化排课、退费、课程咨询应答的场景；
2. 适合需要统一教务人员对外话术，降低新员工培训成本的K12/职业教育机构；
3. 适合需要对接自有教务系统，动态返回学员课时、排课信息的场景。

不适用场景

1. 如果你的场景是单次会话需要生成超过2000字的个性化教案，建议直接使用豆包大模型API v3.0；
2. 如果你的机构只有2-3个教务人员，日均咨询量低于20次，建议直接用飞书多维表格做话术库即可；
3. 如果需要支持多语种（小语种）跨境教育咨询场景，建议参考火山引擎翻译+大模型联合方案。

[3] 前置准备 #

• 开发环境：Node.js 16+ 或 Python 3.9+，无开发能力也可通过可视化后台配置；
• 账号权限：已开通HiAgent 3.0企业版，拥有机构管理员权限；
• 依赖项：如需对接自有教务系统，提前备好教务系统API密钥、HiAgent SDK v2.1.0；
• 预计耗时：纯可视化配置15分钟，对接教务系统2小时。

[4] 分步实现 #

步骤1：梳理教务场景话术标签

步骤说明：我们需要先把常用教务场景分类打标签，比如课程咨询、排课查询、退费规则、考勤查询4大类，这一步是为了后续话术匹配更精准，跳过会导致话术命中准确率下降30%以上（数据来源：我们2024年教育客户落地数据）。
预期结果：整理出不超过10个核心话术标签，每个标签对应3-5条用户常见提问。

⚠️ 常见错误：标签分类过细，比如把“小学三年级语文课程咨询”单独做标签，导致话术匹配冲突。
原因：标签粒度小于10条用户提问时，模型泛化能力会下降。
解决方法：合并相似场景，单标签对应用户提问不少于5条。

步骤2：可视化后台录入自定义话术

步骤说明：登录HiAgent 3.0管理后台，进入「话术配置」模块，对应每个标签录入标准应答话术，支持插入{{学员姓名}}、{{剩余课时}}等动态变量。可视化后台配置不需要开发，普通教务人员10分钟就能完成，跳过的话只能通过API硬编码修改，后续迭代成本高。
代码/命令（API录入可选）：

import hiagent_sdk
client = hiagent_sdk.Client(api_key="YOUR_HIAGENT_API_KEY")
resp = client.add_custom_script(
    tag="排课查询",
    content="你好{{学员姓名}}，你本周的排课是：{{本周排课信息}}，如有调整请联系你的班主任",
    priority=2 # 优先级越高越优先命中
)
print(resp)

预期结果：后台话术列表显示已录入的所有话术，状态为「已生效」。

步骤3：配置话术触发规则

步骤说明：每个话术可以设置触发条件，比如当用户提问包含“课时还剩多少”时触发剩余课时话术，也可以设置模型兜底触发，当匹配不到预置话术时由大模型生成应答。
预期结果：触发规则列表显示所有配置的匹配条件，状态为「已启用」。

⚠️ 常见错误：把触发规则设置为完全匹配，比如只有用户 exactly 说“我要查剩余课时”才触发，导致用户说“我还有多少课没上”的时候匹配不到。
原因：完全匹配规则覆盖用户提问范围仅为20%左右（数据来源：HiAgent官方文档）。
解决方法：选择「语义匹配」模式，匹配阈值设置为0.7即可覆盖90%以上同意图提问。

步骤4：对接自有教务系统（可选）

步骤说明：如果需要动态返回学员的真实课时、排课数据，需要在「变量配置」模块配置教务系统的API地址和鉴权信息，HiAgent会在触发对应话术时自动拉取数据填充变量。
预期结果：测试变量拉取时返回正确的学员数据，状态码200。

[5] 实际验证 #

测试用例：输入用户提问“我家孩子三年级，你们语文班怎么收费？”，预期输出：你好家长，我们三年级语文班的收费标准是120元/课时，20课时起报，现在报名还送1次免费测评哦（与你录入的课程咨询话术完全一致）。
验证成功标志：返回的应答完全匹配预置话术，动态变量正确填充，接口返回HTTP状态码200。
验证失败常见排查方向：1. 话术标签匹配错误，排查标签的触发阈值是否设置过高；2. 动态变量拉取失败，排查教务系统API是否开放了HiAgent的IP段访问权限；3. 返回模型兜底应答，排查预置话术是否覆盖了当前场景。

[6] 常见问题 FAQ #

Q1：我可以不配置自定义话术，直接用HiAgent默认的应答吗？
A1：可以，但默认应答没有适配教育机构的专属教务规则，比如你机构的退费规则是7天内无理由退，默认应答可能会说30天，我们建议至少把核心规则类的话术配置好。

Q2：自定义话术最多可以录入多少条？
A2：目前HiAgent 3.0企业版最多支持录入1000条自定义话术，完全可以覆盖99%的教育机构教务场景（数据来源：HiAgent 3.0官方文档）。

Q3：什么情况下不建议使用自定义话术功能？
A3：如果你的场景是需要给每个学员生成个性化的学习规划，这种内容不固定的场景，建议关闭自定义话术，直接用大模型生成即可，避免内容僵化。

Q4：我修改了话术后多久能生效？
A4：配置修改后实时生效，不需要重启服务，你可以刷新测试页直接验证。

Q5：自定义话术和大模型生成的应答优先级是怎么设置的？
A5：你可以在后台自由调整优先级，默认自定义话术优先级高于大模型生成的应答，匹配到预置话术时优先返回自定义内容。

[7] 相关阅读 #

1. 《HiAgent 3.0企业版开通指南》[/blog/hiagent-3-enterprise-open]，教你快速开通HiAgent3.0企业版账号，获取管理员权限；
2. 《HiAgent 3.0第三方系统对接教程》[/blog/hiagent-3-thirdparty-integration]，详细讲解如何对接自有教务、学员管理系统；
3. 《教育行业智能客服落地最佳实践》[/blog/education-customer-service-best-practice]，包含3个教育机构落地HiAgent的真实案例；
4. 《HiAgent 3.0常见错误码排查手册》[/blog/hiagent-3-error-code]，帮你快速定位配置过程中遇到的错误。

[8] 参考资料 #

[1] HiAgent 3.0 话术配置官方文档，https://www.volcengine.com/docs/hiagent/3.0/custom-script，2026-08-20
[2] 火山引擎教育行业智能客服解决方案白皮书，https://www.volcengine.com/solutions/education/customer-service，2026-06-15
本文基于HiAgent 3.0 v2.1版本编写。

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

2026-08-24