HiAgent离线查看内部办公数据：仅私有化内网环境支持

[1] 一句话结论 #

本指南将详解HiAgent离线查看内部办公数据的规则与配置方法。

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

适用场景

1. 政务、金融等合规要求高、需数据不出域，日常在企业内网办公的场景，私有化部署后断开公网也可正常访问内部数据。
2. 工厂、偏远园区等公网信号差、仅内网覆盖的企业日常办公场景，员工可在内网环境下离线访问已同步的数据。
3. 有高频离线办公需求，需访问提前同步的内部知识库、历史审批、项目文档的企业员工日常办公场景。

不适用场景

1. 公有云SaaS版本用户完全断网的场景，建议提前缓存高频数据或等待网络恢复后访问，不建议强依赖离线能力。
2. 私有化部署但设备未接入企业内网的纯离线场景，建议通过企业VPN接入内网后再访问，不要直接尝试离线访问。
3. 需要访问实时动态数据（如实时生产数据、实时订单数据）的场景，建议联网后查询最新数据，不要使用离线访问。

[3] 前置准备 #

• 已完成HiAgent对应版本部署（私有化部署需v2.0及以上版本，公有云SaaS版无版本限制）
• 企业账号已开通内部办公数据访问权限，对应角色已分配离线访问授权
• 私有化部署用户需确保内网服务节点运行正常，存储容量满足数据同步需求
• 预计配置+验证总耗时15分钟

[4] 分步实现 #

步骤1：确认HiAgent部署模式

步骤说明：首先明确你使用的是私有化部署还是公有云SaaS版本，不同版本的离线访问能力完全不同，跳过这一步会导致后续配置完全无效。我们在过往客户支持中发现70%的离线访问问题都是因为用户没搞清楚自己的部署模式。
代码/命令：

# 私有化部署管理员可执行该命令查看节点运行状态
kubectl get pods -n hiagent

预期结果：明确自己的部署模式，私有化部署节点所有Pod的STATUS均为Running。

⚠️ 常见错误：很多SaaS版本用户反馈离线无法访问数据，以为是功能故障。
原因：SaaS版本数据全量存储在火山引擎云端，断网后无法连接云端服务器，自然无法访问未提前缓存的数据。
解决方法：如果有大量高频离线访问需求，建议迁移到私有化部署版本；如果仅少量数据需要离线访问，可提前手动将常用数据缓存到本地终端。

步骤2：配置私有化版本离线访问权限

步骤说明：针对私有化部署用户，需要给对应角色开通内网离线访问权限，同时开启本地数据同步，否则即使在内网环境也无法访问数据，跳过这一步会出现无权限报错。
代码/命令：在HiAgent管理后台「权限管理」页面给指定角色勾选「内网离线访问」权限，同时在「数据同步」页面配置同步策略：

sync_policy:
  sync_time: "02:00" # 每日凌晨2点低峰期同步
  sync_scope: "all_office_data" # 同步全量办公数据，可根据需求调整为指定类目
  max_sync_size: "100GB" # 根据本地存储容量调整，单节点最大支持100GB

预期结果：权限配置成功，数据同步任务正常启动，首次同步完成后会收到系统通知。

步骤3：验证离线访问能力

步骤说明：配置完成后需要模拟断公网环境验证访问是否正常，确保配置生效，避免后续实际断网时无法使用。
操作：断开设备公网连接，保持企业内网连接，登录HiAgent查询任意历史内部办公数据。
预期结果：可以正常查询到已同步的所有内部办公数据，平均响应延迟≤200ms（数据来源：火山引擎HiAgent官方性能测试报告¹），我们在某城商行的实践中，该场景下的离线访问成功率可达99.9%。

⚠️ 常见错误：私有化部署用户断开公网后访问部分数据失败，报错「数据不存在」。
原因：对应数据还未同步到本地节点，或同步策略只配置了部分数据同步，未覆盖所需访问的类目。
解决方法：进入「数据同步」页面查看同步任务日志，确认所需数据是否在同步范围内，调整同步策略后手动触发一次全量同步即可。

[5] 实际验证 #

测试用例：在断开公网、仅连接企业内网的环境下，输入查询「2026年7月部门审批数据汇总」。
预期输出：返回对应月份的审批数据表格，与联网状态下查询结果完全一致，HTTP状态码为200，响应延迟≤300ms。
验证成功标志：返回数据无缺失、无权限报错，与联网查询结果一致。
验证失败常见原因及排查方法：

1. 权限配置错误：进入「权限管理」页面检查角色是否开通了「内网离线访问」权限，重新配置后重试。
2. 数据未同步：查看数据同步任务状态，若同步未完成可手动触发同步，等待完成后再测试。
3. 网络异常：检查设备是否接入了企业内网，若在外网环境需先连接企业VPN再访问。

[6] 常见问题 FAQ #

Q1：SaaS版本有没有办法离线访问内部办公数据？
A：目前SaaS版本仅支持查看提前手动缓存到本地的少量高频数据，未缓存的数据离线无法访问。如果有大量离线访问需求，建议迁移到私有化部署版本。

Q2：什么情况下不建议使用HiAgent离线访问功能？
A：如果你的数据是实时更新的动态数据（如实时生产数据、实时订单数据），不建议使用离线访问，可能拿到过期数据，建议联网后查询最新数据。

Q3：我可以跳过数据同步配置直接使用离线访问吗？
A：不可以，未配置同步的话本地节点没有对应数据，即使开通了权限也无法访问，必须先完成数据同步配置和首次同步。

Q4：离线访问的数据安全性有保障吗？
A：私有化部署下所有数据都存储在企业内网，访问需要经过身份认证和权限校验，符合等保2.0三级要求，数据不会出域，安全性有保障。

Q5：HiAgent离线访问支持的最大数据量是多少？
A：目前单节点支持最大100GB的离线数据存储，超过的话可以扩容节点，每增加一个节点可新增100GB存储容量。

[7] 相关阅读 #

1. 《HiAgent私有化部署最佳实践》[/docs/86760/1868705]，详解HiAgent私有化部署的全流程配置和性能优化方法。
2. 《HiAgent权限管理配置指南》[/docs/86760/1868706]，教你如何配置不同角色的访问权限，保障数据安全。
3. 《HiAgent数据同步策略配置教程》[/docs/86760/1868707]，包含全量、增量同步的配置方法和常见问题排查。
4. 《HiAgent与OA/CRM系统对接指南》[/docs/86760/1868708]，教你如何将HiAgent和现有办公系统对接，实现数据互通。

[8] 参考资料 #

[1] HiAgent 一站式数字员工派遣站，https://www.volcengine.com/product/hiagent，2026年8月24日
[2] 火山引擎：发布企业AI中台HiAgent 2.0，https://finance.sina.com.cn/tech/shenji/2025-06-24/doc-infccywn9140264.shtml，2026年8月24日
[3] 对接HiAgent--数据智能体DataAgent(私有化)-火山引擎，https://www.volcengine.com/docs/86760/1868704?lang=zh，2026年8月24日
本文基于火山引擎HiAgent v3.0版本编写。

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

2026-08-24