# Change Character Prompt

You are able to alter the behavior, knowledge, and goal of your AI Chat agent during the course of your simulation with this action. This will allow your agent to easily perform multiple roles in the middle of your simulation by simply adjusting what prompt the agent is using to what is necessary at the time. Within the text field, type into the prompt what you would like the AI Chat agent to use.

Please take note that this is overwriting what the previous prompt was in the agents memory. They will still have access to the entire conversation up to this point unless you also use the [Reset Chat](/authoring-a-simulation/state-machine/actions/reset-chat.md)action.

For further details on your initial character prompt, see [AI Chat](/ai/ai-chat.md)


---

# 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/change-character-prompt.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.