---
sourceDocument: Brazil Build workflows
sourceDocumentLink: https://www.servicenow.com/docs/r/build-workflows

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Build workflows

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# Flow troubleshooting agent

# Flow troubleshooting agent {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Flow troubleshooting agent

The Flow Troubleshooting Agent in ServiceNow enables you to quickly diagnose and resolve errors in flow executions directly from a conversation interface.
It simplifies the complex task of identifying root causes behind flow failures or unexpected behavior by analyzing flow steps, data, and potential conflicts with business logic or system configurations.
This intelligent agent offers targeted, evidence-based recommendations to help you resume your flow efficiently.
Show full answer Show less  

## Key Features

* **Flow step summarization:** Provides clear summaries of each flow step's purpose, inputs, outputs, and role within the overall flow.
* **Data analysis and tracing:** Reviews data transformations, field mappings, and value changes to detect errors such as missing or invalid data.
* **Conflict detection:** Identifies conflicts with business rules, workflows, security settings, and integrations that may cause flow failures.
* **Evidence-based recommendations:** Offers actionable suggestions with supporting data and reasoning to resolve errors and resume flows.
* **Conversational interface:** Allows natural language interaction to ask follow-up questions, explore specific flow steps, and investigate alternative solutions without leaving the agent interface.
* **Knowledge Base (KB) article recommendations:** Provides relevant support articles to assist with diagnosis and troubleshooting.

## When to Use

Utilize the Flow Troubleshooting Agent when you encounter flow execution failures, need to analyze flow data for root cause diagnosis, suspect conflicts with other business logic or integrations, or prefer conversational debugging over manual log inspection.

## How to Access

* Enable the system property `com.glide.hub.flow.launchtroubleshootingagent` (requires administrator action).
* Launch the agent from flow execution details via the Troubleshoot button.
* Access through the ServiceNow Otto conversational AI assistant button on related records or any screen.

## Prerequisites

* System property `com.glide.hub.flow.launchtroubleshootingagent` set to true.
* Roles required: `sntroubleshoot.flowtroubleshootingagentuser` to run the agent, plus `flowdesigner` or `flowadmin` to view flow execution details.
* ServiceNow Otto panel enabled in your instance.
* Webcrawler external content connector plugin activated for KB article search.
* KB Troubleshooting Agent scheduled script running to gather support articles.  
Diagnose and resolve flow errors from a conversation. Resume a flow the point of error, analyze flow steps, identify conflicts with business logic, and receive targeted recommendations to troubleshoot your flows.

When a flow fails or produces unexpected results, troubleshooting the root cause can be time-consuming and require deep knowledge. You can use the flow troubleshooting agent to shorten this process to review a flow directly from a
conversation.

This intelligent agent analyzes flow execution data, identifies potential conflicts with business rules or other workflows, and recommends specific actions to resolve errors.

## Benefits {#flow-troubleshooting-agent__benefits}

* **Summarize flow steps:** Understand the purpose and sequence of steps in your failed flow.
* **Analyze data in motion:** Review the data used and generated by each flow step to identify transformation errors or missing data.
* **Identify conflicts:** Detect potential conflicts with other business logic, workflows, or system configurations that may be causing failures.
* **Receive actionable recommendations:** Get specific, evidence-based actions you can take to resolve the error and resume your flow.
* **Review evidence and reasoning:** View the analysis and recommendations with supporting data and evidence so you understand the reasoning behind each suggestion.
{#flow-troubleshooting-agent__benefits_list}

## Capabilities {#flow-troubleshooting-agent__agent_capabilities}

The Flow Troubleshooting Agent provides the following capabilities to help you diagnose and resolve flow execution errors:
{#flow-troubleshooting-agent__table_ujf_rmx_3kc__entry__2}

| Capability | Description |
|-|-|
| Flow step summarization | The agent analyzes your flow and provides a clear summary of each step's purpose, inputs, outputs, and role in the overall flow logic. |
| Data analysis and tracing | The agent reviews the data used and generated by your flow, including data transformations, field mappings, and value changes across steps. Identifies data validation errors, missing values, or type mismatches. |
| Conflict detection | The agent scans for and identifies potential conflicts with other business logic, workflows, business rules, field-level security, and integration configurations that may be causing your flow to fail. |
| Evidence-based recommendations | The agent provides specific, actionable recommendations to resolve your flow error, with supporting evidence and reasoning for each suggestion. |
| Conversational interface | The agent provides a conversation interface for you to interact with it naturally through conversation. Ask follow-up questions, dive deeper into specific steps, or explore alternative solutions without leaving the troubleshooting interface. |
| KB article recommendations | The agent provides links to support KB articles to help you diagnosis and troubleshoot instance issues. |
[ ]

{#flow-troubleshooting-agent__table_ujf_rmx_3kc}

## When to Use {#flow-troubleshooting-agent__when_to_use}

Use the Flow Troubleshooting Agent when:

* A flow execution fails and you want to understand why.
* You want to analyze flow data to diagnose root causes.
* You suspect a conflict between your flow and other business rules or integrations.
* You need conversational debugging help without digging through logs manually.

{#flow-troubleshooting-agent__ul_e2d_hqw_3kc}

For a list of verified scenarios where you can use the Flow Troubleshooting Agent, see [Flow troubleshooting scenarios](https://www.servicenow.com/docs/HJ55WZO0ycNRkK2A~b_Q0w "Learn how the Flow Troubleshooting Agent addresses common flow execution errors and troubleshooting scenarios you may encounter when designing and running flows.").

## How to Access the Flow Troubleshooting Agent {#flow-troubleshooting-agent__access_points}

For the Brazil release, an administrator must create a system property called com.glide.hub.flow.launch_troubleshooting_agent. For more information about creating the system property, see [Create troubleshooting agent system property](https://www.servicenow.com/docs/09iqj7UJqsBmf~71juDJXA "Create a system property to enable access to the Flow Troubleshooting Agent.").

You can launch the Flow Troubleshooting Agent from multiple locations in ServiceNow:

* From the flow execution details view, select the Troubleshoot button.
* From a related record, select the ServiceNow Otto button (the conversational AI assistant) to access the agent.
* From any screen, select the ServiceNow Otto button (the conversational AI assistant) to access the agent.
{#flow-troubleshooting-agent__ul_f2d_hqw_3kc}

## Prerequisites {#flow-troubleshooting-agent__prerequisites}

To use the Flow Troubleshooting Agent, you must have:

* The com.glide.hub.flow.launch_troubleshooting_agent system property set to true.
* The sn_troubleshoot.flow_troubleshooting_agent_user role to run the Flow Troubleshooting Agent.
* The flow_designer or flow_admin role to access flow execution details
* The ServiceNow Otto panel enabled in your instance. For setup instructions, see [Overview tab in AI Admin Hub](https://www.servicenow.com/docs/access?context=configuring-now-assist&version=brazil&pubname=brazil-intelligent-experiences&ft:locale=en-US).
* The Webcrawler external content connector \[com.sn_ext_conn_wc\] plugin to enable searching for support KB articles. For more information, see [Webcrawler external content connector](https://www.servicenow.com/docs/access?context=webcrawler-external-content-connector&version=brazil&pubname=brazil-platform-administration&ft:locale=en-US).
* The KB Troubleshooting Agent: ServiceNow Support Crawl scheduled script execution to gather support KB articles.
{#flow-troubleshooting-agent__ul_g2d_hqw_3kc}