企业官网建设流程全解析

Hermes WebUI 数据集成实战：3 种方式把数据源接进 AI 工作流

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui

Hermes WebUI 是 Hermes Agent 的网页端入口，除了聊天，它本身还承担数据中枢的角色：本地 SQLite 状态库存放全部会话记录，Insights 面板输出用量与成本统计，Kanban 桥接模块实时同步看板数据。读完这篇，你能选对适合自己场景的接入方案、把第一路外部数据源接进来，并学会验证数据是否真的在流通。

先选路：3 种接入方案怎么选

动手之前先判断数据在哪里，这决定了接入成本：

选择原则只有一条：数据已经在本地就别绕远路走网络；数据在别处才考虑 API。Hermes WebUI 的会话存储走的就是第一条路，会话元数据落在state.db里，同时维护一份轻量的索引文件供界面快速检索，具体兼容层可以看 api/webui_session_db.py。

本地会话数据：SQLite 状态库怎么读 🗄️

所有会话都持久化在本地 SQLite 数据库里，按时间、项目、置顶状态都能筛选。这里有一个容易忽略的细节：WebUI 打开 Agent 的state.db时用的是只读连接。原因是 Agent 流式写入时这个库可能已经有数 GB 大小，用可写句柄去碰它既会锁表又可能产生幽灵副本。

对你来说这意味着两点：

• 查询会话历史、做二次分析时，放心读，不影响 Agent 正常写入；
• 想让 Insights 统计带上 WebUI 侧的会话，需要打开sync_to_insights设置项，这是可选行为，默认不同步。

看板数据同步：Kanban 桥接三步接入法 📋

如果你用 Hermes Agent 的看板管理任务，WebUI 已经内置了一条完整桥接链路：它把hermes_cli.kanban_db当作唯一数据源，自己只做投影，Web 端和 Agent 端天然一致。接入分三步。

第一步，确认 Agent 可用。桥接模块是懒加载导入 Agent 侧的看板库的，Agent 装好了这一步就自动完成。

第二步，走标准接口。任务增删改查、多看板管理、依赖链接都在/api/kanban/*下，常见的调用形态是：

GET /api/kanban/boards # 列出看板 POST /api/kanban/tasks # 新建任务 PATCH /api/kanban/tasks/<id> # 更新任务

第三步，要实时刷新就订阅 SSE 事件流，任务状态一变，界面不用轮询就能收到推送。实现细节在 api/kanban_bridge.py，六列状态（triage / todo / ready / running / blocked / done）也在同一处定义。

从文件到接口：外部数据源的最小落地 ⚙️

数据已经在磁盘上时，最省事的路线是把它放进工作区。Hermes WebUI 的工作区支持直接浏览、预览文件，CSV 和 JSON 这类结构化数据可以在对话里直接引用让 Agent 处理；办公文档有专门的处理通道，相关代码在 api/office_documents.py。

数据在远程时，就把它当成一个普通 HTTP 依赖来对待。所有路由集中在 api/routes.py 里，外部请求进来后由具体模块分发。建议把外部服务的凭证放进环境变量而不是配置文件，接口调用加上超时和重试，这两点能挡住大部分线上故障。

验证与排障：确认数据真的接通了 🔍

接完别猜，直接看 Insights。这个面板从本地会话数据聚合出近 N 天的会话数、消息数、令牌量和估算成本，默认窗口是 30 天，最长可拉到一年：

GET /api/insights?days=30

打开面板后先核对四张卡片：会话数为 0 说明数据窗口内没有活动，成本显示 N/A 说明用量字段没落库。Insights 同时带有系统健康区块，可以直接观察 CPU、内存、磁盘的实时占用，用来排除"数据没写进去"还是"机器跑不动"这两类问题。

遇到异常时按这个思路排查：

更完整的诊断流程可以参考 docs/troubleshooting.md。

下一步很简单：打开你的 Hermes WebUI，进 Insights 核对一次数据，再把最常用的一路外部数据源按上面的方案接进来。

【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui