常见问题
常见问题
先找到最早出现的错误,再处理后续连带问题。认证和配置错误通常不需要重建索引,查询无结果也不一定要扩大模型上下文。
GraphRAG 索引失败怎么办?
先运行 graphrag index --dry-run,再按五步排查方法检查版本、密钥、输入目录和输出文件。不要在配置尚未通过时反复开始付费索引。
GraphRAG 如何接入其他模型?
查看模型与 Provider 配置和自定义模型配置。重点核对模型类型、端点、部署名、API 版本和环境变量,而不是只替换模型名称。
GraphRAG 建索引为什么这么贵?
索引过程会执行文本切分、实体与关系抽取、社区划分和报告生成,其中多步需要模型调用。先用小样本确认流程,记录调用量与输出质量,再扩大输入。不要把未经验证的大型私有数据直接用于第一次索引。
全局搜索和局部搜索有什么区别?
Global 适合回答整个数据集的主题和趋势,Local 适合围绕具体实体查找关系与原文。需要更广覆盖或普通向量基线时,还可以选择 DRIFT 或 Basic。详见查询模式怎么选。
中文文档如何处理?
先用真实中文样本检查切分、实体名称、关系描述和社区报告,再决定是否调整提示词。可以从自动 Prompt Tuning生成起点,但仍需用固定问题比较调整前后的结果。
旧教程里的命令为什么不能用了?
GraphRAG 3.x 使用 graphrag init/index/query/prompt-tune/update。旧教程中的 python -m graphrag.index 等入口需要迁移,具体对照见旧 CLI 升级到 3.x。
已有索引需要加入新数据时,使用:
graphrag update更新前保留上一份可以查询的输出,并用几条固定问题比较新旧结果、延迟和费用。
最后更新于