智能体与多智能体

Graphiti:为 AI 智能体构建时序上下文图

getzep/graphiti

Graphiti 是由 Zep 开发的一个开源 Python 框架,用于构建和查询时序上下文图。它能自主将结构化和非结构化数据转换为动态知识图,跟踪事实随时间变化的有效性,保留溯源信息,并为 AI 智能体提供混合检索能力。

★ 29.5K星级
⑂ 3KFork 数
453未解决的问题
Python语言
Apache-2.0许可证
Q@project.QualityScore编辑评分

项目截图

Graphiti:为 AI 智能体构建时序上下文图 的截图 Graphiti:为 AI 智能体构建时序上下文图 的截图 Graphiti:为 AI 智能体构建时序上下文图 的截图 Graphiti:为 AI 智能体构建时序上下文图 的截图 Graphiti:为 AI 智能体构建时序上下文图 的截图 Graphiti:为 AI 智能体构建时序上下文图 的截图

概览

Graphiti 作为时序上下文图引擎,旨在克服静态、批处理导向的 RAG 系统的局限性。它持续将用户交互和企业数据整合到可查询的图中,无需完全重新计算。其核心创新在于双时态跟踪:事实被分配有效时间窗口,当新信息取代旧信息时,旧事实会自动失效而非被删除。该图由实体(具有演化摘要的节点)、事实/关系(具有时态有效性的边)、片段(原始数据溯源)和自定义类型(通过 Pydantic 模型定义的本体)组成。它支持增量更新以及结合语义搜索、BM25 关键词搜索和图遍历的混合检索。

主要功能

  • 具有双时态有效性窗口的时态事实管理
  • 从派生事实到原始源数据的片段与溯源跟踪
  • 通过 Pydantic 模型支持的规定和学习的本体
  • 无需批量重新计算的增量图构建
  • 结合语义、关键词 (BM25) 和图遍历的混合检索
  • 保留完整时态历史的自动事实失效机制
  • 可插拔的图数据库后端
  • 用于 AI 助手集成的模型上下文协议 (MCP) 服务器

要求、安装和快速入门

使用 pip (`pip install graphiti-core`) 或 uv (`uv add graphiti-core`) 安装核心包。提供特定后端的附加组件:`pip install graphiti-core[falkordb]`、`pip install graphiti-core[neptune]` 或 `pip install graphiti-core[kuzu]`(已弃用)。LLM 提供商的附加组件可以)类似地安装,例如 `pip install graphiti-core[anthropic,google-genai]`。嵌入式 FalkorDB 选项 (`graphiti-core[falkordblite]`) 需要 Python 3.12+。

用法

初始化数据库驱动(例如 Neo4jDriver 或 FalkorDriver)并将其传递给 Graphiti 构造函数。向图中添加片段(文本或 JSON),然后使用混合搜索和预定义搜索方案搜索关系或节点。`examplesDocker Compose 运行,通过 `server` 目录中的 FastAPI REST 服务访问,或通过 `mcp_server` 目录中的 MCP 服务器集成到 AI 助手中。

模型兼容性与使用场景

默认使用 OpenAI 进行 LLM 推理和嵌入。通过#通过附加组件支持 Anthropic、Google Gemini 和 Groq。兼容任何兼容 OpenAI 的 `/v1` 端点(包括8包括 DeepSeek、Together、OpenRouter、Ollama、vLLM、llama.cpp、LM Studio),使用 `OpenAIGenericClient`。通过其 v1 API 兼容层支持 Azure OpenAI。缺乏强大结构化输出支持的较小模型可能会导致不正确的模式和数据摄取失败。

许可证与风险说明

在 Apache-2.0 许可证下授权。

Editorial verification 2026-08-09: repository URL, owner, description, license and repository statistics were reviewed. License metadata: Apache-2.0. README was fetched for the channel draft; re-check repository dependencies, releases and model terms before production use.

发布与维护

截至 v0.17.0,用户可以实例化自定义数据库驱动,并使用 `graph_driver` 参数将其传递给 Graphiti 构造函数。由于上游项目不再维护,Kuzu 后端已被弃用。

Firecrawl

firecrawl/firecrawl

★ 161.1KTypeScript

LangChain

langchain-ai/langchain

★ 143.6KPython

RAGFlow

infiniflow/ragflow

★ 86.7KGo