Gemini Integration

Buildnote's AI features use a model provider that you own. Connect Google Gemini with an API key from your own Google account, and every AI request your team makes, such as a failure summary or a question in AI Insights, is answered by the model you pick, using your key.

See AI Insights for what those two features do once a provider is connected.

Before You Start

Your team needs a Pro or Enterprise plan. You also need the Admin or Billing Manager role, because only those roles can install and configure integrations.

Then turn on the AI features. Under Settings > General > Event Collection, enable AI Insights ("Use AI to gain better insights (e.g. summarise failures or detect flaky tests)"). If you connect a provider without turning on that switch, Buildnote stores the credentials but the features stay off.

IMPORTANT

A team holds one Gemini integration at a time. You can connect Anthropic or OpenAI alongside it, but only one connected provider answers AI requests, and you can't choose which one. When you switch providers, disconnect the old one instead of leaving both connected.

Step 1. Create A Gemini API Key

Sign in to Google AI Studio and create a Gemini API key. Google keys begin with AIza. The value is shown only once, so copy it before you leave the page.

Use a Gemini API key, not a Vertex AI service account, because Buildnote calls the Gemini API. The form in the app links to the Google Cloud console instead, which issues the same kind of key. Google bills the token usage on the key to your own account.

Step 2. Connect The Gemini Integration

In Buildnote navigate to Settings > Integrations, find Gemini under Available and select Connect.

Step 3. Enter The Integration Details

Give the integration a name you'll recognise in the integrations list, paste the API key, and choose a model.

The model dropdown lists the supported Gemini models, with the recommended one already selected. Flash models cost less per request, while the Pro models handle harder questions.

Select Create. Buildnote stores the key encrypted and uses it only for your team's requests.

Step 4. Integration Connected

The integration now appears in the Connected section under the name you gave it.

From now on, failure summaries appear on failed events as they arrive, and AI Insights is ready to answer questions.

Step 5. Change The Name Or Model

Select Configure on the connected integration, then Edit next to the field you want to change. A new name or model saves straight away and applies from the next request. You don't need to change anything else in the app.

The same page has a Disconnect button, which removes the integration and the stored key. To rotate a key, disconnect and then connect again with the new value.

Costs

AI requests are billed on top of your plan, and every AI Insights reply shows what it cost. You can find pricing for each plan on the pricing page. Google charges the token usage on your key separately.