# Chat Interface

<h2 align="center">Points of Interest</h2>

<figure><img src="/files/HGTeR1KFEgk8q8XKQ9xC" alt=""><figcaption></figcaption></figure>

<h2 align="center">General Chat Interface</h2>

Open any chat to enter into the Chat Interface. These look slightly different on mobile / app view and full desktop view, but most things are in the same location.

<figure><img src="/files/PMIw7cWRVmcFg31KwPfv" alt=""><figcaption></figcaption></figure>

At the top of the page will be the chat's name, an icon representing the chat (usually the Xoul or Scenario's icon), and a few buttons.

{% columns %}
{% column width="25%" %}

{% endcolumn %}

{% column width="50%" %}
{% hint style="success" %}
Click the Xoul's icon on the upper bar to view how much Energy you have left and quickly refill it from the popup menu.

&#x20; ↳ [Energy, Cells & Streaks](/xoul.ai-official-guide/navigation-and-information/subscriptions/energy-cells-and-streaks.md)
{% endhint %}

{% endcolumn %}

{% column width="24.999999999999986%" %}

{% endcolumn %}
{% endcolumns %}

### Narrate

Clicking this will narrate the speech bubble using the voice the creator selected for the Xoul or the voice you select from the right side panel Voice & Narration menu.

{% columns %}
{% column width="25%" %}

{% endcolumn %}

{% column width="50%" %}
{% hint style="success" %}
Remove this button completely by turning it off in your Account Preferences.

&#x20; ↳ [Account Settings](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/account-settings.md)
{% endhint %}

{% endcolumn %}

{% column width="25%" %}

{% endcolumn %}
{% endcolumns %}

### Regenerate

Clicking <img src="/files/z7ij0abVY03kWOOicG9K" alt="" data-size="line"> will regenerate the reponse the AI model sent. Free users are allowed 10 free regenerations per reply. Subscribers get unlimited regenerations.

{% columns %}
{% column width="25%" %}

{% endcolumn %}

{% column width="50%" %}
{% hint style="success" %}
Maintaining a streak will eventually unlock the ability regenerate more for free users.

&#x20; ↳ [Energy, Cells & Streaks](/xoul.ai-official-guide/navigation-and-information/subscriptions/energy-cells-and-streaks.md)
{% endhint %}

{% endcolumn %}

{% column width="24.999999999999986%" %}

{% endcolumn %}
{% endcolumns %}

### Three Dots Menu <img src="/files/Ls5GYqc78ZkzScolCTsM" alt="" data-size="line"> (Chat Bubble)

<figure><img src="/files/xUCucldUkotASNSFBuyM" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Pin" %}
This will pin the full text from a reply directly into the Memories field, which you can find by opening the right-side panel and navigating into settings and opening the Memories menu.

{% hint style="warning" %}
It is not recommended to pin replies as this uses up a lot of the available Memories field. It's better to summarize important events from the chat.

&#x20; ↳ [Memory & Context](/xoul.ai-official-guide/navigation-and-information/subscriptions/memory-and-context.md)\
&#x20; ↳ [Memories Field](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/memories-field.md)
{% endhint %}
{% endtab %}

{% tab title="View Lorebook" %}
If a Lorebook is attached to the Xoul, Scenario or chat **and** Lorebook entries successfully triggered for this reply the 'View Lorebook' option will appear at the bottom of the three dots menu.

{% hint style="success" %}
This is extremely helpful for testing how well designed your Lorebook is!

&#x20; ↳ [Lorebooks](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/lorebooks.md)
{% endhint %}
{% endtab %}

{% tab title="Branch Chat" %}
Branch Chat will create a new chat from this reply, including all previous replies.&#x20;

{% hint style="info" %}
The current chat will not be deleted.
{% endhint %}
{% endtab %}

{% tab title="Edit, Copy, Delete & Rewind" %}

* **Edit** allows you to edit your reply, or the model's.&#x20;
* **Copy** will copy the entire chat bubble, markdown included.
* **Delete** will delete the reply, but not any of the replies after it.
* **Rewind** will delete **all replies** after the message you are rewinding to. This is an easy way to jump back in the chat.

{% hint style="danger" %}
Careful, you can't undo deletes or rewinds.
{% endhint %}
{% endtab %}
{% endtabs %}

