3 步跑通Hermes WebUI 外部数据源接入实操指南【免费下载链接】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上周我还得把生产库导成 CSV、拖进聊天框再叮嘱模型「别把表头算进统计」。后来换了思路数据源不动让 Agent 自己去读。Hermes WebUI 就是这样一个在浏览器里操作 Hermes Agent 的界面——你负责提问它负责在服务器上读文件、跑命令、查它自己的看板与洞察数据再把结果贴回对话里。30 秒跑通第一条数据链路先看到结果再讲为什么。把仓库拉到服务器上起服务git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui python3 bootstrap.py浏览器打开 WebUI把你的数据文件拖进右侧工作区面板——CSV、JSON 都行拖完不用做任何配置。在对话框里直接说「读一下工作区里的 orders.csv按地区汇总金额给我一张表」。就这么多。Agent 在服务端完成读取和统计你在界面里等结果就行。它甚至不需要你写任何连接代码。跑几轮之后可以顺手打开洞察面板看看本地会话数据长什么样对应的后端入口在 api/routes.py 的/api/insights只读本地会话数据不碰外部系统。它到底帮你省了什么事先说最直接的。以前是「导 CSV → 粘给模型 → 模型看着几千行原始数据猜意图」现在是把文件放进工作区问一句人话。api/upload.py 负责接收你拖进来的文件Agent 拿到的是服务端真实路径读多大规模的数据都不过浏览器。再往上一层是 Kanban 看板。任务状态本来存在 Hermes Agent 自己的 SQLite 库里WebUI 侧的 api/kanban_bridge.py 只做桥接不复制一份数据界面上的卡片、列名、事件流全部来自 Agent 侧那个唯一数据源。你不再需要自己写脚本去 dump 任务表打开界面就是最新状态还有 SSE 事件流推送变更。最后是会话本身的账。每次跑数据任务花了多少 token、多少钱、用了哪个模型Insights 面板按天、按模型给你聚合好。这些数据来自本地会话索引不需要你再维护一个统计脚本。从零连上一个外部数据源以 Agent 直查数据库为主线最典型的路径是让 Agent 在服务器上直接查库而不是给 WebUI 加一层数据库驱动。先确认数据源在哪台机器上可达。这里有个容易忽略的点真正执行查询的是 Hermes Agent 所在的主机不是你的浏览器。只要那台机器上sqlite3或psql能连通目标库链路就通了。接下来把连接信息放进环境变量别写进提示词或对话里export DB_HOST10.0.3.21 export DB_PORT5432 export DB_NAMEproduction export DB_USER${DB_USER} export DB_PASSWORD${DB_PASSWORD}这时在 WebUI 里直接对 Agent 说「连一下 $DB_NAME 里的 orders 表按地区汇总本月的金额」。Agent 会在服务端拼出查询、执行、把结果整理回对话。整个过程你能在界面上看到它跑了什么命令出错了也能当场让它改。注意两点。一是 Agent 执行的是终端命令权限边界由 Hermes 侧的审批与工具集配置决定生产库建议只给只读账号。二是如果数据在本地文件里更省事的路是直接把 CSV/JSON 拖进工作区再往外一步就是下面要讲的扩展面板。生产环境里最容易踩的 3 个坑现象换了启动方式后界面里会话列表是空的数据「消失」了。根因不同启动方式读到的HERMES_WEBUI_STATE_DIR不一致状态目录指到了别处。解法启动日志会提示当前目录和一个兄弟目录里存有数据按提示export HERMES_WEBUI_STATE_DIR...指回去详见 docs/troubleshooting.md。现象Agent 读自己状态库时偶尔报database is locked看板刷新也卡。根因写连接和 Agent 侧的 checkpoint 互相争锁。解法外部读取一律走只读模式api/agent_sessions.py 的open_state_db_readonly就是用只读 URI 打开的方式别图省事直接sqlite3.connect(path)加读写。现象上传的 docx/xlsx 预览返回一句「Install python-docx, openpyxl, and python-pptx」。根因Office 解析依赖没有装。解法pip install python-docx openpyxl python-pptx。另外注意 api/office_documents.py 里有明确的渲染上限预览字符数、每张表行数、幻灯片数超大文件会被截断而不是撑爆内存这是特性不是故障。让它跑得再快一点拉洞察数据先带days参数缩小窗口后端会先过滤再聚合别默认拉 365 天。任务量大的时候别绕开kanban_db自己维护一份任务表多源同步的维护成本远高于桥接。会话检索走_index.json轻量索引就够了不要全量解析每个会话 JSON。想接更多数据源这里有个扩展点WebUI 内置了一个本地扩展机制docs/EXTENSIONS.md把静态资源放进扩展目录浏览器同源调用现有 API就能给自己加一个数据源面板。最小配置就这么多{ manifest: { name: my-data-panel, styles: [style.css], scripts: [panel.js] } }设置HERMES_WEBUI_EXTENSION_DIR指向该目录重启即可。提醒一句扩展 JS 拥有与登录用户等同的会话权限只放自己写的代码。详细字段和 loopback 侧车代理规则见官方文档。从一个小数据源开始最稳妥把一份周报放进工作区问 Agent 三句话跑通之后再决定要不要上扩展面板。你现有会话和看板数据本来就躺在同一个状态目录里先让 Insights 和 Kanban 替你干活比外接一个新库的风险小得多。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
3 步跑通：Hermes WebUI 外部数据源接入实操指南
3 步跑通Hermes WebUI 外部数据源接入实操指南【免费下载链接】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上周我还得把生产库导成 CSV、拖进聊天框再叮嘱模型「别把表头算进统计」。后来换了思路数据源不动让 Agent 自己去读。Hermes WebUI 就是这样一个在浏览器里操作 Hermes Agent 的界面——你负责提问它负责在服务器上读文件、跑命令、查它自己的看板与洞察数据再把结果贴回对话里。30 秒跑通第一条数据链路先看到结果再讲为什么。把仓库拉到服务器上起服务git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui python3 bootstrap.py浏览器打开 WebUI把你的数据文件拖进右侧工作区面板——CSV、JSON 都行拖完不用做任何配置。在对话框里直接说「读一下工作区里的 orders.csv按地区汇总金额给我一张表」。就这么多。Agent 在服务端完成读取和统计你在界面里等结果就行。它甚至不需要你写任何连接代码。跑几轮之后可以顺手打开洞察面板看看本地会话数据长什么样对应的后端入口在 api/routes.py 的/api/insights只读本地会话数据不碰外部系统。它到底帮你省了什么事先说最直接的。以前是「导 CSV → 粘给模型 → 模型看着几千行原始数据猜意图」现在是把文件放进工作区问一句人话。api/upload.py 负责接收你拖进来的文件Agent 拿到的是服务端真实路径读多大规模的数据都不过浏览器。再往上一层是 Kanban 看板。任务状态本来存在 Hermes Agent 自己的 SQLite 库里WebUI 侧的 api/kanban_bridge.py 只做桥接不复制一份数据界面上的卡片、列名、事件流全部来自 Agent 侧那个唯一数据源。你不再需要自己写脚本去 dump 任务表打开界面就是最新状态还有 SSE 事件流推送变更。最后是会话本身的账。每次跑数据任务花了多少 token、多少钱、用了哪个模型Insights 面板按天、按模型给你聚合好。这些数据来自本地会话索引不需要你再维护一个统计脚本。从零连上一个外部数据源以 Agent 直查数据库为主线最典型的路径是让 Agent 在服务器上直接查库而不是给 WebUI 加一层数据库驱动。先确认数据源在哪台机器上可达。这里有个容易忽略的点真正执行查询的是 Hermes Agent 所在的主机不是你的浏览器。只要那台机器上sqlite3或psql能连通目标库链路就通了。接下来把连接信息放进环境变量别写进提示词或对话里export DB_HOST10.0.3.21 export DB_PORT5432 export DB_NAMEproduction export DB_USER${DB_USER} export DB_PASSWORD${DB_PASSWORD}这时在 WebUI 里直接对 Agent 说「连一下 $DB_NAME 里的 orders 表按地区汇总本月的金额」。Agent 会在服务端拼出查询、执行、把结果整理回对话。整个过程你能在界面上看到它跑了什么命令出错了也能当场让它改。注意两点。一是 Agent 执行的是终端命令权限边界由 Hermes 侧的审批与工具集配置决定生产库建议只给只读账号。二是如果数据在本地文件里更省事的路是直接把 CSV/JSON 拖进工作区再往外一步就是下面要讲的扩展面板。生产环境里最容易踩的 3 个坑现象换了启动方式后界面里会话列表是空的数据「消失」了。根因不同启动方式读到的HERMES_WEBUI_STATE_DIR不一致状态目录指到了别处。解法启动日志会提示当前目录和一个兄弟目录里存有数据按提示export HERMES_WEBUI_STATE_DIR...指回去详见 docs/troubleshooting.md。现象Agent 读自己状态库时偶尔报database is locked看板刷新也卡。根因写连接和 Agent 侧的 checkpoint 互相争锁。解法外部读取一律走只读模式api/agent_sessions.py 的open_state_db_readonly就是用只读 URI 打开的方式别图省事直接sqlite3.connect(path)加读写。现象上传的 docx/xlsx 预览返回一句「Install python-docx, openpyxl, and python-pptx」。根因Office 解析依赖没有装。解法pip install python-docx openpyxl python-pptx。另外注意 api/office_documents.py 里有明确的渲染上限预览字符数、每张表行数、幻灯片数超大文件会被截断而不是撑爆内存这是特性不是故障。让它跑得再快一点拉洞察数据先带days参数缩小窗口后端会先过滤再聚合别默认拉 365 天。任务量大的时候别绕开kanban_db自己维护一份任务表多源同步的维护成本远高于桥接。会话检索走_index.json轻量索引就够了不要全量解析每个会话 JSON。想接更多数据源这里有个扩展点WebUI 内置了一个本地扩展机制docs/EXTENSIONS.md把静态资源放进扩展目录浏览器同源调用现有 API就能给自己加一个数据源面板。最小配置就这么多{ manifest: { name: my-data-panel, styles: [style.css], scripts: [panel.js] } }设置HERMES_WEBUI_EXTENSION_DIR指向该目录重启即可。提醒一句扩展 JS 拥有与登录用户等同的会话权限只放自己写的代码。详细字段和 loopback 侧车代理规则见官方文档。从一个小数据源开始最稳妥把一份周报放进工作区问 Agent 三句话跑通之后再决定要不要上扩展面板。你现有会话和看板数据本来就躺在同一个状态目录里先让 Insights 和 Kanban 替你干活比外接一个新库的风险小得多。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考