Hindsight 入门：Agent 跨会话记忆到底保存了什么
部署 Hindsight：把存储、密钥与网络入口分开管理
比较嵌入式试用、外部 PostgreSQL 和托管方案的恢复责任。
部署 Hindsight：把存储、密钥与网络入口分开管理知识学习CN编辑简报更新 2026-09-26
你将学会
- 先决定数据存在哪里
- 把模型凭据当作服务密钥
- 只开放必要入口
开始前需要
- Python 客户端基础
- 合成记忆测试样例和明确的部署边界
保存更正、误召回和费用，让下一次测试能重现同样的问题。
先看结论
- 存储路线决定恢复工作量。
- 托管模型可能把内容送出本机。
- MCP 端点也需要单独审查权限。
先决定数据存在哪里
README 的 Docker 示例挂载嵌入式数据目录，也给出了外部 PostgreSQL 的 compose 路径和 Helm chart。嵌入式卷适合小范围验证，但选定数据库后仍需设计备份、恢复和升级流程。
数据库版本、Hindsight 提交号和迁移计划应一起记录。模式升级后，回退应用代码可能不安全。上线前先用非敏感记录练习备份恢复，再讨论可用性承诺。
把模型凭据当作服务密钥
上游 Docker 命令把 HINDSIGHT_API_LLM_API_KEY 传入容器。正式部署应使用平台密钥管理，避免在日志和部署差异里打印凭据。所选模型提供方可能接收记忆内容，数据处理边界随配置改变。
数据库自托管不等于模型处理也留在本地。存放个人信息前，记录模型提供方、端点、地区与保留条款。本文没有验证每种模型配置的安全性。
只开放必要入口
文档服务同时提供 API、界面端口，以及按 bank 组织的 MCP 端点。接入远程客户端前应限制网络可达范围，并核对认证控制。未经检查的测试实例不应直接暴露在公网。
发布验收至少应覆盖重启后写入、检索和备份恢复。本系列没有执行这些部署测试，所列的是运营者需要在目标平台验证的项目。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
记录为何选择嵌入式或外部存储。
- 2
将模型凭据放入密钥管理，并限制端口。
- 3
用合成记录演练重启与恢复。
可复制示例
yaml
deployment:
revision: a921929a0e0ea82fb49da1daa0ca3e152e41fcc1
storage: choose-and-document
llm_secret: platform-secret-store
api_access: restricted
restore_test: pending常见问题
嵌入式数据卷能直接用于生产吗？
它是文档支持的路线，但是否合适取决于自身的恢复和可用性要求。
能把 README 命令直接放到公网服务器吗？
应先限制监听范围并确认认证、密钥和备份行为。
资料来源
- Hindsight / README.md来源核查 2026-09-26