给 Hermes 桌面端接入 Hindsight:完整配置长期记忆
给 Hermes 桌面端接入 Hindsight完整配置长期记忆【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight本文带你完整配置 Hermes 桌面端的 Hindsight 长期记忆。无需终端在 Settings 面板里选定模式、粘贴 API Key 并保存Agent 即可在每轮对话前自动回忆、对话后自动留存。你将掌握 Cloud 与本地实例两种连接模式的区别、五个配置字段的含义、Recall budget 对检索深度的实际作用以及密钥与配置各自的落盘位置。一次对话结束Agent 就忘了你Hermes 是 Nous Research 推出的 Agent 桌面应用但默认情况下它的记忆只活在当前会话里上一轮聊过的偏好、决策、项目背景关掉窗口就清零。Hindsight 提供的是跨会话的长期记忆后端而 Hermes 桌面端是少数把这套接入做进图形界面的客户端——在Settings → Memory Context里选中 Hindsight 之后才会渲染出完整的专属表单选其他记忆提供方时这块区域是空白的。三步给出 Hermes 桌面端 Hindsight 最小配置打开Settings → Memory Context在Memory Provider下拉框中选择Hindsight专属表单随即展开。填写表单按部署形态选择Mode——用托管服务就保持Cloud并粘贴从 Hindsight Cloud 控制台 Connect 页面获取的、以hsk_开头的 API Key自建了 Hindsight 实例Docker 或 K8s 均可则选Local External把API URL指向实例地址如http://localhost:8888Bank ID留默认即可。点击Save。此后每轮对话 Hermes 都会自动回忆并留存配置完成。五个配置字段逐一拆解选 Hindsight 后展开的面板只有五个字段含义与默认值如下字段含义默认值何时需要改Mode记忆后端指向 Hindsight Cloud 还是自建实例Cloud需要数据留在自己基础设施内时API keyHindsight API 认证凭据以只写密钥保存—必填从 Cloud 控制台 Connect 页面获取API URL所有 retain / recall 请求发往的端点https://api.hindsight.vectorize.ioLocal External模式下改填实例地址Bank ID当前档案profile读写的记忆库memory bank名称hermes多档案共用一个 Hindsight 实例、想按用途分开存放时Recall budget每轮对话的检索投入档位low/mid/highmid追低延迟选low需要深度回忆选high保存之后密钥与配置分别去了哪里密钥进密钥库配置进档案点 Save 后两类数据自动分流API key写入系统密钥存储区secret store属于只写write-only密钥——保存后不会再被回读进表单面板上只会出现一个 “API key set” 徽章提示你已配置完成目的是不让密钥在界面层反复传输展示Mode、API URL、Bank ID、Recall budget四项则写入当前 Hermes 档案配置与 CLI 场景下config.json中的mode、api_url、bank_id、recallBudget一一对应随时可以在图形界面与命令行两种配置方式之间切换。Bank ID 决定记忆隔离每个 Bank ID 对应一个完整且相互隔离的存储单元内部装着记忆事实facts、文档、实体、实体间关系构成的知识图谱以及指令directives不同库之间完全隔离存在库 A 的记忆在库 B 中不可见。因此不同 Hermes 档案默认各用hermes库互不干扰同一档案换机器运行时记忆也随之漫游。隔离的另一面是显式报错读取一个不存在的 bankHindsight 直接返回 404 而不是空结果拼错库名会立刻暴露而不是给你一份看似健康的空数据。Recall budget 决定每轮回忆多深Recall budget对应 Hermes 侧的recallBudget配置项与HINDSIGHT_RECALL_BUDGET环境变量。服务端收到请求后会把budget档位映射成每条检索通道语义、BM25、知识图谱、时序等的候选条目上限默认固定档位low/mid/high分别对应 100、300、1000 条也可以切换成自适应adaptive模式让上限随请求的输出 token 预算按 2.5%、7.5%、25% 的比例伸缩并钳制在 20 到 2000 之间。人话版结论low快而浅high慢而深日常对话用默认mid就够。运行机制与新手高频坑一次对话中 Hindsight 何时介入保存配置后Hindsight 通过 Hermes 原生的记忆提供方机制挂在 Agent 生命周期的两个时机上LLM 调用前pre_llm_call钩子自动回忆查出的相关记忆作为临时系统上下文注入响应生成后post_llm_call钩子自动留存把本轮用户与助手的对话写回 Hindsight 做事实抽取与索引。hindsight_retain、hindsight_recall、hindsight_reflect三个显式工具同时注册给模型供它主动写入、检索或综合记忆。新手高频坑API key 保存后面板上看不到内容→ 只写密钥不回显是设计如此 → 看到 “API key set” 徽章即表示密钥已生效无需重新粘贴。Local External 模式连接被拒→API URL填错了端口或实例未启动 → 先用curl http://localhost:8888/health确认实例活着再核对填的是 API 端口而不是 UI 端口。Bank ID 拼错后报 404→ Hindsight 对不存在的 bank 显式返回 404 而非空结果 → 照报错修正库名即可这属于保护机制而非故障。Recall 查不到任何记忆→ 新 bank 尚未完成过一次留存流程 → 先正常对话积累再开新会话提问验证。Hermes 内置文件记忆与 Hindsight 同时开启→ 模型可能优先读内置的MEMORY.md而绕开 Hindsight → 在终端执行hermes config set memory.memory_enabled false关闭内置存储让 Hindsight 成为唯一记忆源。配置保存的那一刻Hermes 就拥有了跨会话、跨设备的持续记忆每次对话前它先向 Hindsight 检索相关上下文对话结束后再把关键信息写回 bank。想继续了解 CLI 向导与全部字段可看仓库内的 Hermes Agent 集成文档bank 隔离与检索参数的更多细节见 Memory Banks 文档。【免费下载链接】hindsightHindsight: Agent Memory That Learns项目地址: https://gitcode.com/GitHub_Trending/hindsight2/hindsight创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考