Graphiti

项目简介

Graphiti 是一个用于构建和查询面向 AI 代理的时序上下文图的框架。与静态知识图谱不同，它跟踪事实随时间的变化，维护对源数据的溯源，并支持预设和习得的本体。它持续将用户交互、结构化和非结构化企业数据以及外部信息整合到一个连贯、可查询的图中。

核心功能

• 时序事实管理：事实具有有效性窗口；旧事实被失效而非删除。
• 事件与溯源：每个实体和关系都追溯到原始事件。
• 预设与习得本体：通过 Pydantic 模型定义实体和边类型，或让结构从数据中涌现。

适用场景

• 构建随每次交互演化的时序知识图谱。
• 表示丰富的结构化上下文，而非扁平文档块。
• 通过混合检索跨时间、语义和关系进行查询。

快速开始

• 使用 pip install graphiti-core 安装。需要 Python 3.10+、图数据库（Neo4j、FalkorDB、Amazon Neptune 或 Kuzu）以及 OpenAI API 密钥。参见快速入门示例以了解连接、初始化索引、添加事件和搜索。

部署与要求

• Python 3.10 或更高版本；Neo4j 5.26 / FalkorDB 1.1.2 / Amazon Neptune Database Cluster 或 Neptune Analytics Graph + Amazon OpenSearch Serverless collection / Kuzu 0.11.2（已弃用）；OpenAI API 密钥（Graphiti 默认使用 OpenAI 进行 LLM 推理和嵌入）。可选：Google Gemini、Anthropic 或 Groq API 密钥（用于替代 LLM 提供商）。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。