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

# オーディオ環境

## 概要

オーディオ環境では、エージェントの発信オーディオが発信者にどのように聞こえるかを設定できます。次の2つの設定が適用されます。

* **バックグラウンドサウンド**：エージェントの発話にループする環境音を重ねて再生します。
* **音声フィルター**：ミックス前のエージェント音声に、電話風のフィルターを適用します。

発信者には処理後の音声が聞こえます。エージェントにはバックグラウンドサウンドは聞こえず、音声認識にも送信されません。

これは、ツールの実行中にのみ再生される[ツール呼び出しサウンド](/docs/ja/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)とは別の機能です。

## バックグラウンドサウンド

バックグラウンドサウンドは、会話中のエージェントの発話に組み込みプリセットを重ねます。ユーザーが割り込んだ場合もサウンドはループし続け、エージェントのターン終了時に停止することはありません。

プリセットには、オフィス、レストラン、街中、タイピング、エレベーター音楽などがあります。ダッシュボードでは、保存前にプリセットをプレビューできます。

バックグラウンドサウンドは`conversation_config.conversation.background_sound`で設定します。

### 設定

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

#### オーディオ環境を開く

エージェントを開きます。エージェントページで、**Voices**の横にある**オーディオ環境**
ボタンをクリックします。

#### バックグラウンドサウンドを有効にする

**バックグラウンドサウンドを有効化**をオンにします。**バックグラウンドサウンド**からプリセットを選択します。ドロップダウンの横にある再生
コントロールでプレビューできます。

#### 音量とループを設定する

**音量**を設定します。サウンドの繰り返し時にクリック音が聞こえないよう、**クロスフェードループ**は有効のままにします。変更を
保存します。

#### CLIで更新

#### エージェント設定を取得する

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

#### \`agent_configs/\<agent-name>.json\`を編集する

`conversation_config.conversation.background_sound`を設定します。有効な`source_id`の値は
`office1`、`office2`、`restaurant`、`city`、`typing`、および`elevator1`から`elevator4`です。

```json
{
  "conversation_config": {
    "conversation": {
      "background_sound": {
        "source_type": "preset",
        "source_id": "office2",
        "volume": 0.15,
        "crossfade_loop": true
      }
    }
  }
}
```

バックグラウンドサウンドを無効にするには、`source_type`と`source_id`を`null`に設定します。
`background_sound`を省略したり、オブジェクトを`null`に設定したりしないでください。更新すると既存の設定が維持されます。

#### エージェント設定をプッシュする

```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": {
            "background_sound": {
                "source_type": "preset",
                "source_id": "office2",
                "volume": 0.15,
                "crossfade_loop": True,
            }
        }
    },
)
```

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

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    conversation: {
      backgroundSound: {
        sourceType: "preset",
        sourceId: "office2",
        volume: 0.15,
        crossfadeLoop: true,
      },
    },
  },
});
```

無効にするには、`source_type`と`source_id`を`null`に設定します。更新時に`background_sound`を
省略しても無効にはなりません。

> **Warning**
>
> WebSocket接続の品質が非常に低い場合、バックグラウンドサウンドのミックスによってオーディオが途切れることがあります。

### パラメーター

有効な`source_id`の値は`office1`、`office2`、`restaurant`、`city`、`typing`、および`elevator1`から`elevator4`です。

| フィールド            | 型       | デフォルト  | 説明                                                    |
| ---------------- | ------- | ------ | ----------------------------------------------------- |
| `source_type`    | string  | 未設定    | サウンドを有効にする場合は`preset`にする必要があります。`source_id`と一緒に設定します。 |
| `source_id`      | string  | 未設定    | 組み込みプリセットの識別子です。                                      |
| `volume`         | number  | `0.15` | エージェントの発話に対するレベルです。範囲は`0.01`～`1.0`です。                 |
| `crossfade_loop` | boolean | `true` | ループ境界でクロスフェードし、繰り返し時のクリック音を防ぎます。                      |

## 音声フィルター

音声フィルターは、エージェントが生成した音声を加工します。バックグラウンドサウンドのイコライジングやノイズ除去は行いません。フィルターが先に実行され、その後フィルター済みの音声にバックグラウンドサウンドが重ねられます。

音声フィルターは`conversation_config.tts.audio_effects.filter_preset_id`で設定します。ダッシュボードでは電話プリセットを選択できます。CLIまたはAPIでは、[オーディオエフェクトカタログ](/docs/ja/api-reference/audio-effects/get-catalog)に掲載されている任意のフィルタープリセットを設定できます。

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

同じ**オーディオ環境**パネルで、**音声フィルター**を**オフ**または電話プリセットに設定してから、
保存します。

#### CLIで更新

`agent_configs/<agent-name>.json`で`conversation_config.tts.audio_effects`を設定し、エージェント設定を
プッシュします。

```json
{
  "conversation_config": {
    "tts": {
      "audio_effects": {
        "filter_preset_id": "phone"
      }
    }
  }
}
```

フィルターを削除するには、`filter_preset_id`を`null`に設定します。

#### APIで更新

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "tts": {
            "audio_effects": {
                "filter_preset_id": "phone",
            }
        }
    },
)
```

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

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    tts: {
      audioEffects: {
        filterPresetId: "phone",
      },
    },
  },
});
```

フィルターを削除するには、`filter_preset_id`を`null`に設定します。

> **Note**
>
> エージェントのオーディオはモノラルです。`pan`はエージェントには影響せず、`environment_id`によるリバーブは
> モノラルにミックスダウンされます。

## 制限事項

* 組み込みプリセットのみ利用できます。カスタムファイルのアップロードや任意のURLの指定はできません。
* エージェントが**テキストのみ**の場合、オーディオ環境のコントロールは表示されません。
* バックグラウンドサウンドは、[WhatsApp](/docs/ja/eleven-agents/whatsapp)のボイスメッセージ返信にはミックスされません。WhatsApp通話には引き続き含まれます。
* バックグラウンドサウンドは、クライアントの[オーバーライド](/docs/ja/eleven-agents/customization/personalization/overrides)で会話ごとに設定できません。`conversation_config_override`には`background_sound`が含まれません。 [ワークフロー](/docs/ja/eleven-agents/customization/agent-workflows)ノードでは変更できます。

## 関連項目

#### [ツール呼び出しサウンド](/docs/ja/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)

ツールの実行中にのみ環境音を再生します。

#### [音声のカスタマイズ](/docs/ja/eleven-agents/customization/voice)

エージェントの音声、速度、その他の発話設定を選択します。