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

# ツール呼び出し音

## 概要

ツール呼び出し音は、ツールの実行中に環境音によるフィードバックを提供し、より自然で魅力的な会話体験を実現します。エージェントがAPIからのデータ取得やリクエストの処理などのツールを実行する際、これらの音は無音の時間を埋め、エージェントが処理中であることをユーザーに伝えます。

ElevenLabsエージェントは複数の組み込み環境音をサポートしており、ツールレベルと統合レベルの両方で設定できます。これにより、会話中にいつ、どのように音を再生するかを細かく制御できます。

> **Note**
>
> ツール呼び出し音は、ツールの実行中にのみ再生されます。継続的なバックグラウンド音については、[オーディオ 環境](/docs/ja/eleven-agents/customization/voice/audio-environment)を参照してください。

## ユースケース

ツール呼び出し音は、次のようなシナリオで特に効果的です。

* **API呼び出しの完了に時間がかかる場合**：外部サービスからデータを取得している間、環境音楽やタイピング音を再生します
* **長時間実行される処理**：データベースクエリ、複雑な計算、サードパーティ統合の実行中にオーディオフィードバックを提供します
* **自然な会話フロー**：会話の間を埋め、不自然な沈黙を防ぎます
* **ユーザーの期待**：技術的な問題ではなく、エージェントがリクエストを処理していることをユーザーに知らせます

> **Info**
>
> ツール呼び出し音は任意です。ツール実行時に音を流したくない場合は、ツール呼び出し音の設定を
> 「なし」のままにしてください。

## 利用可能な音

ElevenLabsでは、以下の環境音オプションを提供しています。

| 音の種類        | 説明             | 最適な用途            |
| ----------- | -------------- | ---------------- |
| なし          | ツール実行中は音を再生しない | 短時間の処理、無音のワークフロー |
| タイピング       | キーボードのタイピング音   | 検索クエリ、テキスト処理     |
| エレベーター音楽1～4 | 軽快なバックグラウンド音楽  | 長い待ち時間、一般的な用途    |

> **Tip**
>
> ツール呼び出し音を設定する際、ダッシュボードのドロップダウン横にある再生ボタンをクリックすると、各音をプレビューできます。

## 設定

ツール呼び出し音は2か所で設定でき、ツールレベルの設定が優先されます。

### ツールレベルの設定

エージェントのツール設定で、個々のツールの音を設定します。

#### ダッシュボードで更新

#### ツール設定へ移動

エージェント設定の**エージェント**セクションで、設定するツールを選択するか、新しいツールを作成します。

#### ツール呼び出し音を設定

ツール設定の下部にある**ツール呼び出し音**セクションまでスクロールします。

![ツール呼び出し音のドロップダウン](/docs/_fern-img/093fd6c380e2d51f0b8dbe152377a35e1e4e0e422638519910016b9f1551233d.webp)

ドロップダウンメニューから音を選択します。

* **なし**：音は再生されません
* **タイピング**：キーボードのタイピング音
* **エレベーター音楽1～4**：さまざまな環境バックグラウンド音楽

#### 音の動作を設定

音を選択した場合（「なし」以外）、追加の**音の動作**オプションが表示されます。

![音の動作のドロップダウン](/docs/_fern-img/00c7f6ddfb1b0240a900c8d6814c8706e045500d92f6a6c263d4a7c962e24fbe.webp)

音を再生するタイミングを選択します。

* **事前発話あり**：エージェントがツール実行前に発話する場合のみ音を再生します
* **常に再生**：エージェントが先に発話するかどうかに関係なく、ツール実行のたびに音を再生します

#### 設定を保存

**保存**をクリックして、ツール呼び出し音の設定を適用します。

#### CLIで更新

#### ツール設定を取得

```bash
elevenlabs tools pull
```

#### \`tool_configs/\<tool-name>.json\`を編集

`tool_call_sound`と`tool_call_sound_behavior`を設定します。

```json
{
  "type": "webhook",
  "name": "get_weather",
  "tool_call_sound": "typing",
  "tool_call_sound_behavior": "auto"
}
```

**事前発話あり**には`"auto"`、**常に再生**には`"always"`を使用します。

#### 変更をプッシュ

```bash
elevenlabs tools push
```

#### APIで更新

