> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/experience-settings.md).

# 体验设置

控制空闲会话处理、欢迎交互、麦克风行为和输入处理时机，以微调你的头像体验。

## **部署前的最后调整**

这些设置定义你的虚拟形象在实时互动中的行为，以及根据用户活动如何维持或终止体验。

***

## **AFK 超时**

<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>

设置一个 **AFK（离开键盘）** 超时时间，用于管理空闲会话并节省你的像素流分钟数。

* 打开 **下拉菜单** 在“AFK 超时”下。
* 选择合适的超时时长（例如 1 分钟、5 分钟、10 分钟）。
* 如果没有用户活动，会话将根据你的选择自动结束。

{% hint style="success" %}
为优化你的账户使用情况，请设置 AFK 超时，避免不必要的流媒体消耗。
{% endhint %}

***

## **欢迎消息**

用户一进入体验，就用可自定义的欢迎互动向其问候。

**标准欢迎**

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

* 开关 **“欢迎消息”** 开启。
* 启用一个 **自定义欢迎提示词** （例如：“欢迎用户并介绍你自己”）。
* 点击 **“测试欢迎消息”** 以预览效果。

**基于视觉的欢迎**

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

通过启用视觉感知，让问候更具动态性：

* 开关 **“基于视觉的欢迎消息”** 开启。
* 添加一个 **自定义提示词** （例如：“有人走近——欢迎他/她，并评论其穿着或手里拿着的物品”）。
* 使用 **“测试消息”** 以预览虚拟形象根据摄像头输入的响应方式。

***

## **用户麦克风设置**

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

选择适合你使用场景的输入方式：

* **免手持模式（开发中）**\
  虚拟形象会持续监听。
* **按键通话模式**\
  仅在按下指定按键时激活麦克风输入。
  * 你可以 **分配一个自定义按键** 用于按键通话功能。

***

## 处理频率

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

控制虚拟形象处理并响应输入的频率，使其能够更主动地行动。

* 打开 **下拉菜单** 用于处理频率。
* 选择一个时间间隔，让虚拟形象定期评估多模态输入（语音、文本、视觉）。
* 这使得 **主动式行为** ——即虚拟形象可以根据用户在场或信号主动发起互动。

{% hint style="danger" %}
修改后：

* 点击 **“保存更改”**
* 如果你是第一次为这个角色创建虚拟形象，请点击 **“创建角色”** 按钮 **然后再继续发布步骤。**
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/avatar-studio-experiences/customizing-your-avatar/experience-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
