Skip to main content

Google Gemini Connector

Guide to connecting Google Gemini

Updated over a week ago

The Google Gemini Connector lets Savant authenticate to Google Cloud Platform (GCP) using a service account and securely call Gemini models (via Google’s GenAI services) from within Savant workflows.

Features

Can be used with GenAI Agents

Requirements

Following requirements must be met to establish the connection between Savant and Google Gemini Connector

  • A GCP project with billing enabled

  • Permissions to manage APIs, IAM, and service accounts in that project

  • Savant IP addresses whitelisted.

  • Permissions:

    • Vertex AI User (recommended baseline)

    • Add additional roles only if your org requires them for your specific usage (for example, broader Vertex AI permissions)

Connection Methods

Savant connects to Google Gemini using a service account JSON key that you generate in GCP and upload/paste into Savant.

JSON Key Method

Step 1: Set up GCP (Project ID, Location, Service Account JSON)

  • Open Google Cloud Console

  • Use the project selector (top bar) to choose your project

  • Copy the Project ID (for example: )

Step 2: Enable required APIs

In GCP:

  • Go to APIs & Services

  • Click Enable APIs and services

  • Enable the relevant Gemini/GenAI APIs for your project (commonly includes Gemini/Vertex AI related APIs)

Step 3: Create a Service Account

  • Go to IAM & Admin → Service Accounts

  • Click Create Service Account

  • Enter:

    • Service account name

    • Service account ID

    • (Optional) description

  • Continue and assign the required role(s) (start with Vertex AI User)

Step 4: Generate a JSON Key for the Service Account

  • Open the created service account

  • Go to the Keys tab

  • Click Add key → Create new key

  • Select JSON

  • Download the file

Step 5:

  • In Savant, go to Systems page

  • Select Google Gemini

  • Enter the following:

    • GCP Project ID- Copied Earlier

    • Location- Select from the dropdown based on GCP Instance

    • Service Account Credentials- JSON key copied. Can be uploaded as well

Troubleshooting:

  1. Verify the GCP Project ID in Savant matches the project selected in the GCP Console.

  2. Confirm the Location (region) you entered is valid for your setup (for example, us-central1) and matches where Gemini/Vertex AI is enabled.

  3. Make sure the service account JSON key is the correct, unmodified file and that the key hasn’t been deleted or revoked.

  4. Check that the service account has the required IAM roles (start with Vertex AI User) and add only what’s needed if you see permission errors.

  5. Ensure the required Gemini/Vertex AI APIs are enabled and billing/quota is active for the project.

Did this answer your question?