Graphiti 是一个用于构建和查询 时间感知型知识图谱 的框架，专为运行在动态环境中的 AI 智能体而设计。

不同于传统的 RAG（检索增强生成） 方法，Graphiti 能够：

•持续整合 用户交互、结构化与非结构化企业数据 以及 外部信息，并形成一个统一、可查询的知识图谱；•支持 增量数据更新、高效检索 和 精确的历史查询，而无需完全重新计算整个图谱；•非常适合开发 交互式、上下文感知的 AI 应用。

Graphiti 的使用场景

使用 Graphiti，你可以：

•集成并维护 动态的用户交互与业务数据；•支持智能体的 状态推理 和 任务自动化；•借助 语义搜索、关键词搜索 与 图谱搜索，查询复杂且不断演变的数据。

知识图谱是一组互相关联的事实网络。
例如：“Kendra 喜欢 Adidas 鞋子”。

•实体（节点）：Kendra、Adidas shoes•关系（边）：loves

这样的事实通常以 三元组（triplet） 形式存储。

知识图谱在信息检索领域已有广泛应用，而 Graphiti 的独特之处在于：

•它能 自主构建知识图谱；•能够 处理关系随时间的变化；•并在此过程中 保留历史上下文。

Graphiti 与 Zep 的上下文工程平台

Graphiti 是 Zep[2] 的核心引擎。
Zep 是一个开箱即用的 上下文工程平台（Context Engineering Platform），为 AI 智能体提供：

•智能体记忆[3]•Graph RAG（动态图谱检索增强生成）•上下文检索与组装

借助 Graphiti，我们证明了 Zep 在智能体记忆领域已达到最先进（SOTA）水平。

📖 推荐阅读论文：
《Zep: A Temporal Knowledge Graph Architecture for Agent Memory》[4]

为什么选择 Graphiti？

传统的 RAG 方法通常依赖于 批处理 和 静态数据摘要，在处理频繁变化的数据时效率低下。
Graphiti 针对这些挑战提供了以下解决方案：

•实时增量更新：立即整合新数据，无需重新进行批处理计算。•双时间数据模型（Bi-Temporal Data Model）：显式追踪事件发生时间和数据摄取时间，支持精确的时间点查询。•高效的混合检索：结合语义向量、关键词（BM25）和图谱遍历，实现低延迟查询，无需依赖 LLM 总结。•自定义实体定义：支持灵活的本体构建，开发者可通过简洁的 Pydantic 模型定义自有实体。•可扩展性：通过并行处理高效管理大规模数据集，适用于企业级环境。

Graphiti 与 GraphRAG 对比

方面	GraphRAG	Graphiti
主要用途	静态文档摘要	动态数据管理
数据处理方式	批处理为主	持续的、增量更新
知识结构	实体簇与社区摘要	事件化数据、语义实体、社区
检索方式	顺序 LLM 摘要	混合语义、关键词、图谱检索
适应性	低	高
时间处理	基础时间戳追踪	显式双时间追踪
矛盾处理	依赖 LLM 摘要判断	基于时间的边失效（Temporal edge invalidation）
查询延迟	数秒到数十秒	通常为亚秒级延迟
自定义实体类型	不支持	支持，完全可自定义
可扩展性	中等	高，针对大规模数据集优化

Graphiti 专为应对 动态且频繁更新的数据集 而设计，特别适合需要：

•实时交互•精确历史查询

的应用场景。

安装指南

基本要求

•Python：3.10 或更高版本•图数据库（任选其一）：•Neo4j 5.26•FalkorDB 1.1.2•Kuzu 0.11.2•Amazon Neptune 数据库集群 或 Neptune Analytics Graph + Amazon OpenSearch Serverless（作为全文检索后端）•OpenAI API Key（Graphiti 默认使用 OpenAI 进行 LLM 推理与向量嵌入）

⚠️ 重要提示

Graphiti 在支持 结构化输出（Structured Output） 的大模型服务（如 OpenAI 和 Gemini）上效果最佳。
使用不支持结构化输出的模型，可能会导致：

•输出 schema 错误•数据导入失败

这在使用小模型时尤为明显。

可选配置

•额外 LLM 提供商 API Key：•Google Gemini•Anthropic•Groq

💡 提示

