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

# Test Your Agent

> A slide-in widget preview on every Manage Agent page. Test the agent against your real appearance, prompt, knowledge base, and integrations before customers do, without leaving the page you're working on.

<Note>
  The **Test Your Agent** button lives on the end edge of the topbar on every Manage Agent page (Overview, Conversations, Leads, Settings, Campaigns). Click to slide in a real-time preview from the end edge of the screen. RTL flips the slide direction so it always feels native.
</Note>

## How to open it

Three ways:

1. Click the **Test Your Agent** button in the topbar.
2. From the **Agent Settings** editor, click the **Agent Preview** button on smaller screens (where the inline preview aside isn't visible).
3. Press the keyboard shortcut (planned, not shipped yet).

The button label changes to **Close Test Widget** when the sheet is open. Click again to dismiss, or click outside the sheet, or press **Escape**.

## What you see

The slide-in is a wide sheet (wider on desktop, full-width on mobile) holding the same agent preview surface used by the wizard. Inside, you'll see your agent's widget rendered exactly as your customers see it:

* **Launcher icon** in the bottom corner of the preview area
* **Floating chat panel** above it with header, conversation area, footer
* **Header** with your branding (avatar / name / tagline)
* **Powered by** line in the footer
* **Disclaimer** if you wrote one in [Appearance](/en/Systems/AI-Agents/Wizard/Appearance)
* **Rating UI** at the end of the conversation if Reviews are enabled
* **Voice call button** (voice + hybrid agents only)

You can:

* **Type in the chat input** and get real responses from your agent
* **Click the call button** (voice + hybrid) to start a real test call against your voice config
* **Switch language** if you have multiple languages enabled

## Why a sheet, not the production widget

The production Wittify chat widget mounted globally on every page of the Wittify dashboard is the **Wittify marketing widget**, "Chat with Sarah from Wittify". It will always answer as Sarah and follow Wittify's prompt, not yours.

The **Test Your Agent** sheet uses your agent's actual config (appearance, voice, prompt, knowledge base, integrations). That's the only correct preview of what your customers will experience.

## What it tests against

The preview goes through the real production agent stack:

* **Appearance**: your saved colors, logo, avatar, launcher, position, font, languages, banners, ratings.
* **Knowledge Base**: every file, FAQ, and URL the agent has been trained on. Trained items only, pending items don't reach answers.
* **Tickets & Leads**: the lead form mounts inside the conversation if data collection is on, and submitting it creates a real record in [Leads & Tickets](/en/Systems/AI-Agents/Manage-Agent/Leads-and-Tickets).
* **Integrations**: the agent calls real tools when needed (Human Handoff, Calendar Booking, Order Tracking, Payment Collection). Webhooks fire if enabled.
* **The actual model + prompt**: every response goes through the real model with your real system prompt and temperature.

## Important: this is not a sandbox

Records created during a test are real records:

* A lead form submission becomes a real lead in your inbox.
* A handoff fires the real notification (email / Slack / Webhook).
* A webhook event hits your real server.
* A ticket goes to your real CRM.

Test carefully. Some teams keep a **dedicated test agent** (a clone of the production agent that they only use for testing), so test traffic doesn't pollute the real inbox or fire real notifications.

## Mobile behavior

On mobile the sheet slides in full-width, taking the entire screen. RTL languages flip the slide direction so it feels native (Arabic users see it slide from the start edge instead of the end edge).

The topbar **Test Your Agent** button shrinks to an icon-only button on small screens, with a tooltip showing the full label.

## Widget language

The widget inside the sheet uses your agent's **default language** as set in [Appearance](/en/Systems/AI-Agents/Wizard/Appearance), regardless of which language the dashboard is in. So you can be in Arabic mode but test an English-default agent, the widget will still default to English.

If your agent has multiple languages enabled, the language switcher at the top of the widget lets you toggle through them in the test sheet too.

## Common questions

<AccordionGroup>
  <Accordion title="My agent says 'I'm Sarah from Wittify' in the test sheet.">
    You're not in the Test Your Agent sheet, you're talking to the global Wittify marketing widget. Look for the **Test Your Agent** button in the topbar (end edge), not the floating launcher in the bottom corner. Two different widgets, only the topbar one is yours.
  </Accordion>

  <Accordion title="The test conversation doesn't appear in Chat Conversations.">
    It does. Test conversations and real conversations share the same inbox. Filter by your own browser session or the timestamp to find your test threads.
  </Accordion>

  <Accordion title="A test lead I submitted shows up in production. Can I delete it?">
    Yes. Open [Leads & Tickets](/en/Systems/AI-Agents/Manage-Agent/Leads-and-Tickets), tick the test record, click bulk **Delete**. Or use the detail sheet's **Delete** action. Soft-deleted records stay 30 days in the **Deleted** sub-tab.
  </Accordion>

  <Accordion title="The voice call button doesn't work in the test sheet.">
    Two checks: (1) your browser has microphone permission for `app.wittify.ai`, (2) the agent has a voice configured in [Voice Settings](/en/Systems/AI-Agents/Wizard/Voice-Settings). Voice calls require both.
  </Accordion>

  <Accordion title="Can I test against an older version of the agent?">
    No. The test always uses the latest saved configuration. There's no version history rollback yet.
  </Accordion>
</AccordionGroup>

## Next

<CardGroup cols={2}>
  <Card title="Agent Settings" icon="gear" href="/en/Systems/AI-Agents/Manage-Agent/Agent-Settings">
    Edit any wizard section and re-test.
  </Card>

  <Card title="Delete Agent" icon="trash" href="/en/Systems/AI-Agents/Manage-Agent/Delete-Agent">
    For when the agent is no longer needed.
  </Card>
</CardGroup>