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