***

<h2 align="center">Chat History</h2>

Clicking <img src="/files/Ac29JCzOHOe6RJsi3CI2" alt="" data-size="line"> will open the **Chat History panel**.&#x20;

{% hint style="info" %}
Quick delete chats by **right clicking** or **swiping them** on desktop or mobile to reveal the quick delete option.
{% endhint %}

{% hint style="danger" %}
Accidentally deleted something you didn't want to? Reach out on discord or reddit quickly and we may be able to restore the chat.
{% endhint %}

<figure><img src="/files/Vrj9UcjbxVVqWz0AUheH" alt=""><figcaption></figcaption></figure>

To access your **Chat History** on a mobile device you'll have to tap the <img src="/files/ykGNKN7UbOgMSMxx2GAW" alt="" data-size="line"> Chat icon on the Navigation Panel on the bottom of the screen.

***

<h2 align="center">Right Side Panel</h2>

Clicking <img src="/files/uqFOg4h7YfTcfK2Jlwup" alt="" data-size="line"> the three dots menu will open the **right-side panel** which contains the **Info Panel, Call Panel and Settings Panel.** There are a lot of powerful features here.

{% columns %}
{% column %}

<figure><img src="/files/ZWP650TMlV9ghIC3hIml" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column valign="middle" %}

<h3 align="center">Info Panel</h3>

<p align="center">(Single-Xoul Chat)</p>

The **right-side panel** will open to the <img src="/files/VApYaqp0rPvRllsM7LkK" alt="" data-size="line"> **Info Panel** containing an image of the Xoul, the Xoul's name, Handle, Creator Memo (if used), Description (called 'Backstory'), Gender and Age.

You can also click **Start New Chat** to quickly begin a new chat with this Xoul.

{% hint style="success" %}
Click the Handle (e.g. @YuriaV1.xo) to quickly jump back to the Xoul's profile page!
{% endhint %}
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}

<figure><img src="/files/4vE2KylS8OpBtg7nt4Hy" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column valign="middle" %}

<h3 align="center">Call Panel</h3>

Quickly access the call option by clicking the <img src="/files/HK6qTDYMs7iOjLQKnlW0" alt="" data-size="line"> button beside the three dots menu or navigate to this page in the **right-side panel** to enter into a voice call with the Xoul.&#x20;

The Xoul will use the voice the creator set for them, but you can edit this at any time in the Settings Panel.

Voice calls costs 5 Cells per minute.

&#x20; ↳ [Energy, Cells & Streaks](/xoul.ai-official-guide/navigation-and-information/subscriptions/energy-cells-and-streaks.md)
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column valign="middle" %}

<figure><img src="/files/uuet7y9xcS4T2v0k6c2N" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column valign="middle" %}

<h3 align="center">Settings Panel</h3>

By clicking the <img src="/files/L9Ef5JdrOAK44KQ5VmZI" alt="" data-size="line"> settings icon you will open the Settings Panel.

Engine allows you to change the AI model for the chat, Response Style and Length.

&#x20; ↳ [AI Models](/xoul.ai-official-guide/navigation-and-information/ai-models.md#language-models)

Appearance allows you the change the chat's name and, if you have a subscription, add a background image.

&#x20; ↳ [Subscriptions](/xoul.ai-official-guide/navigation-and-information/subscriptions.md)

Memories is a powerful feature to help manage the AI model's memory.

&#x20; ↳ [Memories Field](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/memories-field.md)

Voice & Narration allows you to change and customize voice features.

&#x20; ↳ [Voices](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/voices.md)

Lorebook allows you to add or remove up to 3 Lorebooks.

&#x20; ↳ [Lorebooks](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/lorebooks.md)

Persona allows you to change or create a new Persona from within the chat.

&#x20; ↳ [Personas](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/profile-page/personas.md)

And for Group Chats this panel will have a Talkativity option for dynamic responses.

&#x20; ↳ [(Group) Chats & Multi-User Chats](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/group-chats-and-multi-user-chats.md)
{% endcolumn %}
{% endcolumns %}

***

<h3 align="center">Engine Menu</h3>

<figure><img src="/files/Ov4dVibrP49nE9UhHrp5" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Model" %}

#### Model Menu

Allows you to select which one of Xoul.AI's models respond in the chat. Displays the energy cost associated with each model.

