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

# Simulator

> Simulate conversations and validate configuration

The [Simulator](https://platform.typewise.app/simulator) allows you to test AI
chat or email interactions. It has two tabs: the **Playground** for ad-hoc
manual conversations, and **[Tests](/documentation/testing-and-feedback/tests)**
for automated test scenarios with assertions and AI evaluation.

You can also use the simulator to test changes to your AI Agent's behavior,
knowledge, and actions before [publishing](/documentation/behavior/publishing)
them.

## How to Start a New Conversation

Click **+ New Conversation**.

You will see a pop-up window with two channel options:

* **Chat**
* **Email**

### Chat Channel

<Steps>
  <Step title="Select Chat">Select Chat as your channel.</Step>

  <Step title="Enter email (optional)">
    Optionally, enter an email address if you want to link the chat to a
    specific user.
  </Step>

  <Step title="Include unpublished changes">
    Toggle the **Include unpublished changes** option to either test your
    changes before publishing them or test the live configuration.
  </Step>

  <Step title="Start">
    Click Start. You'll be redirected to the Playground, where you can test
    real-time interactions between the AI and a user.
  </Step>
</Steps>

<img src="https://mintcdn.com/typewise/iV17UDr0QCrGSr8T/images/documentation/testing-and-feedback/simulator/simulator-create-chat.png?fit=max&auto=format&n=iV17UDr0QCrGSr8T&q=85&s=1b3a052cf027fd65ae47b6498100ec20" alt="Chat Simulator Setup" width="1386" height="1354" data-path="images/documentation/testing-and-feedback/simulator/simulator-create-chat.png" />

### Email Channel

<Steps>
  <Step title="Select Email">Select Email as your channel.</Step>
  <Step title="Enter recipient">Enter the recipient's email address.</Step>
  <Step title="Add subject">Provide a Subject line.</Step>
  <Step title="Add CC (optional)">Optionally, add CC Address.</Step>

  <Step title="Include unpublished changes">
    Toggle the **Include unpublished changes** option to either test your
    changes before publishing them or test the live configuration.
  </Step>

  <Step title="Start">
    Click Start. You'll be redirected to the Playground, where you can send
    and receive simulated email exchanges.
  </Step>
</Steps>

<Tip>
  This feature is ideal for validating Specialist behavior and fine-tuning
  instructions before going live.
</Tip>

<img src="https://mintcdn.com/typewise/iV17UDr0QCrGSr8T/images/documentation/testing-and-feedback/simulator/simulator-create-email.png?fit=max&auto=format&n=iV17UDr0QCrGSr8T&q=85&s=4f3c9379f69ec5a6f31541e9da92517c" alt="Email Simulator Setup" width="906" height="1233" data-path="images/documentation/testing-and-feedback/simulator/simulator-create-email.png" />

### Playground Interface

Once inside the Playground, you can:

* Send test messages as a user or agent.
* Observe how the Specialist responds to inputs.
* Test handoff conditions, response logic, and conversation flow.

<Info>
  Tickets created via the simulator will not be shown inside your inbox.
</Info>

## See also

* [Automated Tests](/documentation/testing-and-feedback/tests): Create automated
  test scenarios with assertions and evaluation
* [Specialists](/documentation/behavior/specialists): Create topic-specific AI
  behavior
* [Knowledge](/documentation/knowledge/overview): Add knowledge sources for the
  AI
* [Actions](/documentation/actions/overview): Configure automated and manual
  actions
* [Publishing](/documentation/behavior/publishing): Publish changes to your AI
  Agent's behavior, knowledge, and actions