Use this topic to connect Google Gemini models as a Bring Your Own Model (BYOM) for Cribl AI. This page covers:

• What you need from the Google Gemini side.
• How to fill in each step of the Cribl configuration wizard.

For the generic wizard flow, prerequisites, and how to edit or delete a configured provider, see Configure Custom AI Providers.

Cribl reaches Gemini through Google’s OpenAI-compatible endpoint. You do not enter an endpoint URL in the wizard: Cribl uses https://generativelanguage.googleapis.com/v1beta/openai/ by default.

Prerequisites ​

In addition to the general prerequisites, you need:

• A Google account with access to the Gemini API.
• A Gemini API key with permission to call the models Cribl sends (see Required Model IDs below).
• On-prem only: Network connectivity from the Leader to https://generativelanguage.googleapis.com (public internet or corporate proxy).

Required Model IDs ​

Cribl AI agents use one model per tier. The wizard pre-fills suggested defaults and restricts selection to supported models.

Suggested defaults:

All supported models (available in the wizard dropdown):

The wizard dropdown for each tier only shows models that are eligible for that tier. For example, Gemini 3.1 Flash-Lite appears only in the Small dropdown.

Make sure the API key you provide can call each model you assign before saving.

For details on model categories and token limits, see Model IDs and Feature Routing.

Step 1: Select the Provider Type ​

Navigate to your AI Settings and open the configuration wizard:

1. Select Use Custom AI Provider.
2. Select the Google Gemini tile.
3. Select Continue.

Step 2: Enter Connection Details ​

Provide the credentials Cribl needs to reach Gemini. Gemini does not use a URL field: Cribl reaches Google’s OpenAI-compatible endpoint automatically.

• ID: Enter a short, unique identifier (for example, google-gemini-prod). Avoid putting secrets or keys in this field.
• Description: Enter a human-readable label for the provider card (for example, Google Gemini - production). This field is optional.
• API key: Paste your Gemini API key.

If you are unsure which key to use, ask the team that manages AI providers and Gemini access to issue or confirm the correct key for your deployment.

When editing an existing provider, leave the API key field blank to keep the stored key, or enter a new value to replace it. See Edit an Existing Custom AI Provider.

Select Continue.

Step 3: Assign Models to Tiers and Test ​

Assign models to each tier. For Google Gemini, the wizard presents a dropdown of supported model IDs with the suggested defaults pre-filled.

The Reasoning tier supports multiple model IDs, with the first model in the list serving as the system default. While most features exclusively use this first model, Cribl Search investigations allow you to switch between any listed models via a dropdown menu.

1. For Small and Frontier, select a model from the dropdown or accept the suggested default.
2. For Reasoning, accept the suggested default or add additional model IDs.
3. To restore the suggested defaults for all tiers, select Reset to Defaults. See Reset Model Tiers to Suggested Defaults.
4. Select Test and Save.

Cribl runs a connectivity check for each assigned model, sending a basic request through Google’s OpenAI-compatible endpoint to confirm that the model is reachable and responds. This does not test model performance or feature compatibility.

• A results panel shows how many models passed and failed.
• If any test fails, verify that the API key is valid and that the listed model IDs are available for your key. Select Retry to test again.
• When all models pass, the configuration is saved automatically.

After you save:

• A Custom AI provider card appears at the top of AI Settings, showing your ID, description, Google Gemini as the provider type, and the number of configured models.
• Supported Cribl AI capabilities in that Workspace begin using Google Gemini as their AI backend.

Verify Cribl AI Behavior ​

To confirm that Google Gemini is correctly configured:

1. In AI Settings, confirm that the Custom AI provider card lists Google Gemini.
2. Use a supported Cribl AI capability (for example, the KQL assistant or Git commit message suggestions).
3. Verify that:
   • Requests succeed without provider-related errors.
   • Latency and behavior align with your expectations for the Gemini models you configured.

If you see failures or unexpected behavior:

• Select the gear (⚙️) on the provider card and select Edit to reopen the wizard, then use Test and Save to review error details.
• Confirm with your AI team that:
  • The key is valid and not rate-limited.
  • The Gemini models you assigned are available for your key.
  • For on-prem deployments: Network rules allow the Leader to reach https://generativelanguage.googleapis.com.

Change or Stop Using Google Gemini ​

• To update the provider (for example, after a key rotation or model change), see Edit an Existing Custom AI Provider.
• To stop using Google Gemini, see Delete a Custom AI Provider.
• To use this provider again after deletion, follow the steps in this topic to reopen the wizard and reconfigure.