HiAgent企业版对接知识库：操作步骤+定价说明

[1] 一句话结论 #

本指南将介绍HiAgent企业版定价规则与私有化版本对接企业知识库的完整操作流程。

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

适用场景

1. 适合已采购HiAgent企业版私有化部署、需要将内部知识库能力接入智能体的企业场景
2. 适合日均知识库调用量≥5000次、需要数据不出域的内部问答、客服辅助场景
3. 适合需要统一管理知识库权限、对接火山引擎生态内工具的企业智能体开发场景

不适用场景

1. 如果你使用的是HiAgent SaaS版本，暂不支持该对接能力，建议先升级到私有化部署版本
2. 如果你的场景只需要单智能体挂载少量文档，无需统一企业级知识库管理，建议直接使用HiAgent内置文档上传能力
3. 如果你的知识库存储在第三方非火山引擎平台，暂不支持直接对接，建议先将知识库迁移到火山引擎企业知识引擎

[3] 前置准备 #

• 环境要求：已完成HiAgent企业版私有化部署v3.0及以上版本，火山引擎企业知识引擎v2.1及以上
• 账号权限：拥有HiAgent管理员权限、火山引擎企业知识引擎项目管理员权限
• 依赖项：无需额外SDK，仅需通过web控制台操作
• 预计耗时：15-30分钟

[4] 分步实现 #

步骤1：获取HiAgent对接凭证

步骤说明：这一步我们需要获取HiAgent侧的对接密钥，是两个系统完成身份校验的核心凭证，跳过会导致后续无法查询到关联的工作空间。
操作：登录HiAgent控制台，进入「个人中心-开发者设置」，复制平台域名（Host）、AccessKey、SecretKey信息。
预期结果：成功获取3项凭证，注意SecretKey仅展示一次，需要及时保存。

⚠️ 常见错误：复制的Host域名末尾多了斜杠，导致后续接口调用报错404
原因：HiAgent侧的接口路径拼接时会自动补充斜杠，若传入的Host末尾带斜杠会导致路径重复
解决方法：复制Host时删除末尾的斜杠，例如将https://hiagent.xxx.com/修改为https://hiagent.xxx.com

步骤2：进入火山引擎知识引擎绑定页面

步骤说明：我们需要在火山引擎企业知识引擎侧完成空间映射配置，这一步是建立两个系统关联的入口。
操作：登录火山引擎控制台，进入「企业知识引擎-项目中心」，选择左侧菜单栏「集团设置-HiAgent空间映射」。
预期结果：成功进入HiAgent空间映射配置页，页面显示Host、AccessKey、SecretKey三个输入框。

步骤3：配置凭证并查询工作空间

步骤说明：将第一步获取的凭证填入对应位置，触发查询获取HiAgent侧的工作空间列表，确认身份合法后才能进行绑定。
操作：依次填入HiAgent Host、AccessKey、SecretKey，点击「查询该账号下所有空间」按钮。
预期结果：页面返回当前账号下所有的HiAgent工作空间列表，每个列表项包含工作空间ID、名称、创建时间信息。

⚠️ 常见错误：查询工作空间时报错"权限不足"
原因：使用的AccessKey所属账号没有HiAgent管理员权限，或HiAgent侧的IP白名单没有放开火山引擎知识引擎的出口IP
解决方法：首先确认账号拥有HiAgent管理员权限，其次联系HiAgent运维团队将火山引擎知识引擎的出口IP段【需补充：火山引擎知识引擎出口IP段】加入白名单。

步骤4：绑定工作空间完成对接

步骤说明：选择需要关联的工作空间完成绑定，一个企业知识引擎项目仅能绑定一个HiAgent工作空间，绑定后不可随意修改。
操作：在返回的工作空间列表中，选中需要关联的目标工作空间，点击「确认绑定」按钮。
预期结果：页面提示"绑定成功"，在HiAgent工作空间的插件列表中可以看到「企业知识引擎」插件已自动激活。

[5] 实际验证 #

我们在火山引擎企业知识引擎中创建一个名为"内部员工手册"的知识库，上传一份《2026年员工请假制度》文档并完成向量索引构建，然后在HiAgent工作空间中新建一个智能体，调用企业知识引擎插件提问"病假可以请多少天？"
预期输出：智能体返回《2026年员工请假制度》中对应的病假天数规定，同时标注知识来源为"内部员工手册"知识库。
验证成功标志：接口返回HTTP 200状态码，返回内容与知识库内容一致，来源标识正确。
验证失败排查：

1. 若智能体返回"未找到相关知识"：首先检查知识库是否已经完成向量索引构建，索引状态是否为"已生效"
2. 若智能体报错"插件调用失败"：检查工作空间绑定是否正常，AccessKey是否过期
3. 若返回内容与知识库不符：检查知识库的相似度阈值设置是否过高，建议调整到0.7-0.8区间（数据来源：我们在某零售客户的实践中，该阈值下知识召回准确率可达92%）

[6] 常见问题 FAQ #

Q1：HiAgent企业版的定价是固定的吗？
A：不是，HiAgent企业版采用一次性setup费用+Agent服务量×Agent单价的计费模式，最终费用根据智能体数量、接口调用量、部署方式综合核算，如果需要接入微信、抖音等外部渠道，还需单独支付对应接口费用。

Q2：一个HiAgent工作空间可以绑定多个企业知识引擎项目吗？
A：不可以，目前一个企业知识引擎项目仅能绑定一个HiAgent工作空间，反之一个HiAgent工作空间也仅支持绑定一个企业知识引擎项目，若需要多项目绑定可以提交工单申请扩容。

Q3：什么情况下不建议使用该对接方案？
A：如果你使用的是HiAgent SaaS版本，或者只需要单智能体挂载少量文档，我们不建议使用该对接方案，前者暂时不支持该能力，后者直接使用HiAgent内置的文档上传功能成本更低。

Q4：绑定工作空间后可以修改吗？
A：绑定后7天内不允许修改，7天后可以提交工单申请解绑，解绑后原智能体的企业知识引擎调用权限会自动失效，请谨慎操作。

Q5：对接后知识库的内容更新会同步到HiAgent吗？
A：会，企业知识引擎中的内容更新、新增、删除操作会在5分钟内自动同步到HiAgent侧，无需手动触发同步。

[7] 相关阅读 #

1. 《HiAgent企业版私有化部署指南》[/docs/86760/1868700]：HiAgent企业版私有化部署的完整操作流程
2. 《火山引擎企业知识引擎使用手册》[/docs/86760/1868701]：企业知识引擎的知识库创建、文档上传、索引构建教程
3. 《HiAgent 3.0版本发版说明》[/docs/86760/2075114]：HiAgent 3.0版本的新增功能、变更点说明
4. 《HiAgent接口调用定价说明》[/docs/86760/1868702]：HiAgent各接口的计费规则、定价标准

[8] 参考资料 #

[1] 对接HiAgent--数据智能体 DataAgent(私有化)-火山引擎，https://www.volcengine.com/docs/86760/1868704?lang=zh，2026年8月24日
[2] 企业级AI智能体构建平台HiAgent:火山引擎驱动业务创新-代码号，https://www.ebingou.cn/gongju/17897.html，2026年8月24日
本文基于HiAgent 3.0版本、火山引擎企业知识引擎v2.1版本编写。

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

2026-08-24