安装 Neo4j 最简单的方法是通过 Neo4j Desktop[5]，它提供了用户友好的界面来管理 Neo4j 实例和数据库。

如果你希望更快速上手，可以选择使用 FalkorDB（Docker 部署），并立即运行快速示例：

docker run -p 6379:6379-p 3000:3000-it --rm falkordb/falkordb:latest

安装 Graphiti 核心包：

pip install graphiti-core

或使用 uv：

uv add graphiti-core

使用 FalkorDB

如果你计划将 FalkorDB 作为图数据库后端，请安装带有 FalkorDB 扩展的版本：

pip install graphiti-core[falkordb]

使用 Kuzu

如果你计划将 Kuzu 作为图数据库后端，请安装带有 Kuzu 扩展的版本：

pip install graphiti-core[kuzu]

使用 Amazon Neptune

如果你计划将 Amazon Neptune 作为图数据库后端，请安装带有 Neptune 扩展的版本：

pip install graphiti-core[neptune]

安装可选 LLM 提供商支持

Graphiti 也支持额外的大模型（LLM）服务，安装方法如下：

•Anthropic

pip install graphiti-core[anthropic]

•Groq

pip install graphiti-core[groq]

•Google Gemini

pip install graphiti-core[google-genai]

多服务组合安装示例

•同时安装 多个 LLM 提供商：

pip install graphiti-core[anthropic,groq,google-genai]

•安装 FalkorDB + LLM 提供商：

pip install graphiti-core[falkordb,anthropic,google-genai]

•安装 Amazon Neptune（支持云端图数据库）：

pip install graphiti-core[neptune]

默认低并发与 LLM 提供商 429 速率限制错误

Graphiti 的数据导入管道设计为支持高并发。
但为了避免 LLM 提供商返回 429（请求过多）错误，默认情况下并发数设置较低。

•默认并发控制由环境变量 SEMAPHORE_LIMIT 管理。•默认值：10 个并发操作，用于帮助防止触发 LLM 提供商的速率限制。•如果仍然遇到 429 错误，请尝试降低该值。•如果你的 LLM 提供商允许更高吞吐量，可以适当提高 SEMAPHORE_LIMIT 来提升数据导入性能。

快速开始

⚠️ 重要提示

Graphiti 默认使用 OpenAI 进行 LLM 推理与嵌入。 因此需要在环境变量中设置 OPENAI_API_KEY。

此外，Graphiti 也支持：

•Anthropic•Groq

其他 LLM 提供商也可能通过 OpenAI 兼容 API 接入。

Quickstart 示例

完整可运行示例可在 examples 目录下的 Quickstart Example[6] 找到。
该示例展示了以下功能：

1.连接到 Neo4j / Amazon Neptune / FalkorDB / Kuzu 数据库2.初始化 Graphiti 的索引和约束3.向图谱中添加数据片段（支持文本和结构化 JSON）4.使用 混合检索 搜索关系（edges）5.基于 图距离 对搜索结果进行重排序6.使用预定义的搜索方案（recipes）查找节点（nodes）

该示例附带了完整的文档说明，包括：

•每个功能的清晰解释•完整的 README（安装说明 + 下一步操作指引）

💡 建议：如果你发现 Graphiti 运行缓慢，请根据 LLM 提供商的实际限额，适当调整 SEMAPHORE_LIMIT，以获得最佳性能。

MCP 服务器

mcp_server 目录包含了 Graphiti 的 Model Context Protocol (MCP) 服务器实现。
该服务器允许 AI 助手 通过 MCP 协议与 Graphiti 的知识图谱能力交互。

MCP 服务器的主要功能：

•数据片段（Episode）管理：新增、获取、删除•实体与关系管理•语义搜索与混合检索•分组管理：用于组织相关数据•图谱维护操作

MCP 服务器可以通过 Docker 部署并连接 Neo4j，从而轻松集成到 AI 助手工作流中。
👉 详细安装步骤与使用示例，请查看 MCP Server README[7]。

REST 服务

server 目录包含了一个用于与 Graphiti API 交互的 API 服务，基于 FastAPI 构建。
👉 详细信息请查看 Server README[8]。

可选环境变量

除了 Neo4j与 OpenAI 兼容凭据 之外，Graphiti 还支持一些 可选环境变量。

