Workflows

Test a workflow

Every workflow gets a chat surface at /workflows/{id}/chat. Send sample input, watch the run, inspect each node's span, and iterate without publishing.

What you'll learn
  • How to open the chat-based test view
  • How session history is preserved across messages
  • How to read the execution trace for a workflow run

Open the test chat

  1. 1

    Navigate to the workflow

    From the Multi-Agents list, open your workflow. Click Test, or go directly to /workflows/{id}/chat.
  2. 2

    Pick the version to test

    The version selector at the top lets you test the current draft or any published version. Drafts are sandboxed — they don't affect production triggers.
  3. 3

    Send a message

    Type input as if you were the trigger. For a Webhook trigger, paste sample JSON; for a Chat trigger, type natural language. Submit and watch the run play out.

Inspect the trace

Each response in the chat has an execution trace panel beneath it. Expand it to see every node that ran, in order: LLM calls with token counts, tool invocations with arguments and results, condition evaluations with the chosen branch, approval decisions, and sub-workflow links. Latency and cost are recorded per span.

Session history

The chat session preserves history across messages. Each turn becomes part of the context for the next — useful for testing Chat-triggered workflows that depend on multi-turn conversation. Clear the session from the menu to start fresh.

Frequently asked questions

Do test runs count toward usage and cost?
Yes. Test runs consume LLM tokens and integration calls just like production runs. They show up in Monitor under the same workflow, tagged as test.
Can I replay a production run in the test chat?
Yes. In Monitor, open any run and click Replay in Test. The input is copied into the test chat so you can re-run against a different version of the workflow.
How do I share a failing test with a teammate?
Every test run has a stable URL. Copy it from the address bar — the teammate gets the same chat history, trace, and version selection when they open it.