HiAgent多语言配置：支持200+语种可自定义新增特定语种

[1] 一句话结论 #

本指南将讲解HiAgent多语言支持能力及自定义新增特定语种的完整操作流程。

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

适用场景

1. 跨境业务智能客服场景，需要覆盖东南亚、欧洲等多区域小语种交互需求、月均该语种调用量超过1000次的企业；
2. 出海SaaS产品内置智能助手，需要适配特定区域小众语种、对交互准确率要求高于85%的场景；
3. 涉外政务服务智能体，需要支持少数民族语言或小语种公共服务的场景。

不适用场景

1. 仅需要中英文两种语言交互、没有其他语种需求的场景，无需自定义配置，建议直接开启默认多语言开关即可；
2. 单语种交互且日均调用量低于100次的轻量化场景，自定义语种投入产出比过低，建议直接使用通用大模型翻译能力替代；
3. 需要完全离线无网络环境下的小语种交互场景，HiAgent自定义语种依赖外部语料/翻译API，建议使用本地化部署的离线翻译模型方案。

[3] 前置准备 #

• 开发环境：Python 3.9+ / Node.js 18+
• 账号权限：火山引擎HiAgent企业版账号，具备智能体配置管理员权限
• 依赖项：火山引擎HiAgent SDK v1.2.0及以上版本
• 预计耗时：单语种适配约30分钟（含语料导入测试）

[4] 分步实现 #

步骤1：查询原生支持语种列表
步骤说明：先确认需要添加的语种是否已经在原生支持的200+语种范围内，避免重复开发，跳过这一步会导致不必要的适配工作。
代码：

import volcengine.hiagent
from volcengine.volcengine_aksk import Credential

