---
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 scenarios

# Flow troubleshooting scenarios {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Learn how the Flow Troubleshooting Agent addresses common flow execution errors and troubleshooting scenarios you may encounter when designing and running flows.

## Tested troubleshooting scenarios {#flow-troubleshooting-scenarios__scenario_overview}

The Flow Troubleshooting Agent has been validated against a wide range of troubleshooting scenarios. These scenarios represent common flow execution failures that the agent can help diagnose and resolve.

* Approval action troubleshooting
* Trigger troubleshooting
{#flow-troubleshooting-scenarios__ul_w54_mlx_3kc}

## Approval action troubleshooting {#flow-troubleshooting-scenarios__approval_action_scenarios}

Approval actions are a common point of failure in flows. The agent can diagnose and resolve issues related to:

Missing or empty approval recipients

:   The approval action fails because the recipient field is empty or cannot resolve the user reference.

    **How the agent helps:** The agent traces the data flow through previous steps to identify where the recipient field value is being lost or cleared. It checks for business rules or other flows that might be clearing the field and recommends reordering your flow steps or modifying conflicting business rules.

Approval audit trail gaps

:   The approval is created but audit history shows missing or incorrect decision tracking.

    **How the agent helps:** The agent analyzes the approval engine's expected behavior and compares it with your flow's configuration. It identifies missing approval history tracking and recommends enabling the necessary logging or adjusting your approval action settings.

Business rule conflicts with approval engine

:   A business rule is interfering with the approval action's execution or the approval engine's ability to process decisions.

    **How the agent helps:** The agent scans your business rules against the approval engine's expected operations and identifies rules that might be preventing the approval from functioning correctly. It recommends specific changes such as adding flow conditions to business rules or adjusting execution order.

## Trigger troubleshooting {#flow-troubleshooting-scenarios__flow_trigger_scenarios}

Flow triggers control when your flow runs. Trigger-related issues can prevent flows from executing:

Trigger not firing as expected

:   A flow trigger is configured but the flow does not execute when the trigger condition should occur.

    **How the agent helps:** The agent analyzes your trigger configuration and compares it against the actual data changes or events occurring in your system. It identifies mismatches between the trigger condition and real-world events and recommends adjusting trigger logic or investigating data event patterns.

Trigger role or permission issues

:   The flow trigger is not executing because the user or process lacks the necessary permissions to trigger the flow.

    **How the agent helps:** The agent checks your flow trigger's role and permission settings against the users or processes that should trigger the flow. It recommends enabling the necessary roles or adjusting trigger visibility settings.