展开本页目录
开始前准备什么
- 下载完整练习包，在独立目录阅读README与已执行范围。
- 安装requirements.txt指定版本或使用文中目标工具；依赖与模型权重不要混入网站工程。
- 只有明确标为已执行的部分有本次证据；真实模型、账号或GPU步骤按自己的环境另行验证。
- 建立同名不同客户的关系
- 用作者图复算距离
- 取得真实中心节点UUID
- 选择node-distance重排配置
- 固定候选比较默认与中心重排
- 检查不可达结果如何处理
- 交付中心及候选归属
1. 建立同名不同客户的关系
device-N与device-S都叫巡检项目，但只前者与client-N相连。名称相同不应让两条结果拥有相同业务归属。
2. 用作者图复算距离
audit.py从client-N做BFS，device-N距离2，device-S不可达。该结果是作者关系基准，不是Graphiti搜索分数。
本题独立目录执行
bash
python reference/audit.py3. 取得真实中心节点UUID
在Graphiti中查回目标客户实体并记录UUID；不能把示例标签client-N直接当真实数据库UUID传入。
本题SDK或目标环境入口
bash
python reference/run_sdk.py
4. 选择node-distance重排配置
使用当前search配置中支持中心节点的重排策略，传center_node_uuid；默认RRF与图距离的分数含义不同。
5. 固定候选比较默认与中心重排
记录同一query、group和候选下两种排序，不同时换语料或候选数。真实图关系和embedding都应保留来源。
6. 检查不可达结果如何处理
不要把None距离显示成0；同名但无关联结果应明确其不确定性。重排更靠前也不证明该事实绝对正确。
7. 交付中心及候选归属
保留中心UUID、实际返回顺序、关系路径和同名反例。本文未运行Graphiti检索与模型，只执行作者BFS基准。
怎样确认已经完成
- 中心UUID确实存在
- 同名误命中单列
- 不声称相似度越大关系越近
- 已读取真实Graphiti node-distance检索recipe并执行作者BFS参考；未执行数据库检索、模型embedding或原生距离重排。
常见问题
Graphiti怎么围绕一个客户重排关系结果？
获取客户真实UUID并选择node_distance重排配置，保持候选与query固定。本次读取真实recipe并跑作者BFS，未跑原生检索。
多个项目同名时，center_node_uuid怎么帮助找对事实？
中心节点的图距离能区分同名不同归属；作者device-N距离2、device-S不可达。None不能显示为0，也不代表图中缺关系就一定不相关。
这篇教程哪些步骤已经真正执行？
已读取真实Graphiti node-distance检索recipe并执行作者BFS参考；未执行数据库检索、模型embedding或原生距离重排。