Hermes WebUI 外部数据源接入指南5 分钟让 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你手里的任务数据在 Kanban 里用量数据在 Insights 里业务数据散落在 Excel 和 CSV 中——想让 Hermes WebUI 这个 Web 端 AI 助手直接读到它们却不知道从哪下手。这篇指南按数据流动的方向带你把外部数据源一步步接进 Hermes WebUI从看板数据库到会话数据再到工作区文件每条路径都给出具体入口和最小配置。你的数据卡在哪先分清四类外部数据这一节帮你把外部数据源拆成四件具体的事避免一上来就纠结技术选型。Hermes WebUI 的接入方式取决于数据在哪、谁写谁读数据类型典型来源接入 Hermes WebUI 的路径代码入口任务与看板Kanban 看板数据库内置桥接 API开箱即用api/kanban_bridge.py会话与用量WebUI 自身的会话持久化自动落库Insights 面板读取api/webui_session_db.py文档与表格Excel、CSV、Word、PPT工作区文件预览AI 直接引用api/office_documents.py跨 Agent 共享其他 Agent 需要读你的会话MCP 服务标准协议暴露mcp_server.py判断顺序很简单数据已经在 Hermes 体系内看板、会话走前两类数据是你的本地文件走第三类数据要给别的程序用走第四类。5 分钟接上第一个数据源Kanban 看板数据库看板是 Hermes WebUI 与外部数据库交互最完整的一条链路适合当你的第一个练手数据源。它不需要你写任何适配代码。按下面顺序操作启动 WebUI确认 Hermes Agent 侧的看板数据库可访问。WebUI 侧的 kanban_bridge.py 把hermes_cli.kanban_db当作唯一数据源前端只是读写它。打开任意会话确认看板任务卡片能正常加载。这一层走的是/api/kanban/*下的完整 CRUD 接口包含多看板管理、任务依赖、评论与 SSE 实时事件流。想验证数据一致性直接在浏览器地址栏请求任务接口返回的 JSON 应与看板上卡片字段一致。数据源接好后你在 Web 界面的每次改板操作都会写回同一份数据库不存在双份状态。到这里第一个数据源就接上了没有配置项没有代码WebUI 与 Agent 看板共享同一个事实来源。用 MCP 把会话数据暴露给外部 Agent这一节解决反向问题不是 WebUI 读你的数据而是别的 MCP 兼容 Agent 来读 WebUI 的项目与会话。仓库根目录的 mcp_server.py 已经实现了这套协议它直接复用 WebUI 的api.models、api.profiles等模块保证锁和 profile 隔离与 WebUI 主进程行为一致。在 Agent 的 config.yaml 里注册服务打开你的 Hermes Agent 配置文件按下面格式添加一段command指向 venv 里的 Pythonargs指向 mcp_server.pymcp_servers: hermes-webui: command: /path/to/venv/bin/python3 args: [/path/to/hermes-webui/mcp_server.py] env: HERMES_WEBUI_PASSWORD: your_password保存后重启 Agent它就能以工具调用方式列出你的项目、读取会话元数据。若 WebUI 没有跑在默认端口设置HERMES_WEBUI_HOST和HERMES_WEBUI_PORT环境变量即可对齐不用改代码。多 profile 场景下指定数据范围如果 WebUI 管理了多个 profile在args里追加--profile参数例如[/path/to/hermes-webui/mcp_server.py, --profile, work]外部 Agent 就只能看到这个 profile 下的项目与会话。这是最省事的数据范围控制手段比事后过滤安全。让工作区里的 Excel 和 CSV 进入 AI 视野文件类数据源不需要任何连接——文件放进会话工作区就是数据源。这一节讲清楚它是怎么生效的、以及一个常见报错。把 CSV、JSON、docx、xlsx、pptx 拖进工作区面板后workspace.py 会解析并生成预览其中 Office 格式由 office_documents.py 负责它内置了严格的体积上限单文档 4MB、单表 5000 单元格等防止超大文件拖垮服务。预览生效后AI 在会话中就能引用这些内容做分析你无需导出再粘贴。如果预览报错提示缺少依赖说明服务器端没装 Office 解析库。按提示执行一次即可pip install python-docx openpyxl python-pptx装完刷新页面预览恢复。用量类数据则不需要你操心会话的 token、成本指标自动写入状态库Insights 面板直接可视化。选哪种接入方式三个高频问题的直接回答前面四条路径都过了一遍这一节用问答帮你快速定位该走哪条。Q我只想让自己的 Agent 在网页上查自己的数据要配置什么什么都不用配。看板与会话数据走内置桥接和状态库登录 WebUI 就能用重点是确认 profile 对不对。Q两个不同系统的 Agent 都要访问这批数据怎么办走 MCP。它用标准协议暴露项目与会话管理工具任何 MCP 兼容端都能接再用--profile划清数据边界。Q数据是运营团队每周发来的 xlsx怎么让 AI 直接分析放进对应会话的工作区就行。文件即数据源Office 解析库装好之后 AI 可以直接引用单元格内容不用你手工转格式。接不通时先查这 3 个地方排障顺序从便宜到贵先确认数据源本身活着再确认 WebUI 侧的入口最后看隔离配置。数据源侧Kanban 桥接报 400 多半是?boardslug参数拼错接口会主动抛错而不是 500MCP 连不上先检查HERMES_WEBUI_PASSWORD是否与 WebUI 端一致。服务侧确认 WebUI 跑在预期端口默认 8787MCP 端的环境变量HERMES_WEBUI_HOST/PORT与实际监听一致。隔离侧profile 不匹配时你看不到的是空而不是错——先切到正确 profile 再排查其他原因。下一步读完 docs/EXTENSIONS.md了解如何用本地扩展把自研数据面板嵌进 WebUI 界面对照 docs/onboarding.md 检查 Agent 与 WebUI 的 profile 是否对齐打开 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考