展开本页目录
开始前准备什么
- 下载完整练习包，在独立目录阅读README与已执行范围。
- 安装requirements.txt指定版本或使用文中目标工具；依赖与模型权重不要混入网站工程。
- 只有明确标为已执行的部分有本次证据；真实模型、账号或GPU步骤按自己的环境另行验证。
- 先写实体与关系定义
- 验证反向端点反例
- 为实体添加明确属性
- 把edge_type_map传入Graphiti
- 导入含干扰表述的episode
- 回读每条边的端点类型
- 交付schema与误连清单
1. 先写实体与关系定义
只定义Device、Location和Device→Location的InstalledAt。关系名称相同但端点倒过来不应默认为等价。
2. 验证反向端点反例
audit.py接受Device安装到Location，拒绝Location安装到Device。这个检查只验证作者类型表，不证明LLM抽取不会漏项。
本题独立目录执行
bash
python reference/audit.py3. 为实体添加明确属性
在Pydantic模型中定义设备编号、地点名称等字段及提取描述；不要只写空类。导出schema留档，来源文本仍需单独保存。
本题SDK或目标环境入口
bash
python reference/run_sdk.py
4. 把edge_type_map传入Graphiti
按当前SDK把实体模型和允许端点组合交给add_episode；先核对安装版方法参数。普通JSON校验与关系抽取约束不是同一个步骤。
5. 导入含干扰表述的episode
给材料加入“地点包含设备”等容易反向理解的句子。保存模型实际抽出的类型与原句，不把作者正确三元组预填成结果。
6. 回读每条边的端点类型
检查source/target UUID对应什么类型、属性是否缺失、关系是否被错误反转。类型合格也不能代替事实正确。
7. 交付schema与误连清单
输出类型模型、映射、原文及实际抽取差异；未执行抽取时只交作者合同。本包不声称已验证Graphiti模型抽取正确率。
怎样确认已经完成
- 只声明类型约束可用
- 模型漏抽仍需人工核验
- 错误类型不能被默许
- 已核对真实Graphiti add_episode实体/edge_type_map参数并构造有字段的Pydantic schema；未执行实体关系抽取或图数据库写入。
常见问题
Graphiti怎么自定义实体和关系类型？
使用有明确字段描述的Pydantic实体/关系模型及edge_type_map；本次核对真实add_episode签名和schema，未跑抽取。
设备和地点关系抽错类型，怎么检查端点约束？
回读source/target UUID对应的类型，只允许Device→Location的InstalledAt。作者负例反向边会失败，但未证明模型抽取端点不会错。
这篇教程哪些步骤已经真正执行？
已核对真实Graphiti add_episode实体/edge_type_map参数并构造有字段的Pydantic schema；未执行实体关系抽取或图数据库写入。