Hindsight Agent Memory 入门：Docker 起服务 + retain/recall/reflect
按 Hindsight 官方 Quick Start 与 Python SDK，用 pip/Docker 启动 API（8888）与 Control Plane（9999），配置 LLM Key，再用 hindsight-client 跑通 retain / recall / reflect；讲清 bank_id 与异步 retain 轮询。含可抄命令与对照结果。
入门·2 课时·35 分钟·图文实操
免费学习无需登录
你将学会
- 用 pip install hindsight-api 或 Docker 镜像 ghcr.io/vectorize-io/hindsight:latest 把 API 跑在 localhost:8888，并打开 Control Plane :9999
- 正确配置 HINDSIGHT_API_LLM_API_KEY（及可选 PROVIDER/MODEL），理解生产环境需稳定 HINDSIGHT_API_WORKER_ID
- 用 hindsight-client 对同一 bank_id 完成 retain → recall → reflect，并在 retain_async=True 时轮询 operation 状态
适合谁
- 要给 Agent 加长期记忆的后端 / Agent 工程师
- 从纯向量检索升级到实体图谱 + 时序检索的开发者
- 需要本地可自托管 memory 服务的团队
课前准备
- 本机有 Python 3.10+ 与 pip；可选 Docker（跑官方镜像时需要）
- 准备一个支持结构化输出的 LLM API Key（官方 Quick Start 示例用 OpenAI Key；Models 页推荐 Groq 等）
- 了解基本 HTTP / JSON；不要求自建向量库或知识图谱
课程目录
2 课时 · 35 分钟- 01启动 Hindsight：pip 或 Docker，端口与 LLM 环境变量按官方 Quick Start 安装 hindsight-api 或拉取 ghcr.io/vectorize-io/hindsight:latest，映射 8888/9999，配置 HINDSIGHT_API_LLM_API_KEY，核对健康可访问。图文18 分钟开始本课
- 02Python 客户端：retain / recall / reflect 与 bank_idpip install hindsight-client，对同一 bank_id 写入记忆、检索、反思生成；可选 TypeScript 片段；说明 retain_async 与 Operations 轮询。图文17 分钟开始本课
课程说明
本课按 Hindsight 官方文档整理成中文可跟做讲义，不是原文搬运。
来源：Overview、Quick Start、Python Client。异步任务见 Operations；LLM 配置见 Models。代码仓库：vectorize-io/hindsight。
两课你会做完：用 pip 或 Docker 在本机拉起 API（http://localhost:8888）与 Control Plane（http://localhost:9999），配好 HINDSIGHT_API_LLM_API_KEY；再用 hindsight-client 对同一个 bank_id 跑通 retain → recall → reflect，并理解异步 retain 需要轮询 operation。Hindsight 面向 Agent 记忆：不只是向量检索，还会抽事实、建实体图，并用 TEMPR 四路并行检索。