Hermes WebUI 数据库连接3 类数据源接通的完整实战【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webuiHermes WebUI 数据库连接这件事分两种情况一种是它自带的 SQLite 存储会话状态、Kanban 任务、用量洞察你只需要找到并消费这些数据另一种是把外部数据源——HTTP 接口、数据库、本地文件——接进来供 AI 查询。本文按场景带你走完选方案到动手接通的全过程。先想清楚你要让数据干这三件事在动手之前把目标落到具体任务上让看板直接显示任务进度。Hermes Agent 的看板数据通过 api/kanban_bridge.py 里的桥接层暴露给 WebUI任务、评论、事件都以接口形式返回前端按卡片渲染不需要你写查询逻辑。弄清楚 token 花在了哪个模型上。Insights 面板按天和模型聚合了令牌消耗与成本对应/api/insights接口位于 api/routes.py。开启sync_to_insights配置后会话的消息计数会同步到 Agent 侧的 state.db数据源就是 SQLite。让 AI 能查生产库的数据。这属于外部数据源接入按下面方案怎么选一节决定走接口、直连还是文件。能力速览内置数据能力各管什么能力解决的问题Kanban 看板数据任务状态、评论、事件以接口形式暴露Web 端实时展示进度Insights 洞察按天/按模型统计令牌量与成本定位开销大头SQLite 会话存储会话元数据与消息落盘在 state.db支持检索、筛选与恢复外部数据源连接方案怎么选先问自己两个问题数据现在从哪来是实时推过来还是你主动去拉如果你的情况是数据挂在 HTTP 服务上REST 端点、GraphQL、WebSocket 推送推荐走接口连接。REST 适合发请求取结果的批量查询WebSocket 适合服务端主动推送的实时场景GraphQL 适合字段多且每次只取一部分的复杂查询。接入点统一在 api/routes.py 的路由层扩展。如果你的情况是需要 SQL 级别的直接访问内置 SQLite 开箱即用PostgreSQL 或 MySQL/MariaDB 需要在配置里写明连接信息通过适配器建立连接。如果你的情况是数据就是本地文件——CSV、JSON、Excel 或日志文件——推荐直接解析读取。这类数据没有连接和超时问题是最先值得接通的类型。Hermes WebUI 连接外部数据库的三步流程第 1 步准备克隆代码并确认环境可用git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui外部库的账号密码一律放环境变量不写进配置文件。第 2 步配置与代码位置在配置文件里声明数据源敏感值用环境变量引用datasources: prod_db: type: postgresql host: db.internal port: 5432 db: orders user: ${DB_USER} password: ${DB_PASSWORD}连接信息写在config.yamldatabase.path可指到~/.hermes/state.db。数据访问的模型定义放在 api/models.py新增查询字段时在这里加。对外查询端点在 api/routes.py 中挂路由POST 接收source和查询语句返回 JSON 结果。第 3 步验证发一条最小查询确认链路通能取回数据后再看 Insights 里对应的消耗是否符合预期。卡住时的排查顺序见下一节。数据库连接超时的排查避坑自查清单用户名密码放在环境变量里配置文件里只留${VAR}引用对外传输启用了 TLS静态数据有备份策略数据库连接走连接池复用并设置了合理的连接超时与重试次数高频查询字段建了索引大结果集用分页返回每次用完连接都关闭防止句柄泄漏拖垮服务所有数据访问有审计记录异常查询模式能被发现症状速查连接超时→ 先查网络与防火墙放没放行端口再看超时参数是否设得太短。认证失败→ 核对环境变量实际展开后的用户名密码确认该账号对目标库有权限。查询明显变慢→ 检查是否缺索引、单次拉取的数据量是否超出分页上限。下一步做什么如果你只是想让看板、会话、用量数据动起来什么都不用写——它们已经内置直接打开界面对应的面板即可。如果你要接生产库先去config.yaml声明数据源、在api/routes.py加一个查询端点这是最短路径。连接不通时先翻~/.hermes/webui.log找报错栈再对照上面的清单逐项核对接口行为有疑问时直接看api/routes.py里对应路由的实现比猜更快。【免费下载链接】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），仅供参考