> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upsolve.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Playground

> Chat with your workspace's agent on any version, as yourself or as one of your project users, and see exactly how it reached each answer.

The **Playground** is where you try your agent the way your users will meet it, with the tools to see how it works. Open it from **Test & Ship → Playground** in the workspace sidebar.

It is the same chat your users get in the embed, with three things added for builders:

* **Any version.** Chat with the draft you're editing, the version your users are served, or any saved version.
* **Any user.** Chat as yourself, or as one of your project users with their row-level security applied.
* **Observability.** Open the trace of every answer: the context the agent read, the tools it called and the SQL it ran.

![The Playground with a chat answer on the left and the Observability panel open on the right, showing the answer's trace](https://mintcdn.com/upsolve/Nurc8hPkBODmwDS1/images/ai-agent-builder/workspaces/playground.png?fit=max\&auto=format\&n=Nurc8hPkBODmwDS1\&q=85\&s=c76e65e73739630ce923b087bb4c406f)

> [!NOTE]
>
> **Home** in User mode is the same chat, always as yourself on the version your environment serves. To change version, impersonate a user or open Observability, Home offers **Go to the Playground**, which opens the Playground on the version Home was showing.

## Choose a version

The version bar at the top of the workspace sets which version the Playground answers with. Unlike the other workspace pages, the Playground opens on **the version your users are served**, so what you see is what they get.

Pick **Draft** to try changes you haven't saved yet. The first time you chat with the draft as a given user, the Playground asks you to **Prepare Agent**: it readies the draft's data for that user. It does this once per user, and again after you change the draft's schema. If the draft changes after that, an **Update draft agent** strip appears. Prompts, skills and the knowledge base are always current without it; only filter values can fall behind.

Pick a saved version to check how an older or newer version answers before you promote it.

## Choose who you chat as

Use **Chatting as** to pick who the agent answers as:

* **Yourself** (the default). The header shows a green **Live** badge while you chat as yourself on the version your users are served.
* **One of your project users.** The agent answers under that user's [row-level security](https://docs.upsolve.ai/ai-agent-builder/data-governance.md), exactly as it would in their embedded chat, so you can check what each customer can and can't see. A **Scratchpad** strip reminds you whose access you're previewing. **Chat as yourself** switches back.

While you preview someone else's access, Canvas, Favorites and Connections are turned off, so nothing is saved to that user's account.

## See how an answer was made

Turn on **Observability** in the header to open a panel beside the chat. It has two tabs:

* **Context**: the data model, knowledge base and skills this version carries.
* **Trace**: every step of the answer, including the tools the agent called and the SQL it ran.

Answers that used tools also have an **Observability →** link that opens their trace directly. See [Agent Observability](https://docs.upsolve.ai/ai-agent-builder/agent-observability.md) for how to read a trace.

## Turn a good answer into a test

When the agent gets a question right, keep it right. Click **Save as test case** in the answer's trace (or the ★ on a tool result) to open the test-case editor with the question, the SQL and any chart filled in. See [Tests](https://docs.upsolve.ai/ai-agent-builder/tests.md).

## What is recorded

Every Playground conversation appears in [Chat History](https://docs.upsolve.ai/ai-agent-builder/chat-history.md) with the platform **Playground**, along with the version that answered.

* **Chatting as yourself:** the conversation is yours, and it appears in your own chat list. You can rate answers, save charts to Favorites and build canvases, as your users can.
* **Chatting as a project user:** the conversation is recorded as a builder's chat on the workspace's Chat History page. It never appears in that user's own history.

## Who can use it

Owners, admins and members can use everything above. Read-only members can open the Playground and Home in User mode, and nothing else in the workspace.

## Next steps

> [card] [Tests](https://docs.upsolve.ai/ai-agent-builder/tests.md)
>
> Turn the questions you check by hand into tests that run on every change.

> [card] [Agent Observability](https://docs.upsolve.ai/ai-agent-builder/agent-observability.md)
>
> Read a trace step by step.

> [card] [Builder Agent](https://docs.upsolve.ai/ai-agent-builder/builder-agent.md)
>
> Fix what the Playground shows you by describing the change.

> [card] [Data Governance](https://docs.upsolve.ai/ai-agent-builder/data-governance.md)
>
> Control what each project user can see.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.