# Speak

<figure><img src="/files/K0Yb7GKMszmMascnaZCx" alt="" width="302"><figcaption></figcaption></figure>

Message: The text to speak. Click on the **Headphone** icon to preview the spoken text.

Person: The virtual person that will do the speaking.

Audio Output Type: If **Text to Speech** is used, the speech audio will be generated. If further customization is required, the **Uploaded Audio** option enables users to upload pre-recorded voices.&#x20;

Voices: Only available for an audio output type of **Text to Speech**. List of voices available for generation.

Audio File: Only available for an audio output type of **Uploaded Audio**. The file of the pre-recorded voice.

Animation Type:&#x20;

* None: Do not animate the virtual person while speaking
* Random: (Default) Use a random speaking animation while speaking
* Selected: Select a specific animation to use while speaking

Animation: Only available for a **Selected** animation type. Animation to play when speaking.

Wait Until Finished Speaking: If active, the state machine will pause until the virtual person's speech is done playing.


---

# 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://docs.siminsights.com/authoring-a-simulation/state-machine/actions/speak.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.
