YAML 与 JSON 配置

graphrag init 默认生成 settings.yaml；3.3.0 也支持等价的 JSON 配置。模型配置使用具名字典，各工作流通过键引用模型。

completion_models:
  default_completion_model:
    model_provider: openai
    model: gpt-4.1
    auth_method: api_key
    api_key: ${GRAPHRAG_API_KEY}

embedding_models:
  default_embedding_model:
    model_provider: openai
    model: text-embedding-3-large
    auth_method: api_key
    api_key: ${GRAPHRAG_API_KEY}

修改顺序

先用当前版本的 graphrag init 生成完整默认配置。
修改模型 Provider、模型名、输入和存储等必要字段。
敏感值只用 ${ENV_VAR} 引用，不直接写入配置。
执行 graphrag index --dry-run 验证配置和工作流。

大版本升级时不要把旧配置整份复制过去。应基于新模板迁移必要值，再用迁移工具处理已有索引。

最后更新于 2026年10月27日

初始化项目环境变量