Skip to content

Graph designer

The graph designer is for scenarios where every turn is scripted and the conversation flow is deterministic — IVR navigation, fixed verification sequences, scripted demos. If your scenario is open-ended, use free-flow instead.

Graph scenario designer

Node types

NodePurpose
StartImplicit entry point. Each scenario has exactly one.
StepOne turn — caller speaks, target speaks, or both. Specifies what each side says or what the caller is expected to hear.
BranchConditional fork. Two flavors: ifElse (rule-based) and waitForResponse (split based on what the target says).
ServiceA mocked HTTP call — used to simulate downstream services in flows where your agent calls into something we’re standing in for.
EndTerminates the path. A scenario can have multiple ends — different outcomes.

Authoring flow

  1. Drag node types from the left palette onto the canvas.
  2. Connect them by dragging from a node’s edge handle to another node.
  3. Click any node to open its inspector and fill in the content (what’s said, branch conditions, service request/response, etc.).
  4. Click Auto layout to clean up the canvas — uses dagre to top-to-bottom or left-to-right.

How paths get generated

Each unique branch combination becomes a test path. A graph with two binary branches produces four paths automatically.

For service nodes, the platform varies the response across paths to cover failure modes — your agent gets the success response on some paths and the failure response on others.

Step nodes — speaker types

Each step belongs to one speaker:

  • Target agent — what your agent says. The platform listens for this; the caller’s reply is what comes next.
  • AssureAgent (caller) — what the simulated caller says. The exact text or a phrasing prompt.

When to switch to free-flow

If you find yourself:

  • Adding many waitForResponse branches because real customers reply many ways.
  • Writing the same turn three times for slight phrasing variations.
  • Wishing you could just describe the persona in English.

…then switch to free-flow. The graph designer’s strength is determinism; once you’re trying to cover variability, free-flow is the right tool.

Where to find it

Open any scenario with scenarioDesignStyle: graph from the Scenarios page. Free-flow scenarios open in a different designer.