> 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/convai-playground/get-started/interact-in-voice-mode.md).

# 使用语音模式交互

使用语音模式为你的 Convai 角色启用实时、低延迟的语音对话，实现自然、免提的交互。

## 简介

**语音模式** 让你能够与角色进行流畅、自然且轻松的语音对话。本指南将介绍如何设置语音模式，并保持实时会话稳定，让对话体验更加顺畅。

## 分步指南

### 1. 打开角色

* 在你的 **控制面板**中，打开你想使用语音模式的角色。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FxbLohOUcwm1Kl2tDPBeL%2Fimage.png?alt=media&amp;token=73c0e4cf-426e-48b6-ba3b-597f205b8c65" alt=""><figcaption></figcaption></figure>

### 2. 配置语音设置

* 前往 **语言和语音** 并为你的角色选择一种语音。
* 配置完成后，点击 **更新** 以保存更改。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fr2PmYdbi0exwV9UsmtPs%2Fimage.png?alt=media&amp;token=4d05284c-cc83-4685-a795-30c10a51ed07" alt=""><figcaption></figcaption></figure>

### 3. 使用语音模式

点击麦克风按钮进入 **语音模式** 即可实时免提与角色交谈。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Feyf5cCZolH36kToHEesz%2Fimage.png?alt=media&amp;token=13568b38-2470-4a2d-8438-cd0c69e91bc2" alt="" width="375"><figcaption></figcaption></figure>

* 退出语音模式后， **对话记录** 会显示在聊天区域，供你查看。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FtfrAEXoKjmx0jR3dFamr%2Fimage.png?alt=media&amp;token=55a2e49e-e14f-4f63-a2c5-0978262c5824" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="warning" %}
如果你超过 **5 分钟**处于闲置状态，语音会话将自动断开。只需重新连接即可继续对话。
{% 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/convai-playground/get-started/interact-in-voice-mode.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.
