# How to Author AI Chat

## Overview

With AI Chat, you can design AI-powered conversation partners to enrich your learning experiences.

**Note**

The AI Chat feature is only available for select HyperSkill users. If you would like access to the AI Chat feature, please contact <info@siminsights.com> and inquire about getting access to the feature.

## Authoring AI Chat in HyperSkill: A Step-by-Step Guide

This guide creates a customer complaint roleplay scenario using AI Chat in HyperSkill.

**1. Accessing** AI Cha&#x74;**:**

* Open HyperSkill and log in to your author account.
* Navigate to your simulations list and create a new simulation. Give it a name of your choosing and enter edit mode.
* Click on the **Settings** tab and toggle on **Enable Microphone Input.**
* Click the **AI** tab, the AI Chat sub-tab will be automatically selected for you.

You'll see the following page:

<figure><img src="/files/QZLuASKBMiPSvroZ6GBD" alt=""><figcaption><p>The AI Chat tab in HyperSkill edit mode</p></figcaption></figure>

**2. Configuring AI Chat:**

* Click on the "Enable Chit Chat" toggle to run AI Chat on. The edit panel will unlock.
* Next to the toggle is a dropdown from the language model. Leave the selected option as "Azure".
* Give the AI Chat character a name of your choosing.
* Paste the following under "Prompt":
  * You are role-playing as a customer with a complaint about expired items they found on the shelves. You are frustrated and express concern about the store's quality control.
* We're done!

**3. Testing AI Chat:**

* Click the "+ Conversation" button in the top bar to test your AI Chat prompt in multi-round dialogue.
* Type into the chat window to begin speaking with your roleplaying character.

<figure><img src="/files/wmhpGR2v0TXCmYXsyQuP" alt=""><figcaption><p>The beginning of a multi-turn dialogue</p></figcaption></figure>

**4. Add a physical presence:**

* Add a [virtual person](broken://pages/uCrHSZm0F7k42Cwxy6lN) to the scene in the [Scene Layout](/authoring-a-simulation/scene-layout.md) Tab.
* Click on the **Settings** tab and look for the header **Virtual Assistant.**
* Under virtual assistant, select the virtual person and a voice of your choosing.

**5. Test your experience:**

* Hit the save button at the top right of the window and enter experience mode.
* Try talking using your microphone or text window. The AI Chat character will respond once you've finished speaking.

**Conclusion**

Congratulations! You've built your first role-playing character. Try changing the prompt instructions to see how the character responds.&#x20;


---

# 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/ai/ai-chat/how-to-author-ai-chat.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.