* **Bacchus:** 1 Energy per reply. With a 30+ day streak Bacchus becomes free to use.
  * Bacchus is a lightweight model that is prized for how raw and expressive it can be, but it lacks intelligence and replies tend to be on the short side. This model excels in explicit or violent scenes and tends to portray certain characters very well.
* **Jupiter:** 3 Energy per reply.
  * Jupiter is a jack-of-all-trades model, capable of storytelling and character acting in equal measure. Jupiter is a great all-around model for most chats and stories.
* **Infinity:** 5 Energy per reply.
  * Infinity is a very intelligent, but slower model that excels at complex storytelling and plot. It can handle anything you throw at it.

{% hint style="info" %}
You can also use a custom model by providing a URL and API key. Select the Custom option in the Model menu to set up a custom proxy.

&#x20; ↳ [Custom Engine (Proxy)](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/custom-engine-proxy.md)
{% endhint %}
{% endtab %}

{% tab title="Response Style" %}

#### Response Style Menu

These are the system prompt instructions telling the model how to reply in a chat.

**Roleplay (Character-Focused):** A system prompt which instructs the model to reply in character with basic roleplay instructions. This includes using \*asterisks\* around narration and "quotation marks" around dialogue.

{% hint style="info" %}
You can override this formatting within Xoul creation.

&#x20; ↳ [Xoul Creation Interface](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/xouls/xoul-creation-interface.md#override-default-formatting)
{% endhint %}

**Novel (Slowburn):** A system prompt which instructs the model to reply as a storyteller, focusing on writing beyond just a single character's internal monologue.

**Realistic (Natural):** A system prompt which instructs the model to reply casually, as if this is a simple text chat.

**Lust (Explicit):** A system prompt which is designed from the ground up to help the model write the best possible explicit content. It contains all the helpful instructions on how to develop an explicit scene, to use appropriate language and focus on the things that are important during these sorts of scenes.

{% hint style="info" %}
The Lust Response Style is only available to users with the Safety Filter toggled off.

&#x20; ↳ [Account Settings](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/account-settings.md#preferences)
{% endhint %}

<figure><img src="/files/qFMghOz6d7zLeTiVKk72" alt=""><figcaption></figcaption></figure>

#### Custom

The final option, Custom, is a system prompt **override**, replacing Xoul.AI's system prompt with one of your own design.

{% hint style="danger" %}
The Custom Response Style is **NOT** and should not be used as a "place to put prompts". It requires a **full instructional prompt**.

This is a power user option and should be used with care.\
&#x20; ↳ [Response Style & Length](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/response-style-and-length.md#custom-system-prompt)
{% endhint %}
{% endtab %}

{% tab title="Length" %}

#### **Length Menu**

* **Dynamic:** A response style that instructs the model to respond with a length that is dynamic and suits the moment. This can range from very short, to very long, as few as one paragraph containing only a few sentences, or many paragraphs with a variety of sentences lengths. It's fluid, flexible, and won't develop a strict pattern of paragraphs, sentences, dialogue location, etc.
  * **This length is recommended.** It breaks and prevents patterns from developing resulting in the model having the most freedom to write creatively because it isn't being compelled to stick to a strict length.
* **Long:** 3-4+ paragraphs.
* **Medium:** 2-3 paragraphs.
* **Short:** 1 paragraph.

{% hint style="warning" %}
**NOTE: These instructions are&#x20;*****suggestive*****&#x20;at best.**&#x20;

AI models like patterns and they are a stronger influence on the model's reply length than this setting. This setting can *help,* but it won't instantly or drastically change the model's length.

The Greeting message will have the strongest influence on length at the start of a chat.
{% endhint %}
{% endtab %}
{% endtabs %}

***

{% columns %}
{% column %}

<figure><img src="/files/ORIbUfxHupOKxLcBRuuQ" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column valign="middle" %}

### Appearance Menu

#### Chat Name

All users can change their chat name at any time by typing a new custom name into the Chat Name field.

#### Chat Background

For Subscribers you'll be able to upload a background image for the chat and change the opacity of the image to your liking.

&#x20; ↳ [Subscriptions](/xoul.ai-official-guide/navigation-and-information/subscriptions.md)
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

<figure><img src="/files/whLp4Gv8K4ys6xFNjkmS" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

