Skip to main content

Overview

The Playground lets you preview and interact with your AI agent exactly as your end users would, and edit channel-specific settings while you watch the effect. When you open the Playground, it automatically loads the last channel you were working on from the Channels page. For example, if you last viewed the Chat bubble or Help page, the Playground opens that same channel so you can continue testing without switching views.

What you can do:

See your AI agent the way a visitor will, change its style and capabilities in place, and share a live preview with your team before anything goes live.
Use the Playground to:
  • Preview your AI agent’s behavior in real time
  • Test conversations and responses
  • Edit channel-specific settings, such as your AI agent’s style and capabilities, and immediately see how those changes affect the experience
To preview a different channel, click the channel name at the top of the page and pick one from the list, or choose View all channels to go to the Channels page.
The Playground previewing an AI agent in the chat bubble channel

Tabs

The tabs available depend on which channel you are previewing. A web channel such as Chat bubble shows: Other channels expose a different set. Messenger, for example, replaces Voice with Leads, and the Slack channel uses Overview, Connections, Actions, and Extra Settings.

Instructions and global instructions

On the Overview tab, Sync with global instructions controls whether this channel uses your AI agent’s global instructions or its own. Leave it on to keep every channel consistent; turn it off to write instructions that apply only to this channel.

Chat as user

Chat as user starts a Playground conversation as an identified user of your choice, so you can see what a signed-in customer would see and test actions that only run for an identified user. Click Chat as user in the top right, then:
  • User ID: the identifier the conversation runs under. A test ID is generated for you, and the refresh button beside the field generates a new one. Replace it with a real user ID to chat as that user.
  • Metadata: a JSON object of details for that user. Edit the name and email, or add your own fields, then chat to see how your AI agent handles that user. Your AI agent reads these values, and actions receive them as {contact.*} variables.
The Chat as user panel with a User ID and metadata for the test user
Click Chat as user to start the conversation. This is the Playground equivalent of the details your site passes with identity verification, so it’s the fastest way to check how your AI agent greets and handles a known customer.

Preview

Click Preview in the top-right to open your AI agent on a page of its own. The preview opens in a new tab and renders the AI agent on an otherwise empty page, so you can see and use it the way a visitor would instead of inside the Playground’s editing layout. You can share the preview URL with anyone in your workspace, which makes it a convenient way to collect feedback on your AI agent before deploying it. A toolbar at the top of the preview page controls how the page around your AI agent looks:
  • Light and dark: switch the page background between light and dark to check your AI agent’s colors against both.
  • Upload background: upload an image, such as a screenshot of your own website, to sit behind the AI agent. This shows how your AI agent will look in place on your site before you deploy it anywhere.
Everything else behaves as it would once deployed, including initial messages, suggested questions, the floating bubble and its label, and the full conversation.

Deploying

Click Deploy in the top-right to get the code or connection details for the current channel. For the chat bubble, the dropdown offers:
Open Preview, send your AI agent a few questions a real visitor would ask, and confirm the answers and the styling both hold up before you deploy.

Limitations

  • The Playground isn’t a real store or site session. Some actions behave differently there: cart updates don’t work, and payment completion isn’t reported back. Actions that need an identified customer, such as the Stripe actions, run only when you start the conversation with Chat as user. See Shopify Actions and Stripe Actions.

Next steps

Channels

Configure each channel your AI agent runs on, and its display settings.

Build

Edit the instructions, model, and temperature behind every channel.

Actions

Give your AI agent things to do beyond answering questions.

Best Practices

Proven ways to improve the answers you’re seeing in the preview.