<br />

This page guides you through setting up Conversational Analytics in Looker, including [setup requirements](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-setup#setup-and-requirements), [required permissions to use Conversational Analytics](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-setup#required-permissions), and [supported data sources](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-setup#supported-data-sources).

Learn [how and when Gemini
for Google Cloud uses your data](https://docs.cloud.google.com/gemini/docs/discover/data-governance).

> [!CAUTION]
> As an early-stage technology, Gemini for Google Cloud
> products can generate output that seems plausible but is factually incorrect. We recommend that you
> validate all output from Gemini for Google Cloud products before you use it.
> For more information, see
> [Gemini for Google Cloud and responsible AI](https://docs.cloud.google.com/gemini/docs/discover/responsible-ai).

## Before you begin

To use Conversational Analytics within a Looker instance, you and your Looker instance must meet the following requirements:

1. Gemini in Looker must be enabled for the Looker instance.
   - To access these features in a Looker (original) instance, a Looker admin must enable the **Gemini in Looker** setting and the **Conversational Analytics** setting in the [Looker (original) instance settings](https://docs.cloud.google.com/looker/docs/2606/admin-panel-platform-gil). The instance must be on Looker 25.2 or later and Looker-hosted. We recommend that customers who participate in the Looker [Extended support release program](https://docs.cloud.google.com/looker/docs/2606/standard-extended-support-release-program-overview) update to Looker 25.6 or later to use Conversational Analytics. To use Conversational Analytics data agents, update your instance to Looker 25.18.9 or later.
   - To access these features in a Looker (Google Cloud core) instance, a user with the [Looker Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/looker#looker.admin) (`roles/looker.admin`) IAM role must [enable **Gemini in Looker**](https://docs.cloud.google.com/looker/docs/looker-core-admin-gemini) in the Looker (Google Cloud core) instance settings in the Google Cloud console. A Looker admin must enable the **Conversational Analytics** setting on the **Gemini in Looker** page in the **Admin** panel of the Looker (Google Cloud core) instance.
2. If you have configured an IP allowlist for your instance, you must configure it to allow connections from Google Cloud services:
   - Admins for Looker (original) instances who have enabled the [**Enable Allowlist** setting](https://docs.cloud.google.com/looker/docs/2606/admin-panel-server-ip-allowlist) must also enable the **Allow Google Cloud services** setting.
   - If a Looker (Google Cloud core) instance has an [IP allowlist](https://docs.cloud.google.com/looker/docs/looker-core-ip-allowlist) configured, the [**Link Google services with this instance** checkbox](https://docs.cloud.google.com/looker/docs/looker-core-ip-allowlist#allowlist-services) must be selected on the [**Details** tab](https://docs.cloud.google.com/looker/docs/looker-core-view-console#details_tab) of the instance's **Instance** page in the Google Cloud console in order to connect with Conversational Analytics.
3. Optionally, an admin can [enable the Code Interpreter](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-code-interpreter) to access advanced analytics. The **Trusted Tester** capabilities must be enabled to use the Code Interpreter.

### Required Looker permissions

To use Conversational Analytics in Looker,

The use of Conversational Analytics is managed through a combination of [content access, data access, and feature access](https://docs.cloud.google.com/looker/docs/2606/access-control-and-permission-management). To perform the tasks that are described in the following table, you must be assigned a Looker role that has the required permissions for the models that underlie the individual Explore or that the data agent will query and, in some cases, access to the agent itself.

A Looker admin can grant Looker roles and permissions on the **Roles** page in the **Admin** section of the Looker instance. For more information about Looker roles, see the [Admin settings -- Roles](https://docs.cloud.google.com/looker/docs/2606/admin-panel-users-roles) documentation page.

The creator of the data agent can manage individual users' access to the agent by [sharing the agent](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-data-agents#share-a-data-agent).

| Task | Required Looker permissions on the model that underlies the data | Required level of data agent access |
|---|---|---|
| Chat with a data agent from the **Agents** tab in the Conversational Analytics interface | `access_data` <br /> `gemini_in_looker` <br /> Added 25.18 `chat_with_agent` | **View** access |
| Chat with a Looker Explore from the **Explores** tab in the Conversational Analytics interface | `access_data` <br /> `gemini_in_looker` <br /> Added 25.18 `chat_with_agent` <br /> Added 25.18 `chat_with_explore` |
| Create, edit, share, and delete Conversational Analytics data agents | `access_data` <br /> `gemini_in_looker` <br /> Added 25.18 `chat_with_agent` <br /> Added 25.18 `chat_with_explore` <br /> Added 25.18 `save_agents` <br /> Users can create agents that use only the Explores for which they have been granted this permission on the underlying model. To edit, delete, or share a data agent that was created by another user, users must be granted a role that contains this permission on every model that is used by the agent. | **Manage access; Edit** (this access is granted automatically if the user creates the agent; otherwise, **Manage access; Edit** access must be granted by the agent's creator by sharing the agent) |
| Create, edit, share, and delete Conversational Analytics data agents | `access_data` <br /> `gemini_in_looker` <br /> Added 25.18 `admin_agents` | Content access doesn't need to be granted |

Looker also has the following default roles that contain subsets of these permissions for all models on the instance:

- Conversational Analytics Agent Manager: With this role, a user can create, edit, share, delete, and chat with agents that they have **Manage access; Edit** access for and chat with Explores
- Conversational Analytics User: With this role, a user can chat with an agent that they have **View** access for
- Admin: By default, this role (Looker Admin) has all permissions and content access across the instance

## Supported data sources

You can converse with the following data sources through the Conversational Analytics interface:

- [Looker Explores](https://docs.cloud.google.com/looker/docs/2606/creating-and-editing-explores)
- [Data agents](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-data-agents)

When you "chat" with an Explore, you're essentially having a conversation with a specific, predefined dataset. This is a direct way to ask questions about the data within that Explore. You can have a conversation with up to five Explores.

Data agents are AI-powered assistants that you can create and customize. You can give them specific instructions and connect them to your Looker Explore data.

For strategies and best practices to help Looker admins and LookML developers successfully configure, deploy, and optimize Conversational Analytics, including LookML best practices for Conversational Analytics, tips on when to add context to LookML versus Conversational Analytics, and best practices for setting up an Explore for use with Conversational Analytics, see the [Best practices for configuring Conversational Analytics in Looker](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-rollout-guide) documentation page.

## What's next

- [Start a conversation with your data](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-data)
- [Create and manage data agents](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-data-agents)

## Related resources

- [Conversational Analytics in Looker overview](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-overview)
- [Recommended setup and rollout strategy for Conversational Analytics in Looker](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-rollout)
- [Best practices for configuring Conversational Analytics in Looker](https://docs.cloud.google.com/looker/docs/2606/conversational-analytics-looker-best-practices)
- [Admin settings -- Roles](https://docs.cloud.google.com/looker/docs/2606/admin-panel-users-roles)