<br />

> [!WARNING]
>
> **Preview**
>
>
> This product or feature is
>
> subject to the "Pre-GA Offerings Terms" in the General Service Terms section
> of the [Service Specific
> Terms](https://docs.cloud.google.com/terms/service-terms#1).
>
> Pre-GA products and features are available "as is" and might have limited support.
>
> For more information, see the
> [launch stage descriptions](https://cloud.google.com/products/#product-launch-stages).

> [!NOTE]
> **Note:** This feature is in preview with limited support. We encourage you to share your feedback to help us improve. To report bugs or issues, reach out to [looker-workflows-fb@google.com](mailto:looker-workflows-fb@google.com) and include the following details:
>
> - A clear description of the problem and the expected behavior
> - Steps to reproduce the issue
> - Any additional relevant details

Agentic workflows let you prompt a data agent to generate a dynamic alert by using the Conversational Analytics chat interface. Instead of manually building complex alerts, you can use natural language in a conversation with an Explore or a data agent to set up threshold-based monitoring of the [measures](https://docs.cloud.google.com/looker/docs/2614/glossary.md.txt#measure) in the conversation's data source.

When you prompt Conversational Analytics to create a triggered agentic workflow, you can specify the conditions of the workflow, which are checked at a frequency that you specify. When these conditions are met, the workflow triggers a notification to the recipients that you specify and by using the method that you specify. When setting up your workflow, you can also specify whether you want the workflow notification to include results from Gemini-powered **Key driver analysis**, which provides insight about why the change that triggered your workflow occurred.

## What data can you monitor?

You can use Conversational Analytics to generate a workflow that monitors any [measures](https://docs.cloud.google.com/looker/docs/2614/glossary.md.txt#measure) in the conversation's data source. For [Explore data agents](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-data.md.txt#start-conversation), you can monitor any measures in any of the Explores that are being used by that data agent. For [dashboard agents](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-data-agents-dashboards.md.txt), you can monitor any measures in any of the query-based tiles on the dashboard. For a Conversational Analytics [conversation with a standalone Explore](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-data.md.txt#start-conversation-single-explore), you can monitor any measures in that Explore.

## Create a triggered workflow

You can create a triggered workflow with an [Explore data agent](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-data.md.txt#start-conversation), [dashboard agents](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-data-agents-dashboards.md.txt), or within a Conversational Analytics [conversation with a standalone Explore](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-data.md.txt#start-conversation-single-explore).

### Before you begin

Before you can use Conversational Analytics to generate a triggered agentic workflow, you must fulfill the following requirements.

#### Required permissions

To prompt Conversational Analytics to generate a workflow, a Looker admin must grant you a role that contains the `create_alerts` permission for the underlying model of the Conversational Analytics data source.

You must also be granted any of the permissions that are required to interact with Conversational Analytics. For more information about Conversational Analytics permissions, see the [Set up Conversational Analytics in Looker](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-setup.md.txt) documentation page.

#### Required authentication

Before you can send workflow notifications to Slack, a Looker admin must enable and configure the Slack action in the [Looker Action Hub](https://docs.cloud.google.com/looker/docs/2614/admin-panel-platform-actions.md.txt) for your Slack workspace. To enable installation of the Looker app, your Slack workspace owner may need to [adjust the app installation settings](https://slack.com/help/articles/222386767-Manage-app-installation-settings-for-your-workspace) for your Slack workspace.

After Slack is enabled, you must authenticate into Slack, either from your [Looker user profile's **Account** page](https://docs.cloud.google.com/looker/docs/2614/scheduling-slack.md.txt#authenticating_into_a_slack_workspace_from_the_account_page) or from within the Conversational Analytics conversation. If your Looker admin has connected multiple Slack workspaces to your Looker instance, you'll see a list of workspaces with options to sign in to each one individually.

## Prompt Conversational Analytics to generate the workflow

To prompt Conversational Analytics to generate a triggered workflow, follow these steps:

1. Ask a question to establish your data's key metrics.
2. Select automation **Workflows** or prompt Conversational Analytics to generate a workflow that looks for changes to one of your data source's [measures](https://docs.cloud.google.com/looker/docs/2614/glossary.md.txt#measure). Use keywords like "alert," "monitor," and "notify." For example:
   - "Create an alert workflow"
   - "Create a workflow to monitor measure X"
   - "Create a workflow to notify me"

Conversational analytics will clarify the remaining components of the workflow until you have established all workflow settings, which include the following:

- **Model**: The underlying model that is being queried.
- **Explore**: The data source for the conversation.
- **Metric**:The measure to be monitored.
- **Condition**: The change that the selected measure must undergo to trigger the workflow notification, including the magnitude or threshold of the change.
- **Destination** : The destination of the workflow notification. Options include email, Slack, and the [Looker mobile app](https://docs.cloud.google.com/looker/docs/2614/mobile-app-alerts.md.txt) (to use the mobile app, a Looker admin must [enable the Firebase action in the Looker Action Hub](https://docs.cloud.google.com/looker/docs/2614/admin-panel-platform-actions.md.txt)).
  - For email destinations, list the email addresses of users whom you want to receive the workflow notification in the **Recipients** field. Although there is no limit to the number of recipients that you can notify, if your organization is using an external SMTP server, the server may have its own daily or per-message recipient limits.
  - For notifications to Slack, if you have not already authenticated into Slack, you must [authenticate](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-agentic-workflows.md.txt#required-authentication) from your user profile. When prompted in the conversation, enter the workspace ID and the user ID or channel ID for where you would like to send your workflow notifications. For notifications to Slack channels, the notification is visible to everyone in the channel.
- **Frequency** : You can set the frequency at which Looker checks your data for changes (and sends a notification if the workflow conditions are met). The default frequency is **Weekly** on Mondays at **09:00**. You can prompt the agent to adjust the frequency as needed. The available frequency options are as follows:

  - **Monthly** on a specified **Day** of the month (the default is the **1st** of the month) at a specified **Time** (the default is **05:00**).
  - **Weekly** on a specified **Day** of the week (the default is **Sun** for Sunday) at a specified **Time** (the default is **05:00**).
  - **Daily** at a specified **Time** (the default is **05:00**).
  - **Hourly** at a specified interval (the default is to check the data every hour) with specified **Start** and **End** times (the default is **05:00** and **18:00** ). With hourly intervals you can have Looker check the data at these intervals:
    - **Hour**
    - **2 hours**
    - **3 hours**
    - **4 hours**
    - **6 hours**
    - **8 hours**
    - **12 hours**
  - **Minutes** at a specified interval (the default is to check the data every 15 minutes) with specified **Start** and **End** times (the default is **05:00** and **17:00** ). With minute-based intervals, you can have Looker check the data at these intervals:
    - **15 minutes**
    - **30 minutes**

  **Start** and **End** times are inclusive. For example, if you set **Check every** to **12 hours** with a **Start** time of **05:00** and an **End** time of **17:00** , Looker will check the data at 05:00 *and* 17:00.

  > [!NOTE]
  > **Note:** Looker sends alerts according to the time zone that is indicated in the [**Application Time Zone**](https://docs.cloud.google.com/looker/docs/2614/using-time-zone-settings.md.txt#application_time_zone) setting on the Admin **Settings** page, or, if enabled, the alert creator's [User Specific Time Zone](https://docs.cloud.google.com/looker/docs/2614/using-time-zone-settings.md.txt#user_specific_time_zones).

- Gemini-powered **Key driver analysis**: If this setting is enabled, the workflow notification provides insight about the change in your data that triggered the workflow, and why that change may have occurred. This option is disabled by default.

## Agentic workflow notifications

Agentic workflow notifications include the following information:

- A PNG image of the workflow visualization.
- A message with the name of the workflow and the conditions that triggered the workflow.
- A link to investigate the workflow --- click this link to open a new conversation with the agent that generated the workflow.
- A link to unsubscribe from the workflow notification.
- If enabled, the insights provided by Gemini-powered **Key driver analysis**.

  > [!NOTE]
  > **Note:** For [single value visualizations](https://docs.cloud.google.com/looker/docs/2614/single-value-options.md.txt), the notification will include the single value as text, rather than a PNG of the visualization.

## Limitations of triggered workflows

The following limitations apply when you use Conversational Analytics to generate a triggered agentic workflow:

- Conversational analytics is not able to generate workflows to monitor the more complex custom metrics that are produced with the use of [Advanced Analytics](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-looker-advanced-analytics.md.txt).
- Conversational analytics is not able to generate workflows to monitor data [dimensions](https://docs.cloud.google.com/looker/docs/2614/glossary.md.txt#dimension) or [table calculations](https://docs.cloud.google.com/looker/docs/2614/glossary.md.txt#table-calc).
- Conversational analytics dashboard agents can't generate workflows for embed users.

## View your triggered workflows

When a Looker admin grants you the `see_alerts` permission, you can view the workflows that you own on the [**Manage Workflows** user page](https://docs.cloud.google.com/looker/docs/2614/user-workflows.md.txt) and all workflows for the Looker instance on the [**Manage Workflows** admin page](https://docs.cloud.google.com/looker/docs/2614/admin-panel-alerts-and-schedules-workflows.md.txt).

## Related resources

- [Conversational analytics overview](https://docs.cloud.google.com/looker/docs/2614/conversational-analytics-overview.md.txt)
- [Manage your agentic workflows](https://docs.cloud.google.com/looker/docs/2614/user-workflows.md.txt)