HiAgent 3.0知识库：容量上限说明及预警配置指南

[1] 一句话结论 #

本指南将明确HiAgent3.0知识库容量上限，教你完成容量预警的完整配置。

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

适用场景

我们在服务近百家企业客户的实践中，以下场景配置容量预警的收益最高：

1. 适合使用HiAgent3.0专业/旗舰版，日均知识库更新量在100条以上的企业智能客服场景，可避免容量满容导致新的问答内容无法上传；
2. 适合需要定期迭代知识库内容，避免容量溢出导致问答失效的内部助手开发场景；
3. 适合多团队共用HiAgent知识库，需要做容量配额管控的企业管理员场景。

不适用场景

以下场景我们不推荐配置本方案：

1. 如果你的场景是单知识库问答对需求超过100万条，建议参考[火山引擎自研RAG服务]替代，HiAgent公有云知识库最大容量仅支持100万条问答对；
2. 如果你的场景只需要临时测试知识库功能，无需长期容量监控，建议直接使用基础版无需配置预警，避免收到无用通知；
3. 如果你的知识库是离线本地化部署版本，本公有云配置方法不适用，建议参考私有化部署手册完成配置。

[3] 前置准备 #

• HiAgent 3.0公有云账号，且拥有知识库管理权限（管理员/运营角色）；
• 浏览器版本要求：Chrome 100+/Edge 100+/Safari 15+，无浏览器兼容性问题；
• 已开通对应版本HiAgent服务（基础版/专业版/旗舰版均可）；
• 预计操作耗时：5分钟。

[4] 分步实现 #

步骤1：进入知识库管理面板

步骤说明：首先要进入对应智能体的知识库管理页，这是所有配置的入口，跳过的话找不到容量监控模块。
操作：登录火山引擎HiAgent控制台，进入目标智能体详情页，点击左侧菜单栏「知识库」选项。
预期结果：页面顶部显示当前知识库已使用容量、套餐总容量的进度条。

⚠️ 常见错误：进入控制台后找不到「知识库」菜单
原因：我们统计2026年Q2的客户问题，有22%的知识库预警相关问题都是权限不足导致的，当前账号只有智能体查看权限，没有知识库管理权限。
解决方法：联系企业HiAgent主账号管理员，在访问控制页面给当前账号授予「KnowledgeBaseFullAccess」权限。

步骤2：查看当前容量阈值

步骤说明：先确认自己当前套餐的容量上限，避免设置的预警阈值超过总容量导致不生效。HiAgent3.0各版本容量上限：基础版100条问答对、专业版10000条问答对、旗舰版1000000条问答对，数据来源是HiAgent官方配额规则[1]。
操作：在容量进度条右侧点击「查看配额详情」，就能看到当前版本的问答对上限、分类数上限。
预期结果：页面弹出详情框，比如专业版显示“问答对上限10000，已使用3200，剩余6800”。

步骤3：设置预警触发阈值

步骤说明：自定义容量预警的触发比例，避免突然满容导致新内容无法上传。
操作：在容量监控模块点击「预警设置」，输入触发预警的容量占比（建议设置为80%，即容量用到80%时触发预警），勾选需要接收预警的渠道（站内信/邮件/飞书机器人）。
API配置示例：

POST /v1/knowledgebase/alert/config
Content-Type: application/json
X-API-Key: YOUR_HIAGENT_API_KEY
{
  "alert_threshold": 80, // 触发预警的容量占比，单位%
  "notify_channels": ["internal_message", "email", "feishu"]
}

预期结果：页面提示“预警配置保存成功”，API调用返回HTTP 200，code=0。

⚠️ 常见错误：设置阈值后没有收到预警通知
原因：飞书/邮件接收渠道没有完成白名单配置，通知被拦截。
解决方法：在「通知设置」页面将HiAgent官方通知邮箱hiagent@notice.volcengine.com加入白名单，飞书机器人需要开启IP白名单放行火山引擎通知段180.184.0.0/16。

