Set and Use Breakpoints

Breakpoints pause the workflow at specific nodes so you can inspect the node's state before continuing. They are useful because they let you stop the workflow before it moves too far downstream. This makes it easier to isolate the exact state at a decision point.

Set a Breakpoint

Here are the steps to set a breakpoint in the workflow.

Go to AI Agent Studio and open the Workflows tab.
Select Edit to modify a workflow.
From the toolbar, select Debug .
Enter a prompt in Ask Oracle and submit it to run the workflow.
Locate the node where you want the run to pause.
Hover near the breakpoint control on the node and select it to activate the breakpoint. Confirm that the breakpoint indicator turns red , indicating active breakpoint state.

We recommend setting breakpoints immediately before nodes that are expensive, error-prone, or important for data handoff. For example:

Before a function, service, or tool call
Before a RAG Document Tool node
Before a final summary node
After an intent-extraction node
Before a node that recently changed

Run to a Breakpoint

Go to AI Agent Studio and open the Workflows tab.
Select Edit to modify a workflow.
From the toolbar, select Debug .
Enter a prompt in Ask Oracle and submit it to run the workflow. The workflow runs and when the run reaches the breakpoint, the workflow pauses.
Read the chat or debug status message to confirm the stopped node.
Select the paused node and inspect the results from the Results tab.

Breakpoints are useful because they let you stop the workflow before it moves too far downstream. This makes it easier to isolate the exact state at a decision point.

Remove a Breakpoint

Select the active breakpoint control to disable it. Remove any temporary breakpoints before final validation so the workflow can run end-to-end.