Neo4j LLM Graph Builder项目中Gemini模型的配置指南

在Neo4j LLM Graph Builder项目中集成Google Gemini系列大语言模型时，正确的环境变量配置是关键环节。本文将详细介绍前后端环境配置要点，帮助开发者快速搭建Gemini模型运行环境。

前端环境配置

前端配置相对简单，主要需要关注与后端的连接参数：

VITE_BACKEND_API_URL=""  # 后端API地址
VITE_BLOOM_URL="..."     # Neo4j工作区预览URL
VITE_REACT_APP_SOURCES=""
VITE_LLM_MODELS_PROD=""
VITE_ENV="PROD"         # 环境标识
VITE_TIME_PER_PAGE=50   # 页面处理时间限制
VITE_CHUNK_SIZE=5242880 # 文件分块大小(5MB)
VITE_LARGE_FILE_SIZE=5242880
VITE_CHAT_MODES=""
VITE_BATCH_SIZE=2       # 批量处理大小
VITE_LLM_MODELS=""
DEPLOYMENT_ENV="local"  # 部署环境标识

后端核心配置

后端需要配置Gemini各版本模型标识及认证参数：

# Gemini模型版本配置
LLM_MODEL_CONFIG_gemini_1.5_pro="gemini-1.5-pro-002"
LLM_MODEL_CONFIG_gemini_1.5_flash="gemini-1.5-flash-002"
LLM_MODEL_CONFIG_gemini_2.0_flash="gemini-2.0-flash-001"
LLM_MODEL_CONFIG_gemini_2.5_pro="gemini-2.5-pro-exp-03-25"

# 功能开关
GEMINI_ENABLED="true"

# GCP认证(可选)
GOOGLE_APPLICATION_CREDENTIALS="/path/to/gcp.json"

认证配置要点

1. 项目ID设置：可通过以下任一方式指定Google Cloud项目ID：

   • 代码构造函数参数
   • 使用vertexai.init()初始化
   • 执行gcloud命令：gcloud config set project my-project
   • 设置GCP环境变量

2. 服务账号认证：推荐使用服务账号JSON文件认证，通过环境变量指定路径：

   export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
   

3. 命令行认证：开发环境下可使用快捷认证方式：

   gcloud auth application-default login
   

最佳实践建议

1. 生产环境建议使用服务账号认证而非个人账号
2. 不同环境(开发/测试/生产)应使用独立的项目ID
3. 大文件处理时注意调整分块大小参数
4. 模型版本更新时及时同步环境配置
5. 敏感凭证信息不应直接提交到代码仓库

通过以上配置，开发者可以快速在Neo4j LLM Graph Builder项目中集成Gemini系列模型，充分利用其强大的图数据生成和处理能力。实际部署时，还需根据具体业务需求调整批处理大小、超时设置等参数。