Administer Gemini on your Looker (Google Cloud core) instance

This documentation page describes how to administer Gemini in Looker for a Looker (Google Cloud core) instance. It covers the following topics:

Different configurations of Gemini in Looker features that are available in Looker (Google Cloud core), and the steps that are required to make them accessible to Looker users
How to enable and disable Gemini in Looker for a Looker (Google Cloud core) instance
How to enable and disable the Code Interpreter, for use with Conversational Analytics
The permissions that are required to use Gemini in Looker, and how to grant them

This page is intended for users who have the Looker Admin role for the Looker (Google Cloud core) instance and the Looker Admin (roles/looker.admin) role for the Google Cloud project in which the instance resides.

What is Gemini in Looker?

Gemini in Looker is a product in the Gemini for Google Cloud portfolio that provides generative AI-powered assistance to help you analyze and gain valuable insights from your data. Gemini in Looker can provide assistance for tasks in Looker (original) instances, in Looker (Google Cloud core) instances, and in Looker Studio.

Learn how and when Gemini for Google Cloud uses your data.

Gemini in Looker may not support the same compliance and security offerings as does Looker or your other data sources. Only enable Gemini in Looker if Gemini for Google Cloud's compliance offerings meet the needs of your organization.

Gemini in Looker features are enabled through the Google Cloud console and are available on a per-instance basis. Looker users are granted access to Gemini features within the Looker (Google Cloud core) instance. For more information about the types of tasks that Gemini in Looker can assist with, see the Gemini in Looker overview documentation page.

Gemini in Looker feature availability

The availability of Gemini in Looker features is summarized in the following table. Depending on the needs of your organization, you can enable the settings that grant users access to the Gemini in Looker features that are available in the appropriate Looker platform.

Accessible Gemini in Looker features	Implementation
In Looker: Write LookML In Looker: Create custom Looker visualizations In Looker: Use Conversational Analytics In Looker: Use the Code Interpreter with Conversational Analytics	Enable Gemini in Looker (Google Cloud core). Enable the Code Interpreter. Grant permissions to use Gemini in Looker.
In Looker: Write LookML In Looker: Create custom Looker visualizations In Looker and in Looker Studio: Use Conversational Analytics In Looker and in Looker Studio: Use the Code Interpreter with Conversational Analytics In Looker Studio: Create calculated fields using natural language In Looker Studio: Export data to Slides	Enable Gemini in Looker (in Looker). Accept Looker Studio Pro licenses. Enable Gemini in Looker and the Code Interpreter (in Looker Studio). Enable the Code Interpreter in Looker (Google Cloud core). Grant permissions to use Gemini in Looker.

Before you begin

To get the permissions that you need to enable Gemini for a Looker (Google Cloud core) instance, ask your administrator to grant you the Looker Admin (roles/looker.admin) IAM role on the project in which the instance resides. For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

To perform the following tasks, you must be a Looker admin for the Looker (Google Cloud core) instance:

Enable the Code Interpreter for use with Conversational Analytics in the Looker (Google Cloud core) instance
Grant users permissions to use Gemini in Looker features

Enabling and disabling Gemini

In the Google Cloud console, follow these steps to enable Gemini:

On the Instances page, click the name of the instance for which you want to enable Gemini.
Click Edit.
Expand the Gemini in Looker (Google Cloud core) section.
Select Gemini. When this setting is enabled, users can access the Gemini in Looker features that are available as described in the Gemini in Looker feature availability table.
Select Trusted Tester features. When this setting is enabled, users can access the Trusted Tester capabilities of Gemini in Looker. This setting must be enabled in order for users to access Gemini during the pre-GA preview.
Optionally, select Trusted Tester data use. When this setting is enabled, you consent to your data being used by Google as described in the Gemini for Google Cloud Trusted Tester Program terms.

To disable Gemini for a Looker (Google Cloud core) instance, clear the Gemini setting.

You must grant the appropriate permissions to users before they can use Gemini in Looker features.

Enabling and disabling the Code Interpreter for Looker (Google Cloud core)

In the Looker (Google Cloud core) instance, follow these steps to enable the Code Interpreter and make it available to Gemini in Looker users:

Navigate to the Admin panel > Platform section > Gemini in Looker page.
Enable Code Interpreter.

The Code Interpreter is disabled by default, even when Gemini in Looker is enabled in the Looker (Google Cloud core) instance settings in the Google Cloud console.

You must grant the appropriate permissions to users before they can use the Code Interpreter.

Grant Gemini in Looker permission to users

To grant Looker users the ability to use Gemini in Looker features in your Looker instance, you must assign them a role that applies the gemini_in_looker permission to the appropriate models. You can do this in any of the following ways:

Grant users the Gemini default role
Grant users a custom role that contains the gemini_in_looker permission
Grant users Conversational Analytics permissions, permission sets, or roles
Add them to the Gemini Default Users group

Granting the Gemini default role

The gemini_in_looker permission is the only permission that is included in the Gemini default role, which by default applies to all models on the instance. You must also assign the access_data permission and any other permissions that may be necessary to use the specific Gemini in Looker feature.

You can assign this role to the appropriate users or groups.

Granting a custom role

To restrict users from accessing Gemini in Looker features for all models on the Looker instance, you can create a custom Looker role that applies the gemini_in_looker permission for specific models only, and assign it to the appropriate users or groups. You may need to remove those users from the Gemini Default Users group, which is assigned the Gemini default role by default. You must also assign the access_data permission and any other permissions that may be necessary to use the specific Gemini in Looker feature.

Granting Conversational Analytics roles or permissions

The Conversational Analytics Agent Manager role consists of the Conversational Analytics Agent Manager permission set for all models on the Looker instance. Users with this role can create, edit, share, and delete Conversational Analytics data agents that use Looker Explores.

The Conversational Analytics User role consists of the Conversational Analytics User permission set for all models on the Looker instance. Users with this role can chat with any Conversational Analytics data agent in Looker.

You can assign either of these roles to the appropriate users or groups. You can also create a custom Looker role that applies any of the Conversational Analytics permissions to specific models.

Adding users to the Gemini Default Users group

The Gemini Default Users group has been created automatically for all Looker (original) instances that use an open system configuration. Users in this group are assigned the Gemini role, which grants them the ability to use Gemini in Looker features when they also have a role that includes the other required permissions to use Gemini in Looker features.

You can edit the Gemini Default Users group to add or remove users, or to delete the group entirely. You can also add additional roles to the group.

For more information about how users are added to this group, see the Groups documentation page.

Additional Looker permissions may be needed to perform the tasks that Gemini assists with. See the Additional permissions section on this page for a list of these permissions.

Additional permissions

The following Gemini in Looker features require additional permissions:

To create custom visualizations with Gemini assistance, you must be assigned a Looker role that contains the can_override_vis_config permission.
To write LookML with Gemini assistance, you must be assigned a Looker role that contains the develop permission for at least one model in a LookML project.
To query Looker data, or to create a data agent with Conversational Analytics or with the Conversational Analytics API, you must be assigned a Looker role that contains the access_data permission for the model that you are querying. Additional permissions are required to manage and use data agents with Conversational Analytics in Looker.

Provide feedback

You can provide feedback about each Gemini in Looker feature. Instructions for how to submit feedback are included in the documentation for each feature.