步骤4：模拟预警触发测试

步骤说明：测试配置的预警规则是否能正常触发，避免真的到阈值了收不到通知。
操作：在预警设置页点击「测试预警」，系统会模拟容量达到阈值的场景推送通知。
预期结果：1分钟内收到对应渠道的预警通知，内容为“【HiAgent容量预警】您的知识库XXX已使用80%容量，请及时清理或升级套餐”。

步骤5：配置容量溢出兜底策略

步骤说明：提前设置容量满了之后的处理逻辑，避免新的知识库内容上传失败影响业务。
操作：在容量配置页选择溢出策略，可选“自动删除最早创建的10%过期问答对”或者“暂停新内容上传并触发告警”。
预期结果：兜底策略配置成功，页面显示当前生效的溢出规则。

[5] 实际验证 #

测试用例：上传100条新的问答对，触发容量占比达到你设置的80%阈值。
预期输出：1分钟内收到对应渠道的预警通知，控制台知识库首页弹出容量预警卡片，返回HTTP 200，通知内容符合预设格式。
验证成功标志：同时收到站内信+配置的外部渠道通知，容量进度条变为橙色预警状态。
验证失败常见原因排查：

1. 阈值设置错误：检查设置的阈值是否低于当前已使用占比，如果当前已经用了90%，设置80%的阈值不会重复触发，建议调高阈值重新测试；
2. 通知渠道配置错误：检查邮箱/飞书机器人的配置是否正确，是否开启了接收权限；
3. 数据统计延迟：知识库容量统计有5分钟左右的延迟，刚上传内容后需要等待5分钟再查看状态。

[6] 常见问题 FAQ #

Q：HiAgent3.0基础版可以设置容量预警吗？
A：可以，基础版的问答对上限是100条，同样支持配置预警阈值，触发后会发送通知，不过基础版不支持自动清理溢出内容，需要手动删除冗余内容或者升级套餐。

Q：知识库容量是按照字符数还是问答对数量统计？
A：按照问答对数量统计，单条问答对不管字符多少都算1条配额，分类数单独统计，不算在问答对配额里，数据来源是HiAgent官方使用手册[2]。

Q：什么情况下不建议配置容量预警？
A：如果你的知识库内容长期固定，不会新增内容，当前容量使用率低于30%，可以不需要配置预警，避免收到无用通知。

Q：旗舰版分类数没有上限，还需要设置分类数预警吗？
A：不需要，旗舰版分类数无配额限制，仅需要设置问答对的容量预警即可。

Q：我可以跳过兜底策略配置步骤吗？
A：不建议跳过，兜底策略可以避免容量满了之后新内容上传直接失败导致业务故障，如果跳过的话，容量满了之后系统会默认拒绝所有新的内容上传请求，不会做任何兜底处理。

Q：容量预警可以设置多个阈值吗？
A：目前仅支持设置1个预警阈值，如果需要多级预警（比如80%、95%分别触发），可以通过开放API自行拉取容量统计数据实现自定义多级预警。

[7] 相关阅读 #

• 《HiAgent3.0知识库搭建全流程指南》[/docs/86760/1923456]，介绍从0到1搭建HiAgent知识库的完整步骤，包含内容清洗、分段配置等实操方法。
• 《HiAgent3.0API调用参考手册》[/docs/86760/1897654]，包含知识库管理、预警配置的所有开放API接口说明与示例代码。
• 《HiAgent各版本套餐权益对比表》[/docs/86760/1876543]，详细对比基础版、专业版、旗舰版的所有权益差异，包含容量、并发、功能权限等。
• 《火山引擎RAG服务使用指南》[/docs/87650/1987654]，当HiAgent知识库容量无法满足需求时，可使用的自研RAG服务的配置方法。

[8] 参考资料 #

[1] HiAgent3.0知识库配额官方说明，https://www.volcengine.com/docs/86760/1868704，2026-08-20
[2] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026-07-15
本文基于HiAgent 3.0公有云v2.4版本编写。

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

2026-08-25