展开本页目录
开始前准备什么
- 下载完整练习包，在独立目录阅读README与已执行范围。
- 安装requirements.txt指定版本或使用文中目标工具；依赖与模型权重不要混入网站工程。
- 只有明确标为已执行的部分有本次证据；真实模型、账号或GPU步骤按自己的环境另行验证。
- 分开发生与入库时间
- 复算历史查询真值
- 建立隔离Graphiti组
- 以reference_time提交事件
- 检查真实事实有效区间
- 分别查询当前和历史
- 交付迟到事件与查询证据
1. 分开发生与入库时间
E-new先入库但10月5日发生，E-late后入库却描述10月1日事件。两个时间字段都保存，不能只按收到消息的先后改当前负责人。
2. 复算历史查询真值
audit.py按valid_at排序，10月3日应A、10月6日应B。负例latest_ingested_wins会把A误当当前负责人；此表是作者事件真值。
本题独立目录执行
bash
python reference/audit.py3. 建立隔离Graphiti组
在测试数据库用独立group_id存项目实体及两条episode，记录数据库、SDK版本与模型配置。没有图数据库或模型时不要伪造入图成功。
本题SDK或目标环境入口
bash
python reference/run_sdk.py
4. 以reference_time提交事件
调用add_episode时把发生时间传reference_time，保留原文与ingested时间。晚到记录不应该被简单等价为当前新事实。
5. 检查真实事实有效区间
回读edge的valid_at/invalid_at、episode来源与节点UUID。模型冲突识别可能错，必须逐条核对，不因有时间字段就假设自动正确。
6. 分别查询当前和历史
设置合适时间过滤查询同一负责人关系。实际Graphiti结果应能解释来源及有效区间，不能拿作者排序表冒充知识图谱响应。
7. 交付迟到事件与查询证据
保存两类时间、事实变化、查询过滤和原始返回。当前包只做事件序列审计，图谱入库、抽取和回答均需真实目标环境补证。
怎样确认已经完成
- 迟到入库不等于新发生
- 当前和历史有各自证据
- 未执行前不保证自动冲突判断正确
- 已用真实Graphiti EntityEdge构造并核对created_at与valid_at双时间字段，另运行作者事件排序；未执行LLM抽取、数据库写入或历史图查询。
常见问题
Graphiti迟到的历史消息怎么按发生时间入图？
将事件发生时间传reference_time并保留独立入库时间。真实EntityEdge模型可存valid_at/created_at，但冲突抽取效果仍需数据库/LLM验证。
Graphiti怎么分别查当前和过去的负责人？
按实际事实有效区间和时间过滤分别查询；作者真值10月3日A、10月6日B。本文未运行历史图查询，不把排序表当Graphiti响应。
这篇教程哪些步骤已经真正执行？
已用真实Graphiti EntityEdge构造并核对created_at与valid_at双时间字段，另运行作者事件排序；未执行LLM抽取、数据库写入或历史图查询。