Zep 示例集 源码学习
Zep Cloud 的 Agent Memory 示例与集成仓库（不是完整产品服务端）。这不是 API 速查表，而是一条可以重复走的源码路线：每天用 30 分钟，从一个真实相对路径出发，先用类比建立直觉，再把它接回整条运行链路。
开篇 · 这是个什么项目
Zep 示例集 可以先想成一间外接式记忆云盘 + 关系图谱导航器的操作手册。它的代码不是一堆孤立文件：入口接到需求，核心对象做判断，工具或模型完成工作，状态把结果交给下一个环节。
架构全景（动起来看）
发光扫过的每一层都是一次任务可能经过的站点。不同仓库命名不同，但「接入 → 编排 → 核心能力 → 资源」的责任边界很相似。
怎么使用这份教程
每天 30 分钟
6 讲，每讲先问问题，再给本质和大白话。
真实相对路径
所有路径都从项目根目录算，不把你的机器路径写进源码引用。
先验证再推理
每页都有可复制 bash 命令；文件版本变化时以本地实际内容为准。
可迁移方法
学会从入口、数据结构、循环和扩展点读任何 AI 项目。
确认仓库定位
README.md：理解该仓库提供 examples、integrations、MCP、benchmark，而非完整 Zep 产品。
最小 Python 快速开始
examples/python/quickstart：从 SDK 初始化、用户与消息写入开始。
最小 TypeScript 记忆
examples/typescript/memory：对照 Python 与 TypeScript SDK 的调用形态。
用户建模
examples/typescript/users：理解 userId、用户属性和隔离边界。
聊天历史
examples/python/chat_history：学习 thread、message 与会话历史的基本组织。
上下文模板
examples/python/context-templates-example：理解 Context Block 注入和自定义上下文格式。
图谱检索
examples/python/graph_example：学习节点、边、事实和图搜索的基础。
默认 Ontology
ontology/default_ontology.py：阅读 User、Preference、Event 等实体及关系约束。
可视化知识图
examples/typescript/zep-graph-visualization：理解图数据从 API 到前端呈现的链路。
文档切分和摄取
examples/typescript/chunking-example：学习文档 chunk 与后续图谱/记忆检索的关系。
完整 Agent Memory Demo
examples/python/agent-memory-full-example：阅读 Streamlit、上下文检索、流式回答和延迟对比。
LangGraph 集成
integrations/langgraph/python：理解框架的 memory/context 扩展点。
Mastra 自动记忆
integrations/mastra/typescript：学习 ZepInputProcessor 与 ZepOutputProcessor。
工具式记忆访问
integrations/mastra/typescript：理解 zepRemember、zepSearch 与自动处理器的取舍。