> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 对话流程

## 概述

对话流程设置决定助手如何处理用户沉默、说话时被打断以及轮次交接。这些设置可让对话更自然，并可根据使用场景自定义。

这些设置也适用于使用 [Realtime 模型](/docs/zh/eleven-agents/customization/realtime-models)的智能体。

#### [最长对话时长](#maximum-conversation-duration)

限制每次对话的总时长

#### [沉默后接话](#turn-timeout)

配置助手在沉默期间等待多久

#### [软超时](#soft-timeout)

智能体需要思考时提供自然的音频反馈

#### [打断](#interruptions)

控制用户能否在助手说话时打断它

#### [接话积极性](#turn-eagerness)

调整助手响应用户输入的速度

## 最长对话时长

**最长对话时长**设置限制对话可保持活跃的总时间。
此全局限制从对话开始时起算，独立于单轮超时设置。
默认值为 600 秒（10 分钟），可设为 60 至 7,200 秒。

### 配置

在 CLI 和 API 中，通过
`conversation_config.conversation.max_duration_seconds` 字段配置此设置。

#### 通过控制台更新

在控制台中打开智能体，前往 **高级**标签页，在 **通话限制**下调整 \*\*最长对话
时长 \*\*。保存更改。

#### 通过 CLI 更新

#### 拉取智能体配置

```bash
elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### 编辑智能体配置

设置 `conversation_config.conversation.max_duration_seconds`：

```json
{
  "conversation_config": {
    "conversation": {
      "max_duration_seconds": 1200
    }
  }
}
```

#### 推送智能体配置

```bash
elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### 通过 API 更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "conversation": {"max_duration_seconds": 1200},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    conversation: { maxDurationSeconds: 1200 },
  },
});
```

> **Warning**
>
> WhatsApp 消息对话默认有 15 分钟不活跃超时，从智能体最近一次回复起计算。该超时可能会在配置的
> 最长时长之前结束消息对话。若企业版客户的使用场景需要不同的超时时间，请联系
> [support@elevenlabs.io](mailto:support@elevenlabs.io) 支持团队。

## 沉默后接话

**沉默后接话**设置决定助手在用户沉默多久后接管下一轮并提示用户回复。

### 配置

该值以秒为单位，必须介于 1 至 30 秒。在 CLI 和 API 中，通过 `conversation_config.turn.turn_timeout` 字段配置此设置。

#### 通过控制台更新

在控制台中打开智能体，前往 **高级**标签页，并调整 **沉默后接话**值。保存更改。

![沉默后接话设置](/docs/_fern-img/9de7653a0940ae3441b3470c2af53f4a72294ad3680946d4c3fa3b91df69c566.webp)

#### 通过 CLI 更新

#### 拉取智能体配置

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### 编辑 \`agent_configs/\<agent-name>.json\`

设置 `conversation_config.turn.turn_timeout`：

```json
{
  "conversation_config": {
    "turn": {
      "turn_timeout": 7
    }
  }
}
```

#### 推送更改

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### 通过 API 更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "turn": {"turn_timeout": 7},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    turn: { turnTimeout: 7 },
  },
});
```

> **Note**
>
> 请根据使用场景选择合适的超时时长。较短的超时可让对话响应更快，但可能会打断需要更多时间回复的用户，
> 从而使对话不够自然。

### 最佳实践

* 对需要快速往返交流的日常对话，设置较短的超时（5–10 秒）
* 当用户可能需要更多时间思考或组织复杂回复时，使用较长超时（10–30 秒）
* 考虑用户场景：客户服务可能适合较短超时，而技术支持可能需要较长超时

## 软超时

当 LLM 生成回复的时间超过预期时，软超时会立即提供音频反馈。等待期间不再出现尴尬的沉默，智能体会说出如“嗯……”或“让我想想……”这样的简短填充语，以保持自然的对话节奏。

此功能适用于：

* 需要较长 LLM 处理时间的复杂查询
* 处理 LLM 提供商的可变延迟
* 通过自然的思考停顿打造更接近真人的对话

### 工作原理

1. 用户说完后，系统开始生成 LLM 回复
2. 根据配置的超时时长启动计时器
3. 若 LLM 回复在超时**前**到达，则不会说出填充语
4. 若在 LLM 回复**前**达到超时：
   * 立即说出配置的填充消息
   * 智能体继续等待实际回复
   * 回复准备就绪后，智能体说出完整的 LLM 回复

为避免连续出现多个填充语，每轮只会触发一次软超时。

### 配置

#### 通过控制台更新

在控制台中打开智能体，前往 **高级**标签页，并调整 **软超时**设置。保存更改。

![软超时设置](/docs/_fern-img/7fdaca49ad50e6bc1f09f5eac46e36f0f4b071c5477e061a62791df9e100be75.webp)

#### 通过 CLI 更新

#### 拉取智能体配置

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### 编辑 \`agent_configs/\<agent-name>.json\`

设置 `conversation_config.turn.soft_timeout_config`：

```json
{
  "conversation_config": {
    "turn": {
      "soft_timeout_config": {
        "timeout_seconds": 3.0,
        "message": "Hhmmmm...yeah.",
        "use_llm_generated_message": false
      }
    }
  }
}
```

