Graphiti

为 AI Agent 构建时间感知（Temporal）上下文图谱

[!NOTE] 我们正在招聘！ 构建用于驱动可靠、个性化且高效生产级 AI Agent 的上下文图谱。 加入我们吧——我们正在招聘工程师和开发者关系（DevRel）人员。查看职位。

⭐ 帮助我们触达更多开发者并壮大 Graphiti 社区，请为本项目点赞（Star）！

 

[!TIP] 欢迎查看全新的 Graphiti MCP Server！为 Claude、Cursor 及其他 MCP 客户端提供基于上下文图谱且具备时间感知的强大记忆能力。

Graphiti 是一个用于为 AI Agent 构建和查询时间上下文图谱（Temporal Context Graphs）的框架。与静态知识图谱不同，Graphiti 的上下文图谱能够追踪事实随时间的变化，保持对源数据的溯源，并支持预定义和自学习的本体（Ontology），使其成为处理不断变化的真实世界数据的 AI Agent 的理想选择。

与传统的检索增强生成（RAG）方法不同，Graphiti 将用户交互、结构化及非结构化企业数据以及外部信息持续整合到一个连贯且可查询的图中。该框架支持增量数据更新、高效检索以及精确的历史查询，无需重新计算整个图谱，非常适合开发交互式、具备上下文感知的 AI 应用。

使用 Graphiti 可以：

• 构建随交互不断演进的上下文图谱——追踪当前事实以及过去的事实。
• 为 Agent 提供丰富的结构化上下文，而非扁平的文档切片或原始对话历史。
• 通过混合检索（语义 + 关键词 + 图遍历）实现跨时间、意义和关系的查询。

 

什么是上下文图谱（Context Graph）？

上下文图谱是一个包含实体、关系和事实的时间图谱，例如“Kendra 喜欢 Adidas 鞋（截至 2026 年 3 月）”。与传统知识图谱不同，上下文图谱中的每个事实都有一个有效期：它何时成立，以及何时（如果有）被取代。实体会随着更新的摘要而随时间演变。一切均可追溯至事件（Episodes）——即产生这些事实的原始数据。

Graphiti 的独特之处在于它能够从非结构化和结构化数据中自动构建上下文图谱，在处理不断变化的关系的同时保留完整的历史记录。

上下文图谱包含以下组件：

组件	存储内容
实体 (Entities) (节点)	人员、产品、政策、概念——具有随时间演变的摘要
事实 / 关系 (Facts / Relationships) (边)	三元组（实体 → 关系 → 实体），带有时间有效期
事件 (Episodes) (溯源)	摄入的原始数据——事实的真实来源。每个派生的事实均可追溯至此
自定义类型 (Custom Types) (本体)	通过 Pydantic 模型定义的开发者自定义实体和边类型

Graphiti 与 Zep

Graphiti 是开源的时间上下文图谱引擎，也是 Zep AI Agent 上下文基础设施的核心。Zep 在大规模环境下管理上下文图谱，为生产级 Agent 部署提供受控、低延迟的上下文检索与组装服务。

通过使用 Graphiti，我们证明了 Zep 是 Agent 记忆领域的先进技术（State of the Art）。

阅读我们的论文：Zep: A Temporal Knowledge Graph Architecture for Agent Memory。

我们很高兴能开源 Graphiti，并相信它作为上下文图谱引擎的潜力远不止于记忆应用。

Zep 与 Graphiti 对比

维度	Zep	Graphiti
定义	面向 AI Agent 的托管式上下文图谱基础设施	开源时间上下文图谱引擎
上下文图谱	管理海量用户/实体的上下文图谱，提供治理能力	构建并查询单个上下文图谱
用户与对话管理	内置用户、线程和消息管理	-