```python
from elevenlabs import ElevenLabs, ToolRequestModel

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.tools.update(
    tool_id="tool_7101k5zvyjhmfg983brhmhkd98n6",
    request=ToolRequestModel(
        tool_config={
            "type": "webhook",
            "name": "get_weather",
            "description": "Gets current weather data",
            "tool_call_sound": "typing",
            "tool_call_sound_behavior": "auto",
            "api_schema": {
                "url": "https://api.weather.com/data",
                "method": "GET",
            },
        },
    )
)
```

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

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.tools.update("tool_7101k5zvyjhmfg983brhmhkd98n6", {
  toolConfig: {
    type: "webhook",
    name: "get_weather",
    description: "Gets current weather data",
    toolCallSound: "typing",
    toolCallSoundBehavior: "auto",
    apiSchema: {
      url: "https://api.weather.com/data",
      method: "GET",
    },
  },
});
```

### 統合レベルの設定

統合（MCPサーバー、API統合など）を通じて作成されたツールでは、統合レベルでデフォルトのツール呼び出し音を設定できます。

#### 統合設定へ移動

**エージェント設定＞統合**に移動し、統合を選択します。

#### デフォルト音を設定

統合の概要画面で、**ツール呼び出し音**の設定を見つけます。

![ツール呼び出し音の統合用ドロップダウン](/docs/_fern-img/9c4c33501c814c3d124d76060853ee6eb8c59c8b4f0cc494d16267e9fe5cf56b.webp)

ツールレベルで上書きされない限り、この統合のすべてのツールに適用されるデフォルト音を選択します。

#### ツールレベルで上書き（任意）

個々のツール設定でツール呼び出し音を設定すると、特定のツールについて統合レベルのデフォルトを上書きできます。

## 音の動作オプション

音の動作設定は、会話中にツール呼び出し音をいつ再生するかを決定します。

### 事前発話あり（自動）

**デフォルトの動作**です。エージェントがツールを使用する前に発話した場合のみ、音が再生されます。

**シナリオ例：**

```
User: "What's the weather in Tokyo?"
Agent: "Let me check that for you..." [typing sound plays while fetching weather data]
Agent: "It's currently 72 degrees and sunny in Tokyo."
```

**使用する場面：**

* エージェントがリクエストを受け付けた後にのみ音を再生したい場合
* ユーザーの発話後に無音になると不自然な、より自然な会話フローにしたい場合
* エージェントの発話直後にツール実行が行われる場合

### 常に再生

エージェントが事前に発話したかどうかに関係なく、ツールが実行されるたびに音が再生されます。

**シナリオ例：**

```
User: "Check my order status"
[typing sound plays immediately while fetching order data]
Agent: "Your order #12345 shipped yesterday and will arrive tomorrow."
```

**使用する場面：**

* 常に待ち時間が目立つ処理の場合
* すべてのツール呼び出しで一貫したオーディオフィードバックを提供したい場合
* エージェントによる確認が不要な場合があるバックグラウンド処理の場合

> **Warning**
>
> 「常に再生」を選択すると、エージェントがツール使用前に発話しない場合でも音が再生されます。そのため、ユーザーの発話が終わった直後に音が再生されることがあり、会話の文脈によっては唐突に感じられる場合があります。

## ベストプラクティス

#### ツールの実行時間に合わせて音を選ぶ

短時間の処理（1秒未満）には、「なし」またはタイピング音の使用を検討してください。長時間の処理（3秒超）には、エレベーター音楽のオプションがより良いユーザー体験を提供します。

#### 確認済みのアクションには「事前発話あり」を使用する

エージェントが実行前にリクエストを明示的に確認する場合は、「事前発話あり」の動作を使用して自然な会話フローを作成します。

**`System prompt`**

```plaintext System prompt
When users request information, first acknowledge their request before using tools.
For example: "Let me check that for you..." then call the appropriate tool.
```

#### 一貫性を保つため統合レベルで設定する

同じ統合のツールが複数ある場合は、統合レベルでツール呼び出し音を設定し、関連するすべてのツールで一貫したオーディオフィードバックを確保してください。

#### 現実的なレイテンシーでテストする

現実的なAPIレイテンシーでツール呼び出し音をテストし、オーディオフィードバックがユーザーの期待に沿っていることを確認してください。次の点を考慮します。

* APIへのネットワークレイテンシー
* APIの処理時間
* ユーザーの地理的な分布

#### 割り込み処理とのバランスを取る

エージェントがユーザーによる割り込みをサポートしている場合、ユーザーが割り込むとツール呼び出し音は自動的に停止します。会話フローでこれを適切に処理できるようにしてください。

## 設定例

### 検索エージェント

**ユースケース**：ナレッジベースまたはデータベースを検索するエージェント

**設定：**

* ツール呼び出し音：**タイピング**
* 音の動作：**事前発話あり**
* システムプロンプトに含める内容：*「ユーザーが質問した場合は、検索ツールを呼び出す前に『検索します』と伝えてください。」*

### カスタマーサービスエージェント

**ユースケース**：注文状況、在庫、または顧客記録を確認するエージェント

**設定：**

* ツール呼び出し音：**エレベーター音楽3**
* 音の動作：**常に再生**
* 理由：処理に2～5秒かかる場合があり、無音よりもバックグラウンド音楽の方が良い体験を提供します

### 複数ステップのワークフロー

**ユースケース**：複数のツール呼び出しを順番に実行するエージェント

**設定：**

* 最初のツール：**タイピング**、**事前発話あり**
* 後続のツール：**エレベーター音楽1**、**常に再生**
* システムプロンプトによる制御：*「まずリクエストを確認し、その後ツールを順番に実行してください。」*

## トラブルシューティング

### 音が再生されない

**考えられる原因：**

1. **事前発話がない**：「事前発話あり」の動作を使用している場合、ツール実行前にエージェントが発話する必要があります。確認を含めるようシステムプロンプトを更新してください。
2. **処理が速い**：ツールが約500ms未満で完了する場合、音が十分に再生されず、気づきにくい可能性があります。

## 関連リソース

* [Webhookツール](/docs/ja/eleven-agents/customization/tools/webhook-tools) - Webhookツールの設定方法
* [クライアントツール](/docs/ja/eleven-agents/customization/tools/client-tools) - クライアント側のツール実行について
* [システムツール](/docs/ja/eleven-agents/customization/tools/system-tools) - 組み込みプラットフォームツールを確認
* [ベストプラクティス](/docs/ja/eleven-api/guides/how-to/websockets/multi-context-web-socket) - 会話型エージェント構築の一般的なベストプラクティス