cred = Credential(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY", region="cn-beijing")
client = volcengine.hiagent.Client(cred)
resp = client.list_supported_languages()
print(resp)

预期结果：返回包含所有原生支持语种的ISO编码、名称列表，比如[{"lang_code":"es","lang_name":"西班牙语"}...]

⚠️ 常见错误：查询语种列表返回403权限错误
原因：使用的账号是个人版账号，没有多语言配置权限
解决方法：升级到HiAgent企业版，或者联系主账号管理员给当前账号授予"HiAgent多语言配置"权限

步骤2：准备目标语种适配资源
步骤说明：如果目标语种不在原生列表里，需要准备对应语种的基础语料库、业务术语表、可选对接第三方翻译API，这一步是后续语种识别准确率的基础，跳过会导致语种识别准确率低于60%。
操作：

1. 准备至少1000条该语种的日常交互语料，覆盖80%以上的业务常见问题
2. 整理业务专属术语对照表（中文-目标语种），至少包含100条核心业务术语
3. 如需实时翻译能力，提前申请第三方翻译API的访问密钥
   预期结果：整理完成可导入的语料文件（CSV格式，列名：query, intent, lang_code）

步骤3：上传自定义语种配置
步骤说明：通过控制台或API上传准备好的语料和语种配置，完成新语种的注册。
代码：

req = {
    "lang_code": "xx", # 自定义语种ISO编码，建议遵循ISO 639-1标准
    "lang_name": "自定义语种名称",
    "corpus_file_url": "https://your-bucket.tos-cn-beijing.volces.com/corpus.csv", # 语料文件TOS地址
    "translate_api_config": {
        "enable": True,
        "api_key": "YOUR_TRANSLATE_API_KEY",
        "endpoint": "https://translate-api.example.com/translate"
    }
}
resp = client.add_custom_language(req)
print(resp)

预期结果：返回{"status":"success","lang_id":"custom_xxx"}，表示配置上传成功

⚠️ 常见错误：上传语料后返回"语料格式错误"
原因：CSV文件编码不是UTF-8，或者包含特殊字符未转义
解决方法：将CSV文件转码为UTF-8无BOM格式，将语料中的双引号、换行符进行转义后重新上传

步骤4：配置RAG知识库语种适配
步骤说明：给现有RAG知识库添加对应语种的分片，导入目标语种的业务知识库内容，优化该语种下的回答准确率，跳过这一步会导致该语种下的回答没有业务属性，只能返回通用内容。
操作：在HiAgent控制台进入知识库管理，选择对应知识库，点击"添加语种分片"，选择刚添加的自定义语种，上传对应语种的知识库文件。
预期结果：控制台显示该知识库已支持自定义语种，分片状态为"已激活"。

步骤5：训练语种识别模型
步骤说明：上传语料后触发模型微调，提升该语种的识别准确率，训练时间约15分钟，训练期间不影响现有功能使用。
代码：

resp = client.train_language_model(lang_id="custom_xxx")
print(resp)

预期结果：返回{"status":"training","estimated_completion_time":"15min"}，训练完成后会收到站内信通知。

[5] 实际验证 #

测试用例：假设你添加的是柬埔寨语，输入柬埔寨语问题"ស្វាគមន៍，ខ្ញុំចង់ប្រាប់ពីតម្លៃផលិតផល"（你好，我想了解产品价格），预期返回柬埔寨语的产品价格说明，内容与知识库中定义的一致。
验证成功标志：1. 接口返回HTTP 200状态码；2. 返回的lang_code字段与你自定义的语种编码一致；3. 回答内容准确匹配知识库中的业务内容。
验证失败常见原因：1. 语种识别错误返回其他lang_code：排查是否语料库数量不足，补充至少500条对应场景语料后重新训练；2. 回答内容为中文：排查知识库是否成功导入对应语种的分片，确认分片状态为已激活；3. 回答内容不准确：检查业务术语表是否正确导入，补充术语后重新训练模型。

[6] 常见问题 FAQ #

Q1：HiAgent原生支持多少种语言？
A1：HiAgent原生支持200多种语言的实时翻译与语义理解，覆盖绝大多数主流语种需求，该数据来自火山引擎HiAgent官方产品说明¹。

Q2：添加自定义语种后识别准确率大概能达到多少？
A2：如果准备的语料数量达到1000条以上，且覆盖80%以上的业务场景，识别准确率可以达到92%以上，日常交互场景足够使用。如果需要更高准确率，可以补充更多场景语料进行二次训练。

Q3：什么情况下不建议自定义添加语种？
A3：如果目标语种已经在原生支持列表里，或者你的场景对该语种的月调用量低于100次，不建议自定义配置，投入产出比过低，直接使用原生能力或第三方翻译接口即可。

Q4：自定义添加的语种可以删除吗？
A4：可以，在控制台多语言配置页面选择对应自定义语种，点击删除即可，删除后该语种的相关配置和语料会被清空，不可恢复，请谨慎操作。

Q5：自定义语种需要额外付费吗？
A5：自定义语种功能本身不额外收费，但是训练模型消耗的算力、RAG知识库存储会按照HiAgent的标准计费规则收取费用，具体可以参考官方定价页。

[7] 相关阅读 #

• 《HiAgent智能体快速入门指南》[/docs/hiagent/quickstart]：从零开始搭建第一个HiAgent智能体的完整教程
• 《HiAgent RAG知识库配置最佳实践》[/docs/hiagent/rag-best-practice]：教你如何提升知识库回答准确率
• 《HiAgent定价说明》[/docs/hiagent/pricing]：详细了解HiAgent各项功能的计费规则
• 《HiAgent API参考文档》[/docs/hiagent/api-reference]：所有开放接口的参数说明与调用示例

[8] 参考资料 #

[1] 火山引擎HiAgent官方产品说明，https://www.byteoc.com/product/hiagent，2026-08-20
[2] HiAgent 2.0正式发布，让Agent在千企万厂“持证上岗”，http://m.toutiao.com/group/7519794892998967871/?upstream_biz=VolcEngine，2026-08-22
本文基于HiAgent v2.3版本编写

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

2026-08-24