This documentation page describes how to administer Gemini in Looker for a Looker (original) instance. It covers the following topics:
- Different configurations of Gemini in Looker features that are available in Looker (original)
- How to enable and disable Gemini in Looker for a Looker (original) instance
- The permissions that are required to use Gemini in Looker, and how to grant them
This page is intended for users who are assigned the Looker Admin role for the Looker (original) instance.
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 .
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.
- In Looker: Write LookML
- In Looker: Create custom Looker visualizations
- In Looker: Use Conversational Analytics
- In Looker: Write LookML
- In Looker: Create custom Looker visualizations
- In Looker and in Looker Studio: Use Conversational Analytics
- In Looker Studio: Create calculated fields using natural language
- In Looker Studio: Export data to Slides
Before you begin
To enable or disable Gemini in Looker and to grant users permissions to use Gemini in Looker features, you must be assigned the Looker Admin role for the Looker (original) instance.
To support Gemini in Looker, the following requirements must be met:
- The Looker instance must be on Looker 25.0 or higher
- The Looker instance must be Looker-hosted
Enabling and disabling Gemini
To enable Gemini in Looker, follow these steps:
- In the Adminpanel, navigate to the Platformsection and select the Gemini in Lookerpage.
- Under Gemini in Looker enablement, turn on the Enable Gemini in Lookersetting. 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 Enable Trusted Tester Features. When this setting is enabled, users can access the Trusted Tester capabilities of Gemini in Looker. This setting must be enabled to allow users to access Gemini during the pre-GA preview.
- Optionally, select Enable 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 . This setting can be enabled only when the Enable Trusted Tester Featuressetting is enabled. This setting is enabled automatically when the Enable Trusted Tester Featuressetting is enabled.
- Optionally, select Enable Code Interpreter. When this setting is enabled, users can access the Code Interpreter in Conversational Analytics. This setting can be enabled only when the Enable Trusted Tester Featuressetting is also enabled. The Enable Code Interpretersetting was enabled by default for Looker (original) instances that had the Enable Gemini in Lookerand Enable Trusted Tester Featuressettings turned on prior to being updated to Looker 25.8 and had been updated to Looker 25.8 on the first day of release deployments .
To disable Gemini for a Looker (original) instance, clear the Enable Gemini in Lookersetting.
Grant the Gemini in Looker permission to users
To grant Looker users the ability to use Gemini in Looker features in the Looker (Google Cloud core) 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 them the Geminidefault role
- Grant them a custom role that contains the
gemini_in_looker
permission - Add them to the Gemini Default Usersgroup
Granting the Geminidefault 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.
To update an individual user's settings to assign the default Geminirole, follow these steps:
- Navigate to the Userspage in the Userssection of the Adminpanel.
- Select the user or group whose permissions you want to change.
- From the Rolesdrop-down menu, select Gemini.
- Select Saveto retain these settings.
You can also assign the Geminirole to multiple users or groups from the Rolespage in the Userssection of the Adminpanel by following these steps:
- Navigate to the Rolespage in the Userssection of the Adminpanel.
- Next to the Geminirole, select Edit.
- Under Groupsor Users, select the groups or users that you want to assign the Geminirole to.
- Click Update Roleto retain these settings.
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 to specific models only, and assign it to the appropriate users. You may need to remove those users from the Gemini Default Users
group, which is assigned the Geminidefault role by default.
To assign a custom role, follow these steps:
- Navigate to the Rolespage in the Userssection of the Adminpanel.
- Select New Permission Set.
- Provide a label for your new permission set in the Namefield.
- Select the
gemini_in_looker
permission and click New Permission Set. - Select New Role.
- Provide a label for your new role in the Namefield.
- For Permission Set, select the permission set that you just created.
- For Model Set, select the specific models that you would like to apply the
gemini_in_looker
permission to. You may need to create a model set that contains the appropriate models before you can assign a model set to your new custom role. - Under Groupsor Users, select the groups or users that you want to assign the custom role to. You can also add users and groups to the role later by updating the role settings.
- Click New Roleto save this custom role.
Adding users to the Gemini Default Usersgroup
The Gemini Default Usersgroup has been created automatically for all Looker (original) instances that use an open system configuration . Users in this group are assigned the Geminirole , which grants them the ability to use Gemini in Looker features.
You can edit the Gemini Default Usersgroup 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 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 data or create a data agent with Conversational Analytics
, you must be assigned a Looker role that contains the
access_data
permission for the model that you are querying.
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.