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

# ターンをスキップ

## 概要

**Skip Turn**ツールを使用すると、会話型エージェントを明示的に一時停止し、続行する前にユーザーが発話または操作するのを待機できます。このシステムツールは、たとえば「少し待って」「考えさせて」「少々お待ちください」のように、ユーザーが少し時間が必要だと伝えた場合に便利です。

## 機能

* **ユーザー主導の一時停止**：LLMが、ユーザーに中断されない短い休止が必要だと検出したときに呼び出すよう設計されています。
* **音声応答なし**：このツールが呼び出された後、アシスタントは発話しません。ユーザーが再び会話に参加するか、別のターン取得条件が満たされるのを待ちます。
* **自然な会話の流れ**：インタラクションを終了したり、エージェントが不必要に発話したりすることなく、ユーザーが短い休憩を必要としていることを尊重し、自然な会話のリズムを維持します。

**目的**：エージェントが話さずに一時停止し、ユーザー入力を待機できるようにします。

**トリガー条件**：LLMは次の場合にこのツールを呼び出す必要があります。

* ユーザーが少し時間が必要だと示した場合（「少し待って」、「考えさせて」）
* ユーザーが会話の流れを一時停止するよう求めた場合
* エージェントが、ユーザーが情報を処理する時間を必要としていると検出した場合

**パラメーター**：

* `reason`（文字列、任意）：一時停止が必要な理由を説明する自由形式のテキスト

**関数呼び出し形式**：

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

**実装**：追加設定は不要です。このツールは、ユーザーが再び話すまでエージェントが沈黙を保つよう通知するだけです。

### API実装

APIでエージェントを作成する際は、エージェント設定にSkip Turnツールを追加できます。名前を`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設定

Skip Turnツールは、エージェントUIのツールセクションから直接設定することもできます。

### ステップ1：新しいツールを追加

エージェントの設定ページに移動します。「Tools」セクションで「Add tool」をクリックすると、`Skip Turn`オプションがすでに表示されています。

![Skip Turnツールの追加オプション](/docs/_fern-img/8b95051da94ada3dae7e42121148ad4509b49413e73bd16351142372ca26a68d.webp)

### ステップ2：ツールを設定

LLMがこのツールをトリガーするタイミングをカスタマイズする説明を任意で追加できます。デフォルトの動作を使用する場合は空白のままにしてください。

![Skip Turnツールを設定](/docs/_fern-img/cbb419db630beb4feefc390ef3f3576f7a6dc2df098faec4fbd2d1d5e703364f.webp)

### ステップ3：ツールを有効化

設定すると、`Skip Turn`ツールがエージェントの有効なツール一覧に表示され、エージェントがターンをスキップできるようになります。.

![Skip Turnツールが有効](/docs/_fern-img/bdb738dc85ff91107cafa5899aad116420aabe9fe794b648bc1f0751729ba5af.webp)