Skip to main content
Version: v0.4.0

remote::vertexai

Description

Google Vertex AI inference provider enables you to use Google's Gemini models through Google Cloud's Vertex AI platform, providing several advantages:

• Enterprise-grade security: Uses Google Cloud's security controls and IAM • Better integration: Seamless integration with other Google Cloud services • Advanced features: Access to additional Vertex AI features like model tuning and monitoring • Authentication: Uses Google Cloud Application Default Credentials (ADC) instead of API keys

Configuration:

  • Set VERTEX_AI_PROJECT environment variable (required)
  • Set VERTEX_AI_LOCATION environment variable (optional, defaults to us-central1)
  • Use Google Cloud Application Default Credentials or service account key

Authentication Setup: Option 1 (Recommended): gcloud auth application-default login Option 2: Set GOOGLE_APPLICATION_CREDENTIALS to service account key path

Available Models:

  • vertex_ai/gemini-2.0-flash
  • vertex_ai/gemini-2.5-flash
  • vertex_ai/gemini-2.5-pro

Configuration

FieldTypeRequiredDefaultDescription
allowed_modelslist[str] | NoneNoList of models that should be registered with the model registry. If None, all models are allowed.
refresh_modelsboolNoFalseWhether to refresh models periodically from the provider
projectstrNoGoogle Cloud project ID for Vertex AI
locationstrNous-central1Google Cloud location for Vertex AI

Sample Configuration

project: ${env.VERTEX_AI_PROJECT:=}
location: ${env.VERTEX_AI_LOCATION:=us-central1}