配置概述
GraphRAG 3.x 默认使用项目根目录下的 settings.yaml 和 .env。graphrag init 会生成可运行起点，不建议从旧版配置逐字段拼接。
配置文件与密钥
| 位置 | 保存内容 | 是否提交 Git |
|---|---|---|
settings.yaml | 模型 Provider、模型名、输入、缓存、存储、工作流和查询参数 | 是，移除敏感值后 |
.env | GRAPHRAG_API_KEY 等密钥 | 否 |
| 环境变量/密钥系统 | 部署环境覆盖和生产密钥 | 否 |
修改后的验证顺序
graphrag index --dry-run
graphrag index
graphrag query "What are the top themes?"只通过 YAML 语法检查还不够：Provider 字段、模型能力和凭据错误通常要到 GraphRAG 预检或真实请求时才会暴露。
最后更新于