<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

The **Manage Workflows** admin page is where Looker admins can manage the Conversational Analytics [agentic workflows](https://docs.cloud.google.com/looker/docs/2622/conversational-analytics-triggered-agentic-workflows.md.txt) that were created by any user across the instance. The admin page is accessible from the **Alerts \& Schedules** section of the **Admin** panel. The **Manage Workflows** admin page lists information about all active and inactive workflows.

To view the **Manage Workflows** page, you must be assigned a role that contains the `see_schedules` or `see_alerts` permission and the `chat_with_agent` permission.

> [!NOTE]
> **Note:** If you have a permission that provides access to only select pages in the Admin panel, such as [`manage_schedules`](https://docs.cloud.google.com/looker/docs/2622/admin-panel-users-roles.md.txt#manage_schedules), [`manage_themes`](https://docs.cloud.google.com/looker/docs/2622/admin-panel-users-roles.md.txt#manage_themes), or [`see_admin`](https://docs.cloud.google.com/looker/docs/2622/admin-panel-users-roles.md.txt#see_admin), but you don't have the [Admin role](https://docs.cloud.google.com/looker/docs/2622/admin-panel-users-roles.md.txt#default_roles), the page or pages that are described here may not be visible to you in the Admin panel.

Users can view information about the workflows that they have created, or for which they are listed as a recipient, on the [**Manage Workflows**](https://docs.cloud.google.com/looker/docs/2622/user-workflows) user page, which is available from their user profile menu.

## Workflow information

The **Manage Workflows** admin page provides information about all workflows in the Looker instance. Workflow information is displayed in either the **Workflows** tab or the **Legacy Workflows** tab, depending on when the workflow was created.

### **Workflows**

The **Workflows** tab displays active and disabled agentic workflows created in Looker 26.14 or later.

| Column | Definition |
|---|---|
| Workflow | The title of the workflow, which is set by the agent when the workflow is initiated. The agent generates a default workflow title that's based on the content of the conversation. Click the workflow name to open the [**Details**](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#details-page) page for that workflow. |
| Data Agent | If the data source that is associated with the workflow is a data agent, the name of the agent that created the workflow. |
| Owner | The name of the user who created the workflow. |
| Destination | The destination to which the workflow notification is sent. Options are email or Slack. |
| Frequency | The frequency at which the workflow is run. |
| Options menu | A menu from which you can take additional actions on the workflow. See more in the [Workflow management options](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#manage-workflows) section on this page. |

### **Legacy Workflows**

> [!WARNING]
> **Warning:** The **Legacy Workflows** tab lists workflows that were created earlier than Looker 26.14. Legacy workflows will continue to run for instances that are running Looker 26.14, but will pause when the instance is upgraded to Looker 26.16. Legacy workflows will *not* be automatically migrated. You must recreate them as soon as possible to avoid service interruption.

| Column | Definition |
|---|---|
| Workflow Name | The title of the workflow, which is set by the agent when the workflow is initiated. The agent generates a default workflow title that's based on the content of the conversation. Click the workflow name to open the [**Details**](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#details-page) page for that workflow. |
| Owner | The name of the user who created the workflow. |
| Avg Run Time | The duration of the workflow query in seconds. |
| Condition Met | A **Yes** or **No** that indicates whether the workflow conditions were met when the workflow query was last run. A **--** symbol is displayed if the workflow query has not yet run or if the workflow query ran but it couldn't be determined whether the workflow conditions were met. This column displays warning icons or error icons related to any warnings or errors that surface when the workflow query is run or the workflow notification is delivered. Hold your pointer over the warning or error icon to see the associated error message, if applicable. A warning icon with a stale workflow warning indicates that the data on the dashboard tile did not change between the two most recent workflow queries. Read more about this message in the [Alert error and warning messages](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#workflow-errors-warnings) section on this page. |
| Frequency | The frequency at which the workflow is run to check whether conditions have been met or exceeded. |
| Status | This column indicates whether the workflow is active or disabled. A workflow is marked as **Disabled** when a user disables their own workflow from their user page or when a Looker admin disables the workflow. Disabling the workflow will pause notifications for any workflow recipients. |
| Activity | A link that directs you to the workflow's **Activity** page. |
| Options menu | A menu from which you can take additional actions on the workflow. See more in the [Manage workflows for the Looker instance](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#manage-workflows) section on this page. |

## Manage workflows for the Looker instance

Workflow management may involve the following tasks:

- [Managing its status](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#managing-workflow-status)
- [Viewing its metadata on the **Details** page](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#details-page)
- [Monitoring its activity on the **Activity** page](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#activity-page)
- [Modifying its conditions and thresholds](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#modify-workflows)

Inline with each workflow is an **Options** menu with these selections:

### **Workflows**

- **Edit Workflow**
- **History**
- **Delete**

Click **Edit Workflow** to open and modify the workflow's settings. Click **Save Workflow** to save your changes or **Cancel** to close the editing window without saving.

Click **History** to open the [**Workflow Executions**](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflow-executions.md.txt) page with the history for the selected workflow.

Click **Delete** to delete the workflow. If you choose to delete the workflow, you will be asked to confirm your choice.

### **Legacy Workflows**

- **View Workflow**
- **Edit Workflow**
- **Disable Workflow** (if the workflow is active)
- **Enable Workflow** (if the workflow is disabled)

Click **View Workflow** to open the [**Details**](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt#details-page) page.

Click **Edit Workflow** to open and modify the workflow's settings. Click **Save Workflow** to save your changes or **Cancel** to close the editing window without saving.

### Manage the status of a workflow

Although you cannot permanently delete a workflow, you can control whether the workflow is active. When a workflow's **Status** is **Active** , the workflow query continues to run according to the frequency that's specified in the workflow in order to check whether its conditions have been met. If conditions have been met, workflow recipients are notified with the notification method that's specified in the workflow. When a workflow's **Status** is **Disabled** , no workflow query will run and no notifications will be sent. A disabled workflow's **Details** page shows no results in the workflow visualization.

A workflow owner or Looker admin may need to disable a workflow manually under some circumstances, which may include the following:

- Temporarily pausing workflow notifications in order to re-configure workflow conditions
- Troubleshooting error messages or warnings
- Resolving notification delivery failures

To disable a workflow, follow these steps:

1. On the **Manage Workflows** admin page, find the workflow that needs to be disabled.
2. Select the workflow's **Options** menu.
3. Select **Disable Workflow**.

You can re-enable the workflow at any time by following these steps and selecting **Enable Workflow**.

### View workflow details

The **Details** page shows a summary of workflow settings and configuration. The information that is displayed depends on whether the workflow was created in Looker 26.14 or later (**Workflows** tab) or prior to 26.14 (**Legacy Workflows** tab).

### **Workflows**

When you select **View Workflow** from the **Options** menu or click the workflow name in the **Workflows** tab, you can view and edit the following workflow configuration settings:

- **Data source** : The underlying data source for the workflow, either an **Agent** (data agent) or specific **Explores** (such as `purchases`).
- **Workflow**: The name of the workflow.
- **Trigger** : The schedule or condition that kicks off the workflow:
  - **Repeat** : The execution frequency (such as **Minutes** , **Hourly** , **Daily** , **Weekly** , or **Monthly**).
  - **Day**: The day of the week or month on which the workflow executes.
  - **Time**: The specific time of day at which the workflow runs.
- **Directives**: The step-by-step natural language directives and instructions that the agent executes during each workflow run.
- **Destination** : The delivery options for the workflow execution results. Each execution creates a new conversation visible in Conversational Analytics. Additional delivery options include:
  - **Email**: Delivers the natural language narrative summary, data tables, and PDF reports to specified email recipients.
  - **Slack**: Delivers the narrative summary, data blocks, and PDF reports to designated Slack channels or direct messages.
  - **Recipient list**: Add or remove individual recipient email addresses or Slack destinations.

Click **Save changes** to save any modifications to the workflow configuration.

### **Legacy Workflows**

When you select a workflow in the **Legacy Workflows** tab, the **Details** page displays legacy alert and schedule information:

- Context about what conditions trigger the workflow or what it means for the workflow to be triggered.
- A visualization of the workflow query results.
- The **More** menu on the workflow visualization, which has an option to **Explore from here**. Select this option to open an Explore that is pre-set with the workflow query.
- The **Test Now** button, which runs an instant workflow query.

From the **Manage Workflows** user page, you can view the **Details** page for the workflows that you own or are a recipient for in one of these ways:

1. Select the workflow's **Options** menu, and then select **View Workflow**.
2. Click the workflow name.

On the **Details** page, you can perform the following tasks:

1. Select the text field to add context about the workflow.
2. Select the **More** menu, and then select the **Explore from here** option to open an Explore that is pre-set with the workflow query.
3. Select **Test Now** to run a workflow query instantly, without having to wait for the workflow's specified frequency. If the workflow's conditions are met, a notification will be sent to its owner and any additional recipients.

Click **Done** to close the **Details** page.

### Monitor workflow activity

Accessing a workflow's history provides several key advantages:

- Verify execution and delivery success:
  - Confirm whether scheduled runs or threshold checks occurred on time.
  - View the status of each execution (**Complete** , **Running** , or **Error** / **Failed**).
  - Verify delivery methods and confirm that notifications reached intended destinations (Email or Slack).
- Diagnose and troubleshoot errors:
  - Inspect detailed error messages to resolve issues such as:
  - Missing user permissions (model access).
  - Deleted data agents or inaccessible Explores.
  - Unauthorized external email domains or Slack channels.
  - Intermittent connection timeouts or queue dequeue delays.
- Audit trigger conditions and data freshness:
  - **Condition checks**: See whether threshold conditions were met or exceeded during each evaluation run.
  - **Data freshness** : Identify whether the underlying database data had changed between runs (**Fresh** : **Yes** or **No**), helping prevent or diagnose stale workflow alerts.
- Performance monitoring:
  - Track query runtime duration over time to identify performance degradation, slow-running queries, or database bottlenecks.
- Auditability and compliance:
  - Maintain a clear record of automated report deliveries, recipient lists, and execution logs across your team or Looker instance.

Looker runs a workflow query at its specified frequency. For triggered workflows, it checks whether its conditions have been met. The results of these checks become the workflow's history. For legacy workflows, this history is viewable on the **Activity** page. For workflows, this history is viewable on the [**Workflow Executions**](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflow-executions.md.txt) page in the admin panel.

### **Workflows**

You can access the **Workflow Executions** page from the **Manage Workflows** admin page by selecting the **History** option from the **Options** menu.

### **Legacy Workflows**

For legacy workflows, the table on the **Activity** page includes the following information about each workflow query job:

<br />

| Heading | Definition | Possible values |
|---|---|---|
| **Ran At** | The timestamp of when the workflow query was initiated | Any timestamp in the format `DD/MM HH:MM` <br /> Example: `05/30 18:25` |
| **Run Time** | How long the workflow query took to run | Any duration in the format `0.81s` |
| **Fresh** | A Boolean that indicates whether the workflow query checked data that had changed between the two most recent workflow queries | - `Yes` (if data changed) - `No` (if data did not change) |
| **Source** | The origin of the data from which the workflow query checked for the threshold value that was indicated in the workflow conditions | - `query` - `cache` - `stale cache` - If `query`, `cache`, or `stale cache` don't apply, the **Source** value will be blank. |
| **Source Time** | The timestamp of the database row from which the workflow query checked for the threshold value | Any timestamp in the format `DD/MM HH:MM` <br /> Example: `05/25 16:01` |
| **Condition Met** | A Boolean that indicates whether or not the workflow conditions were met | - `Yes` (conditions were met) - `No` (conditions were not met) |
| **Trigger** | The threshold value that would trigger the workflow if met or exceeded | Any numerical value |
| **Observed** | The observed value that met or exceeded the workflow conditions and triggered the workflow | Any numerical value |
| **Status** | The status of the workflow query | - `Complete` - `Running` - `Not Started` |

<br />

On the **Activity** page, you can perform the following tasks:

1. View the frequency with which the workflow query checks its conditions.
2. View the workflow history.
3. Use the **Test Now** button to run an instant workflow query --- if the workflow is triggered, a notification will be sent to its owner and any additional recipients.

Click **Done** to close the **Activity** page.

### Workflow error and warning messages

The **Manage Workflows** user page displays any errors or warnings that are surfaced when the workflow is run or the workflow notification is delivered. Error messages, if applicable, appear when you hold your pointer over the warning icon or error icon in the **Condition Met** column.

![](https://docs.cloud.google.com/static/looker/docs/images/enhanced-alerts-warnings-2114.png)

#### Notification delivery failed with existing configuration

For workflows that are set up to [deliver notifications](https://docs.cloud.google.com/looker/docs/2622/conversational-analytics-triggered-agentic-workflows.md.txt#method) to Slack or the Looker mobile app, the error message `Notification delivery failed with existing configuration` appears when the workflow determines that the workflow conditions have been met but the notification couldn't be delivered. This failure may occur if something about the Slack configuration has changed since the workflow was created --- for example, if the Slack workspace that the workflow was delivering to was disconnected from the Looker instance, if the Slack channel that the workflow was delivering to was deleted, or if Looker cannot connect to the integrations.

#### Warning: Querying fresh data

A warning icon in the **Condition Met** column indicates that the data upon which the workflow is based did not change between the two most recent workflow queries. Holding your pointer over this icon displays the message **Stale Alert Warning**.

There are a few possible explanations for why the data did not change between queries. If this warning persists, talk to your Looker developer to verify that the [caching policies](https://docs.cloud.google.com/looker/docs/2622/reference/param-model-datagroup) that are defined for the agent's Explores are aligned with the [workflow frequency setting](https://docs.cloud.google.com/looker/docs/2622/conversational-analytics-triggered-agentic-workflows.md.txt#prompt-generate-workflow).

## Modify workflow conditions

A workflow owner or Looker admin may need to modify the workflow configuration manually under some circumstances, which may include the following:

- Enabling or disabling **Gemini powered key driver analysis**, which appears in the notification
- Adjusting the metric thresholds and conditions that trigger the workflow as organization needs evolve
- Updating notification destinations
- Updating the workflow frequency to align better with caching policies

To modify the settings of a workflow, following these steps:

1. From the **Manage Workflows** user page, select the **Options** menu for the workflow that you want to modify.
2. Select **Edit Workflow**, which opens the workflow editing dialog.
3. Make your changes to the workflow's settings.
4. For legacy workflows, select **Save Alert** to save your changes. For workflows, select **Save changes** to save your changes.

## Effect of deleting agents, conversations, Explores, or dashboards on workflows

Deleting a data agent or a conversation affects the associated workflow in the following ways:

- If a user deletes the *conversation* with the agent that generates the workflow, that workflow remains active. Any workflow notification recipients will continue to receive notifications when the workflow conditions are met.
- If a user deletes the *agent* that generates the workflow, that workflow remains active. Any workflow notification recipients will continue to receive notifications when the workflow conditions are met.
- If a user deletes the Explore or dashboard that contains the data that the workflow is monitoring, that workflow remains active. Any workflow notification recipients will continue to receive notifications when the workflow conditions are met.

## Related resources

- [Conversational analytics overview](https://docs.cloud.google.com/looker/docs/2622/conversational-analytics-overview.md.txt)
- [Admin settings - Workflows](https://docs.cloud.google.com/looker/docs/2622/admin-panel-alerts-and-schedules-workflows.md.txt)
- [Create a triggered agentic workflow](https://docs.cloud.google.com/looker/docs/2622/conversational-analytics-triggered-agentic-workflows.md.txt)
- [Create a scheduled agentic workflow](https://docs.cloud.google.com/looker/docs/2622/conversational-analytics-scheduled-agentic-workflows.md.txt)