The Sandbox is an embedded chat panel inside the Flow Designer that lets you test conversation flows in real time. Use it to verify skill scripts, check event handling, and confirm persona behavior before deploying to production.
Open the Sandbox
Open a flow in the Flow Designer.
In the header bar, click Sandbox: Off.
The button text changes to Sandbox: On and the chat panel slides in from the right side of the screen.
To close the Sandbox, click Sandbox: On again.
Configure Agent Control
Before testing, select the agent persona the AI Employee will use during the conversation.
In the Sandbox panel, locate the Agent row.
Click Link persona to open the persona selector.
Search for and select a persona from the dropdown. Only personas linked to agents are shown.
Click Save.
The selected persona name appears next to the Agent label.
🗒️ NOTE
Changing the agent persona clears the previously selected agent actor.
Configure User Control
The User Control section defines who the simulated user is during testing.
Select a user persona
In the Sandbox panel, locate the User row.
Click Select persona and choose an existing persona.
Click Save.
Create a new user persona
Click the + icon next to the User row.
Enter a Name for the persona.
Optionally enable Create actor (enabled by default) to create an actor at the same time.
If creating an actor, fill in the Integration, Connector, and External Id fields. Click the refresh icon next to External Id to auto-generate a random value.
Click Create and apply.
Select a user actor
After selecting a user persona, the Actor row becomes active.
Click Select actor and choose an existing actor from the list.
Click Save.
Create a new user actor
Click the + icon next to the Actor row.
Select an Integration and Connector.
Enter or auto-generate an External Id.
Click Create and apply.
❗❗ IMPORTANT
You must select a user actor before sending messages. If no actor is selected, the message input displays: "To start conversation, please select a user's actor."
Warnings
The Sandbox checks for unsaved and unpublished changes when you open it.
Unsaved changes: If you have modified skill scripts that have not been saved, a yellow notification appears: "You have unsaved scripts. Please save them before you can test the flow."
Unpublished changes: If the flow has been saved but not published since the last change, a yellow notification appears: "You have unpublished changes. Please save and publish them before you can test the flow."
Testing workflow
Follow this sequence to test a flow:
Open Sandbox — Click Sandbox: Off to open the chat panel.
Configure personas — Select or create agent and user personas with actors.
Send a message — Type in the message input and press Enter to send.
Review the conversation in the chat panel. To start a fresh conversation, click the Refresh Chat button.