•如果你使用 Anthropic 或 Voyage等支持的模型，需要设置对应的环境变量。

数据库配置

数据库名称在 驱动（driver）构造函数 中直接配置：

•Neo4j：默认数据库名为 neo4j（硬编码在 Neo4jDriver 中）•FalkorDB：默认数据库名为 default_db（硬编码在 FalkorDriver 中）

自 v0.17.0 起，如需自定义数据库配置，可在实例化 Graphiti 时通过 graph_driver 参数传入数据库驱动。

Neo4j 自定义数据库名称

from graphiti_core importGraphiti

FalkorDB 自定义数据库名称

from graphiti_core importGraphiti

Kuzu

from graphiti_core importGraphiti

Amazon Neptune

from graphiti_core importGraphiti

性能配置

USE_PARALLEL_RUNTIME 是一个可选的布尔变量。
如果设置为 true，则会启用 Neo4j 的并行运行时（parallel runtime），以提升部分搜索查询的性能。

⚠️ 注意：

•此功能 不支持 Neo4j Community Edition•对于较小的 AuraDB 实例 也不支持
因此默认情况下该功能为关闭状态。

在 Azure OpenAI 中使用 Graphiti

Graphiti 支持在 Azure OpenAI 上进行 LLM 推理 与 向量嵌入。 Azure 部署通常需要：

•不同的端点 分别用于 LLM 与 Embedding 服务•针对默认模型和小模型进行 独立部署

⚠️ 重要提示

Azure OpenAI v1 API 结构化输出需要手动启用

Graphiti 使用结构化输出（client.beta.chat.completions.parse() 方法）。这要求 Azure OpenAI 部署 必须选择加入 v1 API。否则，在数据导入（episode ingestion）时会遇到：404 Resource not found

👉 启用方法：请参考微软官方文档 Azure OpenAI API version lifecycle[9]。

使用示例

from openai importAsyncAzureOpenAI

请务必将示例代码中的占位符（如 <your-google-api-key>、模型名等）替换为你在 Azure OpenAI 或 Google Gemini 服务中实际的 凭据与部署名称。

在 Google Gemini 中使用 Graphiti

Graphiti 支持 Google Gemini 模型，可用于：

•LLM 推理•向量嵌入（embeddings）•交叉编码 / 结果重排序（cross-encoding / reranking）

安装 Graphiti（启用 Google Gemini 支持）

uv add"graphiti-core[google-genai]"

使用示例

from graphiti_core importGraphiti

关于 Gemini Reranker

•默认使用 gemini-2.5-flash-lite-preview-06-17 模型•该模型针对 低成本 和 低延迟分类任务 进行了优化•使用与 OpenAI Reranker 相同的 布尔分类方法•借助 Gemini 的 log probabilities 特性 对段落相关性进行排序

在 Ollama（本地 LLM）中使用 Graphiti

Graphiti 支持通过 Ollama 的 OpenAI 兼容 API来运行本地的大语言模型（LLM）和嵌入模型。
这种方式非常适合：

•注重隐私的应用场景•避免额外 API 成本的场景

安装模型

# 拉取 LLM 模型

使用示例

from graphiti_core importGraphiti

确保 Ollama 已经运行(ollama serve)，确认已拉取所需模型（例如 deepseek-r1:7b、nomic-embed-text）。

文档与指南

•Guides：使用手册与 API 文档[10]•Quick Start：快速开始[11]•与 LangChain 的 LangGraph 集成：使用 Graphiti 构建智能体[12]

遥测（Telemetry）

Graphiti 会收集匿名使用统计信息，以帮助我们了解框架的使用情况并改进功能。
我们重视透明性，明确具体收集的内容与不会收集的内容。

查看遥测代码

遥测相关代码可在 这里[13] 查看。

如何禁用遥测

Graphiti 的遥测为 默认启用（opt-out），可随时关闭。

方法 1：通过环境变量

exportGRAPHITI_TELEMETRY_ENABLED=false

方法 2：写入 Shell 配置文件

•Bash 用户 (~/.bashrc 或 ~/.bash_profile)

echo'export GRAPHITI_TELEMETRY_ENABLED=false'>>~/.bashrc

•Zsh 用户 (~/.zshrc)

