> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rootly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Gemini

> Connect Rootly to Google Gemini to send prompts to Gemini models from incident and action item workflows for AI-assisted summaries and triage.

## Introduction

The Google Gemini integration lets you connect Rootly to your organization's Google Gemini API account. Once connected, a new **Gemini Chat Completion** workflow action becomes available, allowing you to send prompts to Gemini models and capture their responses — directly within your incident and action item workflows.

With the Google Gemini integration, you can:

* Generate AI-powered incident summaries, analyses, and recommendations
* Send custom prompts to Gemini models with full Liquid template support
* Use a system prompt to define the model's role, tone, or output constraints
* Choose from any Gemini model available on your API account

## Before You Begin

Before setting up the Google Gemini integration, make sure you have:

* A Rootly account with permission to manage integrations
* A [Google AI Studio API key](https://aistudio.google.com/app/apikey) with access to Gemini models

<Callout icon="triangle-exclamation" color="#FEF3C7">
  Your API key is validated against the Gemini API when you save the integration. If validation fails, confirm the key is active and has access to at least one Gemini model.
</Callout>

## Installation

<Steps>
  <Step title="Open the integrations page in Rootly" icon="plug">
    Navigate to the integrations page in your Rootly workspace and select **Google Gemini**.
  </Step>

  <Step title="Enter your API key" icon="key">
    Paste your Google AI Studio API key into the **API Key** field. Rootly validates the key by fetching your available Gemini models before saving. Your key is encrypted at rest in Rootly.
  </Step>

  <Step title="Integration connected" icon="circle-check">
    <Callout icon="circle-check" color="#DCFCE7">
      Your Google Gemini integration is active. The **Gemini Chat Completion** workflow action is now available in your incident and action item workflows.
    </Callout>
  </Step>
</Steps>

## Workflow Actions

### Gemini Chat Completion

Sends a prompt to a Gemini model and captures the response as a workflow output. The model list is fetched dynamically from your API account.

| Field         | Description                                                                | Required |
| ------------- | -------------------------------------------------------------------------- | -------- |
| Model         | The Gemini model to use — fetched from your account                        | Yes      |
| Prompt        | The user message — supports Liquid templating                              | Yes      |
| System Prompt | Instructions for the model's role or behavior — supports Liquid templating | No       |

<Callout icon="code" color="#EDE9FE">
  Use Liquid variables in your prompts to include live incident context — for example `{{ incident.title }}`, `{{ incident.severity }}`, and `{{ incident.description }}`. See the [Liquid variables reference](/liquid/incident-variables) for all available fields.
</Callout>

The **System Prompt** field sets the model's persona or output format — for example: *"You are an incident response assistant. Respond in bullet points. Be concise."*

## Troubleshooting

<AccordionGroup>
  <Accordion title="The API key is rejected on save" icon="key">
    Rootly validates your API key by fetching the list of available Gemini models when you save. If validation fails, confirm the key is active in [Google AI Studio](https://aistudio.google.com/app/apikey) and has not been revoked or restricted.
  </Accordion>

  <Accordion title="The workflow action fails with an authentication error" icon="lock">
    If the integration was working and then stopped, the API key may have been revoked or rotated. Update the key in the integration settings — Rootly re-validates on save.
  </Accordion>

  <Accordion title="The workflow action fails with a rate limit error" icon="gauge-high">
    Google Gemini enforces rate limits based on your API tier. Running many concurrent workflows may exceed requests-per-minute limits. Consider staggering workflows or upgrading your Google AI Studio plan for higher quota.
  </Accordion>

  <Accordion title="A model is not appearing in the model selector" icon="robot">
    The model list is fetched dynamically from your API account and is filtered to Gemini models. If a model you expect is missing, confirm your API key has access to it — some models may require specific API tiers or allowlisting.
  </Accordion>

  <Accordion title="Liquid variables are not rendering correctly in the prompt" icon="code">
    Check your Liquid syntax — unclosed tags or undefined variables can cause rendering failures. Use the [Liquid variables reference](/liquid/incident-variables) to confirm variable names and test your template in a low-stakes workflow first.
  </Accordion>
</AccordionGroup>

## Related Pages

<CardGroup cols={3}>
  <Card title="Incident Workflows" icon="bolt" href="/workflows/incident-workflows">
    Build workflows that use Gemini models to analyze, summarize, or respond to incidents.
  </Card>

  <Card title="Liquid Variables" icon="code" href="/liquid/incident-variables">
    Reference for all incident variables available in Liquid-templated prompts.
  </Card>

  <Card title="Rootly AI" icon="robot" href="/ai/ai">
    Learn about Rootly's built-in AI features for incident management.
  </Card>
</CardGroup>