Skip to main content

Test Suites

A test suite is a collection of test cases that validate your Blueprint against different scenarios. Instead of manually running your Blueprint with one set of inputs at a time, test suites let you define multiple scenarios and run them all at once.

Opening the Tests panel

Click the Tests button in the right sidebar of the editor to open the Tests panel. The Tests panel showing "No Test Suites" with Create Empty and Auto-Generate buttons

Creating a test suite

You have two options:

Auto-Generate with AI

Click Auto-Generate to let AI analyze your Blueprint and create a comprehensive test suite automatically. The AI examines your logic — decision branches, boundary conditions, error paths — and generates test cases that cover each scenario. For example, for a Delivery Fee Calculation Blueprint, the AI might generate tests like:
  • Error on negative cart value — validates error handling
  • Free delivery threshold — tests the boundary at cartValue = 50
  • Weekend surcharge applied — tests the weekend pricing path
  • Premium member discount — tests the discount calculation
  • High distance fee — tests large distance values
  • Fee rounding — tests decimal precision
This is the fastest way to get thorough test coverage. The AI typically generates 8–12 test cases that exercise all major paths through your Blueprint.

Create Empty

Click Create Empty to start with a blank test suite, then add test cases manually using the Add Test button. This is useful when you want to test very specific scenarios or edge cases.

Running tests

Run all tests

Click Run All to execute every test case in the suite. The results appear immediately: Test suite results showing 9 passed and 1 failed test with a 90% pass rate The summary bar shows:
  • Total tests — how many test cases are in the suite
  • Passed — tests where the actual output matched the expected output
  • Failed — tests where the output didn’t match
  • Pass rate — the percentage as a progress bar (e.g., 90%)

Run individual tests

Each test case has its own Run button, so you can re-run a single test without running the entire suite.

Understanding test results

Each test case shows one of three statuses:
StatusMeaning
Passed (green)The actual output matched the expected output
Failed (red)The actual output differed from the expected output
Not Run (gray)The test hasn’t been executed yet

Investigating failures

When a test fails, it expands to show the Output Mismatch — a table comparing the expected and actual values for each output field that differs. For example, a “Fee rounding” test might show:
FieldExpectedActual
deliveryFee4.995
This tells you exactly which output value was wrong and by how much, helping you pinpoint the issue in your logic. You can also click Run on a failed test to execute it individually, then use the Replay feature to step through the execution and understand where the logic diverged from your expectations.

Managing test suites

Adding tests

Click Add Test in the test suite header to add a new test case manually. You define the input values and the expected output values.

Adding tests with AI

Click the AI button next to “Add Test” to let AI suggest additional test cases based on your Blueprint’s logic. This is useful for improving coverage after you’ve already created a suite.

Filtering tests

Use the Filter dropdown to show only specific test statuses:
  • All — shows every test
  • Passed — shows only passing tests
  • Failed — shows only failing tests
  • Not Run — shows tests that haven’t been executed

What to do next