# Simulator

*Last updated: May 5, 2026*

Use the Simulator to test how Aissist responds before you go live.

It shows the reply, the context behind it, and any actions or sub agents involved.

### Open the Simulator

1. Go to **Simulator** from the left navigation.
2. Enter a test message.
3. Review the result and supporting details.

### What to test

Use realistic examples from your live workflows.

Test things like:

* common customer questions
* edge cases and sensitive requests
* scenarios that should trigger sub agents
* scenarios that should call actions

If your workflow depends on customer identity or order context, use the simulator settings to mirror a real case.

### What to inspect

The Simulator helps you inspect:

* **Response** — the reply Aissist generated
* **Output Context** — the instructions, assets, and sub agents that influenced it
* **Sub Agents Triggered** — which workflow matched
* **Actions Called** — which actions ran and with what parameters
* **Action Response** — what the action returned
* **Escalation, summary, and follow-up** — whether the workflow handed off or created next steps

<figure><img src="/files/vEcqOIfNPls847IeRHIA" alt=""><figcaption><p>Example Simulator view</p></figcaption></figure>

### Fix common issues

If the result is wrong:

* update **Instructions** if behavior is off
* update **Assets** if knowledge is missing or conflicting
* update **Sub Agents** if the wrong workflow triggered
* update **Actions** if parameters or returned data are incorrect

### Recommended workflow

Use the Simulator whenever you:

* add or change instructions
* add or change assets
* create or edit sub agents
* connect or update actions

For action-specific troubleshooting, use [Action Debugger](/integrations/action-debugger.md).

For asset retrieval checks, use [Asset Debugger](/tutorial/turn-assets-into-ai/asset-debugger.md).

### Best practice

Test one workflow at a time.

Fix issues at the source, then re-run the same scenario until the result is stable.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.aissist.io/tutorial/simulator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.