HiAgent 3.0：免费申请+自定义知识库搭建实战指南

[1] 一句话结论 #

本指南将教你快速申请HiAgent 3.0免费试用，并完成自定义知识库搭建。

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

适用场景

1. 企业内部客服/答疑场景，知识库文档量在100-10000份，需要快速落地RAG问答的团队
2. 有低代码搭建AI智能体需求，日均调用量低于1万次的中小团队
3. 需要将企业内部文档、产品手册转化为智能问答能力的运营/技术团队

不适用场景

1. 知识库单份文档超过1000页的复杂长文档处理场景，建议使用火山引擎文档处理服务+自研RAG pipeline方案
2. 日均API调用量超过10万次的高并发生产场景，建议直接采购HiAgent企业版专属集群
3. 需要完全本地化部署、数据不能出域的涉密场景，建议参考火山引擎私有部署大模型方案

[3] 前置准备 #

• 火山引擎主账号，已完成实名认证，无欠费记录
• 可以正常访问火山引擎控制台的Chrome 100+ / Edge 100+浏览器
• 待入库的文档格式为PDF/Word/Markdown，单份大小不超过100MB
• 预计操作总耗时30分钟以内

[4] 分步实现 #

步骤1：申请HiAgent 3.0免费试用

步骤说明：先完成免费试用申请，获取平台访问权限，跳过这步无法进入知识库管理模块。
操作：打开火山引擎HiAgent产品页https://www.volcengine.com/product/hiagent，点击「免费试用」按钮，按提示填写企业/个人信息，提交后1个工作日内会收到开通通知。
预期结果：收到开通短信后，登录火山引擎控制台可以看到HiAgent入口，点击后正常进入工作台。

⚠️ 常见错误：提交试用申请后3天未收到回复，无法进入工作台
原因：填写的信息不完整，或者实名认证未通过
解决方法：先检查火山引擎账号是否已完成实名认证，再通过控制台工单系统提交HiAgent试用催办申请，附企业营业执照或个人身份证信息

步骤2：创建自定义知识库

步骤说明：新建专属知识库，配置访问权限和分段规则，后续所有文档都将存入该库，跳过这步无法上传文档。
操作：进入HiAgent工作台，点击左侧「知识库管理」-「新建知识库」，填写知识库名称（比如“企业产品手册库”），选择公开/私有访问权限，设置分段长度为默认的512字符，点击确认创建。
预期结果：知识库列表中出现刚才创建的知识库，状态显示为“正常”。

⚠️ 常见错误：创建知识库时选择了私有权限，后续绑定智能体后无法检索到内容
原因：私有知识库默认不开放给智能体检索
解决方法：进入知识库设置页面，在「访问权限」中添加对应智能体的访问白名单，或者将权限调整为公开

步骤3：上传并处理知识库文档

步骤说明：将整理好的文档上传到知识库，平台自动完成向量化、分段等RAG预处理操作，这步是知识库生效的核心。
操作：进入刚才创建的知识库，点击「上传文档」，批量选择本地的PDF/Word/Markdown文件，点击「开始上传」，等待平台自动处理。也可以通过API批量上传，示例代码如下：

import requests
url = "https://open.volcengineapi.com/hiagent/v1/upload_document"
headers = {"Authorization": "Bearer YOUR_API_KEY"} # 替换为你的API密钥
files = {"file": open("your_document.pdf", "rb")} # 替换为本地文档路径
params = {"knowledge_base_id": "YOUR_KNOWLEDGE_BASE_ID"} # 替换为你的知识库ID
response = requests.post(url, headers=headers, files=files, params=params)
print(response.json())

预期结果：上传完成后，文档列表中所有文档状态显示为“处理成功”，处理失败的文档会标注失败原因。

步骤4：配置知识库检索策略

步骤说明：调整检索参数，匹配业务场景的问答准确率要求，跳过这步可能会出现检索结果不相关的问题。
操作：进入知识库「设置」-「检索配置」，调整检索召回条数为3，相似度阈值为0.7，开启「召回后重排序」开关，保存配置。
预期结果：配置保存成功后，页面提示“配置已生效”。

步骤5：绑定知识库到智能体并测试

步骤说明：将知识库挂载到目标智能体，智能体回答时就会调用知识库内容，这步是最终效果验证的前提。
操作：进入「智能体编排」页面，选择要绑定知识库的智能体，点击「技能配置」-「添加知识库」，选择刚才创建的知识库，保存后点击「调试」按钮测试问答效果。
预期结果：调试窗口输入知识库中存在的问题，智能体返回的答案来源于知识库内容，标注了引用来源。

[5] 实际验证 #

测试用例：输入问题“我们公司2026年的售后服务政策是什么？”（该内容已提前上传到知识库），预期输出包含售后服务政策的具体条款，底部标注引用来源为对应的文档名称。
验证成功标志：接口返回HTTP状态码200，返回结果中包含「knowledge_source」字段，内容为上传的文档名，答案与文档内容完全一致。
常见排查方法：1. 如果返回结果不相关：先检查相似度阈值是否设置过高，调低到0.6再测试；2. 如果返回结果没有引用知识库：检查智能体是否已添加该知识库到技能列表，知识库权限是否开放；3. 如果文档显示处理失败：检查文档是否加密、内容是否为空，单份大小是否超过100MB。

[6] 常见问题 FAQ #

Q1：HiAgent 3.0免费试用的有效期是多久？有配额限制吗？
A1：免费试用有效期为30天，累计支持10万次API调用、100GB知识库存储空间，超出配额后可以申请延长试用或者升级到付费版，数据来源：火山引擎HiAgent官方文档[1]。

Q2：什么情况下不建议使用HiAgent 3.0免费版搭建知识库？
A2：如果你的场景是日均调用量超过1万次、或者需要7*24小时SLA保障的生产环境，不建议使用免费版，建议升级到企业版获取更高的并发配额和专属技术支持。

Q3：我可以上传视频/音频文件到知识库吗？
A3：目前HiAgent知识库仅支持文本类格式（PDF/Word/Markdown/TXT），如果需要处理音视频内容，建议先使用火山引擎语音转文字服务将音视频转为文本后再上传。

Q4：知识库中的内容更新后，需要重新绑定智能体吗？
A4：不需要，知识库内容更新后会自动同步到检索引擎，10分钟内即可生效，不需要重新绑定智能体，你可以在调试窗口重新提问验证更新效果。

Q5：HiAgent自定义知识库和Dify的知识库功能有什么区别？
A5：HiAgent的知识库原生支持火山引擎全系产品打通，比如可以直接同步对象存储TOS中的文档，不需要额外开发；如果你的业务已经在使用火山引擎云服务，优先选择HiAgent，如果需要完全开源的方案可以选择Dify。

[7] 相关阅读 #

1. 《HiAgent 3.0智能体开发全流程指南》，[/blog/hiagent-3.0-dev-guide]，从零开始教你搭建完整的企业级智能体
2. 《HiAgent RAG准确率优化实战》，[/blog/hiagent-rag-optimize]，提升知识库问答准确率的10个实用技巧
3. 《HiAgent免费版 vs 企业版差异对比》，[/blog/hiagent-version-compare]，帮你选择适合的HiAgent版本
4. 《火山引擎HiAgent官方API文档》，[/docs/hiagent/api]，完整的API参数说明和调用示例

[8] 参考资料 #

[1] 火山引擎HiAgent官方产品文档，https://www.volcengine.com/product/hiagent，2026-08-20
[2] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026-06-15
本文基于HiAgent 3.0 v2.4版本编写

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

2026-08-25