> 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. 配置语音设置

* 导航到 **语言和语音** 并为你的角色选择一个声音。
* 配置完成后，点击 **Update** 以保存你的更改。

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