# Preview

> Try your agent from the dashboard before it goes live: knowledge answers, operations, and why a token fails.

Source: https://sideagent.dev/docs/preview

Every agent page has a preview. It opens the same chat your users get, docked beside the page, and talks to your saved settings. You can use it before the agent goes live.

## What it does

- **Knowledge.** The Sources card lists the passages the agent found, with their scores. A passage under the relevance floor still shows up, so you can see why an answer came back as "off topic". Edit a source, re-index, and ask again.
- **Operations.** Give the preview a test token and an agent with allowed operations can call your API. Reads call your API. Writes ask for approval as usual, but after you approve nothing is sent: the card says so, and the agent is told. The preview never changes data in your API.
- **Tokens.** For agents that verify sign-in tokens (JWKS or userinfo), paste a token from your own app and choose **Check token**. If it fails, the preview says why: not a valid token, rejected (issuer, audience, expiry or signing key), or the key or userinfo URL did not answer. Your users only ever see a plain 401. The token stays in the browser tab. It is not saved.
- **Settings.** The preview tests the **saved** settings and shows which version. Unsaved edits are not included. A new version starts a new chat.

## Good to know

- Preview chats are kept apart from your users' chats and are removed with **Clear preview chats** or when you delete the agent.
- Preview messages count against the built-in model's monthly limit. With your own model key they do not.
- Without a token, an agent that verifies tokens answers from its knowledge only and cannot call your API.
- Preview traffic is recorded in the audit log as `preview.*` events, so it does not mix with your real traffic.