#### 推送更改

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### 通过 API 更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "turn": {
            "soft_timeout_config": {
                "timeout_seconds": 3.0,
                "message": "Hhmmmm...yeah.",
                "use_llm_generated_message": False,
            },
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    turn: {
      softTimeoutConfig: {
        timeoutSeconds: 3.0,
        message: "Hhmmmm...yeah.",
        useLlmGeneratedMessage: false,
      },
    },
  },
});
```

#### 超时时长

等待 LLM 回复期间，说出填充消息前的秒数。

| 设置      | 说明              |
| ------- | --------------- |
| **默认值** | `-1`（禁用）        |
| **范围**  | `0.5` 至 `8.0` 秒 |
| **推荐值** | `3.0` 秒         |

> **Tip**
>
> 从 3.0 秒开始：这个时长足以避免快速回复时出现不必要的填充语，也足够短，可防止尴尬的沉默。

#### 静态消息

触发软超时时说出的预设填充语。

| 设置      | 说明                 |
| ------- | ------------------ |
| **默认值** | `"Hhmmmm...yeah."` |
| **长度**  | 1–200 个字符          |

此消息支持：

* **语言覆盖**：自动翻译为智能体配置的其他语言
* **客户端覆盖**：可通过 SDK 为每次通话自定义

#### LLM 生成的消息

启用后，会使用轻量级 LLM 动态生成符合上下文的填充语，而非使用静态消息。

| 设置       | 说明          |
| -------- | ----------- |
| **默认值**  | `false`     |
| **回退方案** | 生成失败时使用静态消息 |

系统会使用最近的对话上下文（最多 4 条消息、1000 个字符）生成相关填充语，例如“嗯……”“我明白了……”“了解……”“收到……”或“好的……”。

> **Note**
>
> 使用 LLM 生成的消息时，仍必须提供静态回退消息。

### 最佳实践

* 避免在填充消息中使用时间提示（例如“等一下……”），因为实际回复时间不可预测
* 对回复始终很快的 FAQ 机器人，禁用软超时

## 打断

打断处理决定用户能否在助手说话时打断它。

### 配置

可在智能体 **高级**标签页的 **客户端事件**下配置打断设置。

如需启用打断，请确保已将打断设为选中的客户端事件。

#### 已启用打断

![允许打断](/docs/_fern-img/1da794be8ea3bfed45d06241ce5db390480cd45d27c0f886943518bd52d76157.webp)

#### 已禁用打断

![忽略打断](/docs/_fern-img/847a2ebcdfff9498501502ab4b568fc498b6995f860a5552177a7883942197ff.webp)

> **Note**
>
> 在必须完整传达信息的情况下，例如法律免责声明或安全说明，应禁用打断。

### 打断最佳实践

* 在需要自然往返对话的场景中启用打断
* 当完整传达消息至关重要时禁用打断（例如条款与条件、安全信息）
* 考虑使用场景：客户服务可能适合打断，而信息传达场景可能不适合

## 接话积极性

接话积极性控制助手在对话中响应用户输入的速度。该设置决定助手会多积极地根据检测到的语音模式接管轮次并开始说话。

### 工作原理

助手现包含两项关键改进，让轮次交接更自然：

1. **更快生成回复**：助手从语言模型接收到足够的词语和一个逗号后便会开始说话，而不是等待完整句子。这可降低延迟并使对话响应更快，尤其适合回复较长的情况。

2. **可配置的接话积极性**：控制助手将停顿或语音模式判定为可回复时机的速度。

### 配置

可选择 3 种模式：

* **积极**：助手会快速响应用户输入，在最早的时机接话。最适合重视即时回复的快节奏对话。
* **普通**：平衡的轮次交接方式，适合大多数对话场景。助手会在自然的对话停顿后回复。
* **耐心**：助手会等待更久再接话，让用户有更多时间表达完整想法。适合收集详细信息，或用户需要时间组织回复的场景。

#### 通过控制台更新

在控制台中打开智能体，前往 **智能体**设置，并选择所需的接话积极性模式。保存更改。

#### 通过 CLI 更新

#### 拉取智能体配置

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### 编辑 \`agent_configs/\<agent-name>.json\`

将 `conversation_config.turn.turn_eagerness` 设为 `"patient"`、`"normal"` 或 `"eager"` 之一：

```json
{
  "conversation_config": {
    "turn": {
      "turn_eagerness": "normal"
    }
  }
}
```

#### 推送更改

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### 通过 API 更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "turn": {"turn_eagerness": "normal"},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    turn: { turnEagerness: "normal" },
  },
});
```

> **Note**
>
> 接话积极性与 workflow 配合时尤其强大。你可以根据上下文动态调整助手的响应速度：在日常对话中让它更快接话，
> 或在收集电话号码、邮箱等敏感信息时等待更久。

### 接话积极性最佳实践

* 在快速回复可提升用户体验的客户服务场景中使用 **积极**模式
* 收集电话号码、地址或邮箱等结构化信息时使用 **耐心**模式
* 将 **普通**模式作为一般对话流程的默认设置
* 结合 workflow，根据对话上下文动态调整接话积极性
* 针对具体使用场景测试不同设置，找到最佳平衡

## 推荐配置

#### 客户服务

* 使用较短超时（5–10 秒）以实现快速互动 - 启用打断，让客户能插入提问 - 使用 **积极**接话积极性，实现快速响应的对话

#### 信息收集

* 使用中等超时（10–15 秒），让用户有时间收集信息 - 启用打断以保持自然对话流程 - 收集电话号码、地址或邮箱时使用 **耐心**接话积极性

#### 法律免责声明

* 使用较长超时（15–30 秒）以处理复杂回复 - 禁用打断，确保完整传达法律信息 - 使用 **普通**接话积极性，保持稳定节奏

#### 对话式教育科技

* 使用较长超时（10–30 秒），让用户有时间思考和组织回复 - 启用打断，让学生能插入提问 - 使用 **耐心**接话积极性，给学生充足的回复时间