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

# 跳过轮次

## 概述

**跳过轮次** 工具可让对话智能体明确暂停，在继续前等待用户发言或操作。当用户表示需要一点时间时，此系统工具很有用，例如用户说“等我一下”、“让我想想”或“请稍等”。

## 功能

* **用户发起的暂停**：当 LLM 检测到用户需要短暂且不受打扰的暂停时，会调用此工具。
* **无语音回复**：调用此工具后，助手不会说话。它会等待用户再次互动，或等待满足其他轮次交接条件。
* **自然的对话流程**：该工具会尊重用户短暂休息的需求，不会结束交互或让智能体进行不必要的发言，从而帮助保持自然的对话节奏。

**用途**：让智能体暂停并等待用户输入，不发出语音。

**触发条件**：LLM 应在以下情况调用此工具：

* 用户表示需要一点时间（“给我一点时间”“让我想想”）
* 用户要求暂停对话流程
* 智能体检测到用户需要时间处理信息

**参数**：

* `reason`（字符串，可选）：说明为何需要暂停的自由格式原因

**函数调用格式**：

```json
{
  "type": "function",
  "function": {
    "name": "skip_turn",
    "arguments": "{\"reason\": \"User requested time to think\"}"
  }
}
```

**实现方式**：无需额外配置。该工具仅向智能体发出信号，使其保持静默，直到用户再次说话。

### API 实现

通过 API 创建智能体时，可以将跳过轮次工具添加到智能体配置中。它应定义为系统工具，名称为 `skip_turn`。

```python
from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs

elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")

response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            prompt={
                "built_in_tools": {
                    "skip_turn": {
                        "type": "system",
                        "name": "skip_turn",
                        # Optional: customize when the tool should be triggered,
                        # or leave blank for the default.
                        "description": "",
                        "params": {"system_tool_type": "skip_turn"},
                    }
                }
            },
        ),
    ),
)
```

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

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      prompt: {
        builtInTools: {
          skipTurn: {
            type: "system",
            name: "skip_turn",
            description: "", // Optional: Customize when the tool should be triggered, or leave blank for default.
            params: { systemToolType: "skip_turn" },
          },
        },
      },
    },
  },
});
```

## UI 配置

你也可以直接在智能体 UI 的工具部分配置跳过轮次工具。

### 第 1 步：添加新工具

前往智能体配置页面。在“工具”部分点击“添加工具”，即可看到 `Skip Turn` 选项。

![添加跳过轮次工具选项](/docs/_fern-img/8b95051da94ada3dae7e42121148ad4509b49413e73bd16351142372ca26a68d.webp)

### 第 2 步：配置工具

你可以选择添加描述来定制 LLM 应在何时触发此工具，也可以留空以使用默认行为。

![配置跳过轮次工具](/docs/_fern-img/cbb419db630beb4feefc390ef3f3576f7a6dc2df098faec4fbd2d1d5e703364f.webp)

### 第 3 步：启用工具

配置完成后，`Skip Turn` 工具将显示在智能体的已启用工具列表中，智能体即可跳过轮次。.

![已启用跳过轮次工具](/docs/_fern-img/bdb738dc85ff91107cafa5899aad116420aabe9fe794b648bc1f0751729ba5af.webp)