# Experience Settings

## **Final Touches Before Deployment**

These settings define how your avatar behaves during live interaction and how the experience is sustained or terminated based on user activity.

***

## **AFK Timeout**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfHZtMlfMw-lxVl3Uor1UdKTyiHogz_kblzCYnWHd5TDX_LizTBMO_mq82Hc9icj-x_TqZ_NXAifbBV1drCTia9_6AaANrFvdBEKtyvTKNEixT1l7pcXugSKBVgxnvU1qU22Af-Xw?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

Set an **AFK (Away-From-Keyboard)** timeout to manage idle sessions and conserve your pixel-streaming minutes.

* Open the **dropdown menu** under AFK Timeout.
* Select a suitable timeout duration (e.g., 1 min, 5 mins, 10 mins).
* The session will automatically end based on your selection if there’s no user activity.

{% hint style="success" %}
To optimize your account's usage, set an AFK timeout to avoid unnecessary streaming consumption.
{% endhint %}

***

## **Welcome Message**

Greet users as soon as they enter the experience with customizable welcome interactions.

**Standard Welcome**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdFwaTaZGwtD_yO0JaIAKqaZgnKRNvVmUFjzTflqOXxZl4BUzkJrw4eX7n7VqPBBPaXJgG2v1-Gux0TVXQFTajwpDJvzEevnOzYE3RkS8zm89cu0Y7i8Bu6GF-gsmHxGSuDIUru_w?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

* Toggle **“Welcome Message”** ON.
* Enable a **custom welcome prompt** (e.g., “Welcome the user and introduce yourself”).
* Click **“Test Welcome Message”** to preview it.

**Vision-Based Welcome**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXday5rBZZsNcNxKV2kHJht7CwWbEAJg-vZttQzxBPtJ6SyElog1aHLWt-_2loGATkELlQ3-u2cZna2_HzJb7kG3_nPb2_7043MCMXn--Fe4y33eFQ9YitqArPMBiqro1OmL0Ga55Q?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

Make the greeting more dynamic by enabling vision awareness:

* Toggle **“Vision-Based Welcome Message”** ON.
* Add a **custom prompt** (e.g., “A person approaches—welcome them and make a comment about their attire or an object they’re holding”).
* Use **“Test Message”** to preview how the avatar responds based on webcam input.

***

## **User Microphone Settings**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdZm8XIvGdblm_lX3z47mw7kvt0jCOqLsi6DH8NxdrMKvpixxYgNknAm8BQoBmp5YCnkwjQsY76DI_6HKPV3M3v0NSEPGhgnFcOnrWBWpcIc9_gvbVEj7XIHkrbXydb0vGuLoYI?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

Select the input style that fits your use case:

* **Hands-Free Mode (WIP)**\
  Avatar listens continuously.
* **Push-to-Talk Mode**\
  Activate microphone input only when the assigned key is pressed.
  * You can **assign a custom key** for push-to-talk functionality.

***

## Processing Frequency

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf-ebPyNjtfXrw5cSlsX6QHDaEfgTqx4O7fZxQO9iI6MqCu6EMLjSvLcUupwAyIkXGw4ZekRUFl7IOt67ANNMdhsLB_IQgvRCtkUL-SBxSYoUEJg3voRJc_jqqFNaxWoblJk-IA?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

Control how often the avatar processes and reacts to input, allowing it to act more proactively.

* Open the **dropdown menu** for processing frequency.
* Choose a time interval for the avatar to periodically evaluate multimodal inputs (voice, text, vision).
* This enables **agentic behavior** — where the avatar can initiate interaction based on user presence or signals.

{% hint style="danger" %}
After making changes:

* Click **“Save Changes”**
* If you are creating an Avatar for this character for the first time, press the **"Create Character"** button **before proceeding to the publishing step.**
  {% endhint %}


---

# 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.convai.com/api-docs/no-code-experiences/avatar-studio-experiences/customizing-your-avatar/experience-settings.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.