echo'export GRAPHITI_TELEMETRY_ENABLED=false'>>~/.zshrc

方法 3：在单个 Python 会话中禁用

import os

📌 注意：在运行测试时（检测到 pytest），遥测会自动禁用。

如何学习大模型 AI ？

我国在AI大模型领域面临人才短缺，数量与质量均落后于发达国家。2023年，人才缺口已超百万，凸显培养不足。随着Al技术飞速发展，预计到2025年，这一缺口将急剧扩大至400万，严重制约我国Al产业的创新步伐。加强人才培养，优化教育体系，国际合作并进，是破解困局、推动AI发展的关键。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线互联网企业工作十余年里，指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑，所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限，很多互联网行业朋友无法获得正确的资料得到学习提升，故此将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

2025最新大模型学习路线

明确的学习路线至关重要。它能指引新人起点、规划学习顺序、明确核心知识点。大模型领域涉及的知识点非常广泛，没有明确的学习路线可能会导致新人感到迷茫，不知道应该专注于哪些内容。

对于从来没有接触过AI大模型的同学，我帮大家准备了从零基础到精通学习成长路线图以及学习规划。可以说是最科学最系统的学习路线。

针对以上大模型的学习路线我们也整理了对应的学习视频教程，和配套的学习资料。

大模型经典PDF书籍

新手必备的大模型学习PDF书单来了！全是硬核知识，帮你少走弯路！

配套大模型项目实战

所有视频教程所涉及的实战项目和项目源码等

博主介绍＋AI项目案例集锦

MoPaaS专注于Al技术能力建设与应用场景开发，与智学优课联合孵化，培养适合未来发展需求的技术性人才和应用型领袖。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

为什么要学习大模型？

2025人工智能大模型的技术岗位与能力培养随着人工智能技术的迅速发展和应用 ， 大模型作为其中的重要组成部分 ， 正逐渐成为推动人工智能发展的重要引擎 。大模型以其强大的数据处理和模式识别能力， 广泛应用于自然语言处理 、计算机视觉 、 智能推荐等领域 ，为各行各业带来了革命性的改变和机遇 。

适合人群

• 在校学生：包括专科、本科、硕士和博士研究生。学生应具备扎实的编程基础和一定的数学基础，有志于深入AGI大模型行业，希望开展相关的研究和开发工作。
• IT行业从业人员：包括在职或失业者，涵盖开发、测试、运维、产品经理等职务。拥有一定的IT从业经验，至少1年以上的编程工作经验，对大模型技术感兴趣或有业务需求，希望通过课程提升自身在IT领域的竞争力。
• IT管理及技术研究领域人员：包括技术经理、技术负责人、CTO、架构师、研究员等角色。这些人员需要跟随技术发展趋势，主导技术创新，推动大模型技术在企业业务中的应用与改造。
• 传统AI从业人员：包括算法工程师、机器视觉工程师、深度学习工程师等。这些AI技术人才原先从事机器视觉、自然语言处理、推荐系统等领域工作，现需要快速补充大模型技术能力，获得大模型训练微调的实操技能，以适应新的技术发展趋势。
  

课程精彩瞬间

大模型核心原理与Prompt：掌握大语言模型的核心知识，了解行业应用与趋势；熟练Python编程，提升提示工程技能，为Al应用开发打下坚实基础。

RAG应用开发工程：掌握RAG应用开发全流程，理解前沿技术，提升商业化分析与优化能力，通过实战项目加深理解与应用。

Agent应用架构进阶实践：掌握大模型Agent技术的核心原理与实践应用，能够独立完成Agent系统的设计与开发，提升多智能体协同与复杂任务处理的能力，为AI产品的创新与优化提供有力支持。

模型微调与私有化大模型：掌握大模型微调与私有化部署技能，提升模型优化与部署能力，为大模型项目落地打下坚实基础。

顶尖师资，深耕AI大模型前沿技术

实战专家亲授，让你少走弯路

一对一学习规划，职业生涯指导

• 真实商业项目实训
• 大厂绿色直通车

人才库优秀学员参与真实商业项目实训

以商业交付标准作为学习标准，具备真实大模型项目实践操作经验可写入简历，支持项目背调

大厂绿色直通车，冲击行业高薪岗位

文中涉及到的完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】