### Memories Menu

The Memories field is a text field where you can pin replies to or write in summaries, notes, or other important information about the chat.

The AI model can only read a certain amount of text in the chat, which means the earliest replies in the chat eventually stop being read. The number of replies the model can read is based on your subscription level.

&#x20; ↳ [Subscriptions](/xoul.ai-official-guide/navigation-and-information/subscriptions.md)

The Memories field is permanent, meaning anything written in this field will be known to the model for this chat.

&#x20; ↳ [Memories Field](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface/memories-field.md)
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

<figure><img src="/files/916JoUlZAUM8JyxYC5qa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

### Voice & Narration Menu

You can select two voices for the Xoul to use for narrating replies or in Calls. One voice will speak the dialogue, while the other will speak the narration.

&#x20; ↳ [Voices](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/voices.md)

&#x20; ↳ [AI Models](/xoul.ai-official-guide/navigation-and-information/ai-models.md#voices)

Playing messages or using the Call feature costs Cells.

&#x20; ↳ [Energy, Cells & Streaks](/xoul.ai-official-guide/navigation-and-information/subscriptions/energy-cells-and-streaks.md)
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

<figure><img src="/files/GIksYkZ66rpJsXZtz4EO" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

### Lorebook Menu

You can add up to three Lorebooks for the chat. Use the 'Active Lorebook' option in the three dots menu below a chat bubble from the model to see which Lorebook entry was pulled for that reply.

&#x20; ↳ [Lorebooks](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/lorebooks.md)
{% endcolumn %}
{% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

<figure><img src="/files/0nnWBSfpTQRkmprBQmCz" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

### Persona Menu

You can change or **create a new Persona** at any time in the chat.&#x20;

Creating a **new Persona** will open the Persona Creation Interface the same as if you were on your profile page, and this new Persona will be saved.

&#x20; ↳ [Personas](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/profile-page/personas.md)

{% hint style="success" %}
You can edit your Persona at any time by navigating back to your Profile and editing the Persona there.
{% endhint %}

{% hint style="warning" %}
Swap to a different Persona and back to the edited Persona to make sure the new details are loaded properly into the AI's context.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

***

<h2 align="center">Group Chat Interface</h2>

{% columns %}
{% column width="50%" valign="middle" %}

<figure><img src="/files/TBpo0T4kmG15CBNfhONs" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" valign="middle" %}

<h3 align="center">Info Panel</h3>

<p align="center">(Group Chat)</p>

Opening the <img src="/files/VApYaqp0rPvRllsM7LkK" alt="" data-size="line"> Info Panel for a Group Chat will show:

* **The Group Name:** Chosen during Group Chat creation.
* **The Group Link:** Share this with other Xoul users to invite them into your chat and turn the Group Chat into a **Multi-User Chat.**
  * &#x20; ↳ [(Group) Chats & Multi-User Chats](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/group-chats-and-multi-user-chats.md)
* **Description:** The scenario or description provided during Group Chat creation.
* **Xouls:** Displays the Xouls active in the chat. You can have 2-8 Xouls. Add or remove Xouls whenever you want.
* **Users:** The Personas of the users in this chat. For Group Chats this displays your active Persona, for Multi-User Chats this displays all user's Personas.
  {% endcolumn %}
  {% endcolumns %}

***

{% columns %}
{% column valign="middle" %}

<figure><img src="/files/XVAJpS7msqq9n6VZuuE1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<h3 align="center">Talkativity</h3>

When Auto Response is toggled on, or if you select Dynamic (beta) when creating a Group Chat the Xouls will respond automatically.

* Settings a Xoul to 1.00 Talkativity will cause that Xoul to respond every time you send a message.
* Setting a Xoul to 0.00 Talkativity will prevent this Xoul from ever choosing to reply *unless your reply directly indicates that Xoul should respond*.
* Values between 0.00 and 1.00 will change how frequently the Xoul replies with some level of randomness.

&#x20; ↳ [(Group) Chats & Multi-User Chats](/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/content-creation/group-chats-and-multi-user-chats.md)
{% endcolumn %}
{% endcolumns %}


---

# 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://xoul-ai-official-documentation.gitbook.io/xoul.ai-official-guide/navigation-and-information/navigation-and-interfaces/chat-interface.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.