> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/voice-agent.md).

# 音声アシスタント（Voice Agent）

Agent が「聞く」「話す」ことで顧客に対応できるようにし、リアルタイムの会話、STT/LLM/TTS パイプライン、割り込み制御をサポートします

## どのような機能ですか？ <a href="#what-is-this" id="what-is-this"></a>

音声アシスタントは、Agent との**音声**によるやり取りを可能にします。ユーザーが話しかけると、AI も音声で応答します。リアルタイム音声モデル、STT（音声からテキストへの変換）、TTS（テキストから音声への変換）、割り込み制御を統合しており、電話でのカスタマーサポート、IVR、音声アシスタントなどに利用できます。

有効にすると、MaiGPT、Agent マーケットプレイス、Web Chat の入力欄に「音声対話モード」を開始するボタンが表示されます。クリックするだけで話し始められます。操作方法は[ユーザーの利用方法](#how-users-talk)をご覧ください。

## 3 つの対話モード <a href="#interaction-modes" id="interaction-modes"></a>

各モードの用途は、遅延、音声のカスタマイズの柔軟性、ツールのサポート範囲によって異なります。

| モード                    | 仕組み                                        | 適した用途                                      |
| ---------------------- | ------------------------------------------ | ------------------------------------------ |
| **リアルタイム対話（Realtime）** | 音声モデルを直接使用してリアルタイムに音声で会話します                | 遅延を最小限に抑える必要があり、既定の音声を利用できる場合に適しています       |
| **リアルタイム対話 + TTS**     | リアルタイム音声モデルとカスタム TTS 出力を組み合わせます            | ブランド独自の音声が必要で、リアルタイムの応答性も維持したい場合に適しています    |
| **STT + LLM + TTS**    | 音声をテキストに変換 → LLM → テキストを音声に変換する従来のパイプラインです | ツールを全面的に利用し、多少の遅延を許容して最大限の柔軟性を求める場合に適しています |

**選び方の目安**：速さと自然さを最優先する場合は Realtime、ブランド独自の音声が必要な場合は Realtime + TTS、柔軟性とツールのサポートを重視する場合は STT + LLM + TTS を選びます。

## 音声アシスタント設定の入力方法 <a href="#voice-settings-walkthrough" id="voice-settings-walkthrough"></a>

<mark style="color:blue;">音声アシスタント設定</mark>は、Agent 設定ページの<mark style="color:blue;">回答モード設定</mark>タブで、ロール指示の後に表示されます（組織で AI 音声アシスタントが利用可能になっている場合のみ表示されます）。最上部に「<mark style="color:blue;">音声アシスタントを有効にする</mark>」全体スイッチがあります。オフにすると設定全体が折りたたまれ、Web Chat、電話、管理画面の音声機能から、この Agent の音声サービスを利用できなくなります。オンにしたら、次の 3 つのセクションを順番に設定します。各セクションを折りたたむと、現在の設定の概要が右側に表示されます。

### 1. 音声技術 <a href="#voice-settings-tech" id="voice-settings-tech"></a>

まず「<mark style="color:blue;">音声アシスタントモード</mark>」でモードのカードをクリックします（もう一度クリックすると選択を解除できます）。次に、そのモードに応じてプロバイダーを選び、構成を入力します。

| モード                 | 選択するプロバイダー                                                                                                | 構成フィールド                                                                             |
| ------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| リアルタイム対話 (Realtime) | <mark style="color:blue;">リアルタイム音声プロバイダー</mark>                                                           | <mark style="color:blue;">リアルタイム音声構成</mark>                                         |
| リアルタイム対話 + TTS      | <mark style="color:blue;">リアルタイム音声プロバイダー</mark>、<mark style="color:blue;">テキスト読み上げ (TTS) プロバイダー</mark>    | <mark style="color:blue;">リアルタイム音声構成</mark>、<mark style="color:blue;">TTS 構成</mark> |
| STT + LLM + TTS     | <mark style="color:blue;">音声認識 (STT) プロバイダー</mark>、<mark style="color:blue;">テキスト読み上げ (TTS) プロバイダー</mark> | <mark style="color:blue;">STT 構成</mark>、<mark style="color:blue;">TTS 構成</mark>     |

各プロバイダーの下には、左右に並んだ構成フィールドがあります。左側の「<mark style="color:blue;">構成例</mark>」は読み取り専用で、右側には実際に適用される JSON 構成を入力します。

* 現在サポートしているプロバイダーは、STT が OpenAI、Azure、Bronci（台湾語／中国語／客家語）、TTS が OpenAI、Azure、VoAI、Bronci、リアルタイム音声が OpenAI Realtime、Google Gemini Live です。一覧には組織で利用可能なプロバイダーだけが表示されます。空の場合は「利用可能なプロバイダーがありません」と表示されるため、MaiAgent に利用開始をご依頼ください。
* プロバイダーを選ぶと、その構成例が右側のフィールドに自動入力されます。通常はそのまま保存できます。音声、言語、文字起こしモデルなどを調整する場合は JSON を編集します。構成例の下にある「<mark style="color:blue;">構成の説明</mark>」の表には、各パラメーターの型、既定値、選択可能な値、説明が記載されています。[ユーザーの文字起こし設定](#user-transcript-settings)などを入力する際に参照してください。
* 構成は有効な JSON である必要があります。無効な場合は「構成の形式が正しくありません。有効な JSON を入力してください」と表示され、保存時にも該当セクションが展開されるため、修正してください。空のまま保存しようとすると「構成が空です。保存後は既定の構成が自動的に適用されます」と表示され、確認すると既定の構成で保存されます。

#### リアルタイム音声モデルの選び方 <a href="#realtime-model-choice" id="realtime-model-choice"></a>

「<mark style="color:blue;">リアルタイム音声プロバイダー</mark>」の選択肢は、「モデル名 (プロバイダー)」の形式で表示されます。例として `gemini-3.8-live (Google Gemini Live)`、`gpt-realtime-2.1 (OpenAI Realtime)` があります。Google Gemini Live では現在、次の 2 つのモデルを選べます。

| モデル                                  | 説明                                                                                                                                                                                                           |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `gemini-3.8-live`                    | メニューの先頭に表示される、`gemini-live-2.5-flash-native-audio` の後継モデルです。2.5 と同様に「<mark style="color:blue;">リアルタイム対話 (Realtime)</mark>」モードでのみ利用でき、「<mark style="color:blue;">音声応答を有効にする</mark>」をオンにする必要があります。下記の注意をご覧ください |
| `gemini-live-2.5-flash-native-audio` | 既存のモデルです。すでに選択している Agent は通常どおり通話できます。Google はこのモデルの提供終了を発表しています（Vertex AI では 2026 年 12 月 13 日を予定）。現在、選択済みの Agent が自動で 3.8 に切り替わることはないため、提供終了前に手動で変更することをおすすめします                                             |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a42c8ce063bb87b4f3fe44032e10ff60693090a4%2Fvoice-agent-realtime-model-options.png?alt=media" alt="リアルタイム音声プロバイダーのドロップダウンです。先頭に gemini-3.8-live (Google Gemini Live)、その下に gemini-live-2.5-flash-native-audio と複数の OpenAI Realtime モデルが表示されています"><figcaption><p>「リアルタイム音声プロバイダー」メニューでは gemini-3.8-live が先頭に表示され、2.5 も引き続き選択できます</p></figcaption></figure>

たとえば、カスタマーサポート責任者が、これまで `gemini-live-2.5-flash-native-audio` で電話を受けていた電話対応 Agent を、2.5 の提供終了前に 3.8 へ切り替える場合は、次のように操作します。

1. Agent 設定ページの<mark style="color:blue;">回答モード設定</mark> → <mark style="color:blue;">音声アシスタント設定</mark>で「<mark style="color:blue;">音声技術</mark>」を展開し、「<mark style="color:blue;">音声アシスタントモード</mark>」が「<mark style="color:blue;">リアルタイム対話 (Realtime)</mark>」になっていることを確認します。
2. 「<mark style="color:blue;">リアルタイム音声プロバイダー</mark>」を `gemini-3.8-live (Google Gemini Live)` に変更します。右側の「<mark style="color:blue;">リアルタイム音声構成</mark>」が 3.8 の構成例に置き換わるため、以前変更したパラメーター（音声の `voice` など）は再入力してください。
3. 右下の<mark style="color:blue;">保存</mark>をクリックし、音声対話モードを開いて話しかけます。応答が聞こえることと、対話履歴の双方にテキストが表示されることを確認します。

切り替える前に、2 つのモデルの料金を比較することもできます。リアルタイム音声通話は、選択したモデルの音声・テキストの入力と出力の使用量に応じて Credits を消費します。3.8 と 2.5 では料金が異なります。<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">Credits</mark> → <mark style="color:blue;">課金方式</mark>で「<mark style="color:blue;">音声認識・音声合成技術</mark>」を展開し、「<mark style="color:blue;">リアルタイム音声出力（テキスト）</mark>」などの項目を開くと、モデルごとの料金を確認できます。詳しくは [Credits の課金制度](/maiagent-user-guide/ja/others/credits.md)をご覧ください。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9ae7ffbeec5a5f85b52ac38f8038ff89462f3a78%2Fvoice-agent-gemini-live-text-output-pricing.png?alt=media" alt="課金方式のリアルタイム音声出力（テキスト）を展開すると、gemini-3.8-live と gemini-live-2.5-flash-native-audio の 1,000 Tokens あたりの料金がそれぞれ表示されます"><figcaption><p>「リアルタイム音声出力（テキスト）」を展開すると、3.8 と 2.5 の料金を個別に確認できます</p></figcaption></figure>

{% hint style="info" %}
`gemini-3.8-live` は回答前に思考します。この思考の使用量は「<mark style="color:blue;">リアルタイム音声出力（テキスト）</mark>」に含まれ、3.8 のテキスト出力料金に従って Credits が差し引かれます。`gemini-live-2.5-flash-native-audio` には思考の使用量がなく、課金方式は変わりません。3.8 へ切り替えた後の費用を見積もる際は、この使用量も含めてください。
{% endhint %}

{% hint style="warning" %}

* **Gemini Live の 2 つのモデルは音声でのみ回答できます**：`gemini-3.8-live` と `gemini-live-2.5-flash-native-audio` は音声のみを出力し、テキストを出力できません。そのため、**リアルタイム対話 (Realtime)** モードでのみ利用でき、「<mark style="color:blue;">音声応答を有効にする</mark>」をオンにする必要があります。次の設定では音声モデルにテキスト出力が必要となるため、Gemini Live が接続を拒否し、通話中に Agent が応答しません。

  * 音声アシスタントモードを「<mark style="color:blue;">リアルタイム対話 + TTS</mark>」にする場合（音声モデルがテキストを出力し、TTS が読み上げます）。
  * [対話動作](#voice-settings-behavior)の「<mark style="color:blue;">音声応答を有効にする</mark>」をオフにする場合（テキストのみで応答します）。
  * 通話に使用する対話プラットフォームで [AI Copilot](/maiagent-user-guide/ja/serve/copilot.md#trigger-modes) を有効にし、トリガーモードを「<mark style="color:blue;">受信したすべてのメッセージ</mark>」にする場合（応答を直接再生せず、担当者が送信を判断します）。

  これらの組み合わせは保存時に拒否されないため、設定前に確認してください。上記の使い方が必要な場合は、リアルタイム音声で OpenAI Realtime のモデルを選択するか、「<mark style="color:blue;">STT + LLM + TTS</mark>」モードに変更してください。
* OpenAI が提供を終了した `gpt-realtime` はメニューに表示されなくなりました。すでに選択している Agent は通常どおり通話・課金されますが、ほかのモデルに変更して保存すると、元のモデルを再選択できません。
  {% endhint %}

### 2. リアルタイム音声プロンプト <a href="#voice-settings-prompt" id="voice-settings-prompt"></a>

「<mark style="color:blue;">リアルタイム音声プロンプト</mark>」は、音声モデル専用のプロンプトです。空欄の場合はロール指示を使用します。フィールド上部には、「音声モード × 回答モード × 入力の有無」に応じて、現在どの設定が適用されているかが表示されます。

| 画面の表示                      | 表示される条件                               | 意味                                                                                       |
| -------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------- |
| このモードは音声プロンプトに対応していません     | STT + LLM + TTS                       | このモードでは常にロール指示を使用し、フィールドは編集できません。音声専用のプロンプトが必要な場合は Realtime または Realtime + TTS を使用してください |
| 現在の適用内容：ロール指示を使用           | Realtime 系 × RAG 質疑応答 × 空欄            | 音声モデルがロール指示を直接使用して回答します                                                                  |
| 現在の適用内容：このプロンプトでロール指示を置き換え | Realtime 系 × RAG 質疑応答 × 入力済み          | RAG 質疑応答ではナレッジベースが検索結果の抜粋のみを返し、音声モデルがこのプロンプトに基づいて回答を生成します。**ロール指示は一切適用されません**            |
| 現在の適用内容：音声レイヤーでロール指示を使用    | Realtime 系 × Agent などのほかの回答モード × 空欄   | 音声は質問をテキスト応答フローに委譲し、回答は引き続きロール指示とツールによって決まります                                            |
| 現在の適用内容：音声対話レイヤーのみに影響      | Realtime 系 × Agent などのほかの回答モード × 入力済み | 回答内容は変わりません。このプロンプトは音声モデルの話し方（トーン、口調、間）のみを調整します                                          |

RAG 質疑応答モードでロール指示を基に微調整したい場合は、「<mark style="color:blue;">ロール指示をベースとして取り込む</mark>」をクリックしてフィールドにコピーしてから編集します。すでに内容がある場合は、先に「音声プロンプトを上書き」の確認が表示されます。

### 3. 対話動作 <a href="#voice-settings-behavior" id="voice-settings-behavior"></a>

* 「<mark style="color:blue;">音声応答を有効にする</mark>」：オフにすると、音声を再生せずテキストのみで応答します。音声入力だけを使いたい場合に適しています。
* 「<mark style="color:blue;">割り込み制御設定</mark>」：音声アシスタントの応答中にユーザーが割り込めるようにします。有効にすると、<mark style="color:blue;">最短発話時間（秒）</mark>と<mark style="color:blue;">最小単語数</mark>を調整できます。この 2 つのフィールドは STT + LLM + TTS モードでのみ適用され、ほかのモードでは注意が表示され、編集できなくなります。[割り込み制御](#turn-handling)をご覧ください。

セクションの最下部の「<mark style="color:blue;">利用上の注意</mark>」には、音声アシスタントは関連付けられたすべてのナレッジベースを検索し、検索対象のファイルを指定できない旨が表示されます。設定が完了したら、右下の<mark style="color:blue;">保存</mark>をクリックします。

## 割り込み制御（Turn Handling） <a href="#turn-handling" id="turn-handling"></a>

音声対話では、AI が話している途中にユーザーが割り込めるかどうかが重要です。また、ユーザーの実際の発話と、雑音や相づちを区別する必要があります。

調整できるパラメーターは次のとおりです。

| パラメーター        | 説明                                         |
| ------------- | ------------------------------------------ |
| **最短発話時間（秒）** | 割り込みとして扱うために、ユーザーが最低何秒話し続ける必要があるかを指定します    |
| **最小単語数**     | 割り込みを起こすために、ユーザーが最低いくつの単語を発話する必要があるかを指定します |

> **注意**：`min_duration` と `min_words` は **STT + LLM + TTS** モードでのみ有効です。Realtime モードでは音声モデル内部で割り込みを判定します。

## ユーザーの文字起こし設定（Realtime モード） <a href="#user-transcript-settings" id="user-transcript-settings"></a>

Realtime と Realtime + TTS モードでは、音声モデルがユーザーの音声を直接聞き取ります。ユーザーが話した内容のテキスト記録（ユーザーの文字起こし）は、別の文字起こしモデルが生成します。<mark style="color:blue;">リアルタイム音声プロバイダー</mark>で OpenAI を選択した場合、<mark style="color:blue;">リアルタイム音声構成</mark>の JSON にある `input_audio_transcription` で文字起こしの方法を指定できます。

```json
{
  "input_audio_transcription": {
    "model": "gpt-4o-mini-transcribe",
    "language": "zh",
    "prompt": "繁体字中国語で出力してください。よく使う用語：MaiAgent、保険契約、保険金請求"
  }
}
```

| フィールド      | 説明                                                                                                                                             |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`    | 文字起こしモデルです。`gpt-4o-transcribe`、`gpt-4o-mini-transcribe`、`gpt-transcribe`、`gpt-live-transcribe` を指定できます。未指定の場合は `gpt-4o-mini-transcribe` を使用します |
| `language` | 言語のヒントとして ISO-639-1 コード（`zh`、`en`、`ja` など）を入力します。空欄の場合はモデルが自動検出します                                                                             |
| `prompt`   | 文字起こしモデルへのヒントです。登場が想定される専門用語や、繁体字中国語で出力する指示などを指定します                                                                                            |

設定ページでは、構成フィールドの下に各フィールドの型、既定値、選択可能な値が表示されるため、参照しながら入力できます。

* **文字起こしのみに影響します**：この設定は、通話記録のユーザー側のテキストを決定します。音声モデルが聞き取る内容や回答は変わりません。
* **多言語での通話**：ユーザーが複数の言語を混ぜて話す場合は、`language` を空欄にしてモデルに自動検出させます。単一の言語に固定する場合は、コードを入力すると認識が安定します。
* **課金**：ユーザーの文字起こしは、実際に使用した文字起こしモデルの音声認識時間（秒数）に応じて Credits に計上されます。モデルごとの単価は、<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">Credits</mark> → <mark style="color:blue;">課金方式</mark>で確認できます。詳しくは [Credits の課金制度](/maiagent-user-guide/ja/others/credits.md)をご覧ください。

## 対話の状態 <a href="#conversation-states" id="conversation-states"></a>

音声対話中は、画面に現在の状態が表示されます。

* **聞き取り中**：AI がユーザーの音声を受信しています
* **思考中**：AI が処理しています（ナレッジベースの検索、ツールの使用、応答の生成）
* **応答中**：AI が音声で応答しています
* **初期化中**：接続直後の準備を行っています

## ユーザーの利用方法 <a href="#how-users-talk" id="how-users-talk"></a>

Agent で音声アシスタントを有効にすると、ユーザーは設定なしで、通常のテキスト対話画面から音声に切り替えられます。

| 利用場所                                                                                                | 開始方法                                                                                                                                                                                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 管理画面の<mark style="color:blue;">MaiGPT</mark>、<mark style="color:blue;">Agent マーケットプレイス</mark>の対話ページ | 入力欄の右側に<mark style="color:blue;">音声対話モード</mark>ボタンが表示されます。組織で AI 音声アシスタントが利用可能で、現在の Agent で音声アシスタントが有効になっている必要があります                                                                                                                                                                                                       |
| Web サイト上の Web Chat                                                                                  | 入力欄の横にある<mark style="color:blue;">ヘッドホン</mark>アイコンをクリックします（[音声入力](/maiagent-user-guide/ja/build/choose-channel/web-chat.md#voice-input-and-playback)のマイクアイコンとは異なります。マイクは 1 回の発話をテキストに変換して送信し、ヘッドホンはリアルタイム通話を開始します）                                                                                                        |
| 独立した音声対話ページ                                                                                         | 対話プラットフォームの<mark style="color:blue;">公開アクセス URL</mark>の横に<mark style="color:blue;">音声モード</mark>リンクがあります（[基本設定](/maiagent-user-guide/ja/build/conversation-settings/platform-settings/basic-settings.md#public-url-and-embed)をご覧ください）。開くと通話専用ページが表示されます。<mark style="color:blue;">対話を開始</mark>をクリックすると、「発信中」と表示された後に接続されます |

### 音声対話モードのウィンドウ <a href="#voice-mode-window" id="voice-mode-window"></a>

ボタンをクリックすると、初回はブラウザーがマイクへのアクセス許可を求めます。ボタンに「接続中...」と表示された後、<mark style="color:blue;">音声対話モード</mark>のウィンドウが開きます。

| セクション                                                                           | 説明                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">利用上の注意</mark>                                         | Realtime と Realtime + TTS モードは MCP ツールのみをサポートすること、音声アシスタントは関連付けられたすべてのナレッジベースを検索することを案内します（[利用上の制限](#limitations)をご覧ください）                                                                                                                               |
| <mark style="color:blue;">接続状態</mark>                                           | 未接続 → 接続中... → 接続済みと変わります。失敗すると「接続に失敗しました」と表示されます                                                                                                                                                                                                       |
| 現在の状態                                                                           | <mark style="color:blue;">初期化中</mark>／<mark style="color:blue;">聞き取り中</mark>／<mark style="color:blue;">思考中</mark>／<mark style="color:blue;">応答中</mark>が表示されます。意味は[対話の状態](#conversation-states)をご覧ください。Agent がほかの Agent に委譲しているときは「サブエージェントが応答中…」と表示されます |
| <mark style="color:blue;">対話履歴</mark>                                           | 今回の通話のリアルタイムのテキスト記録です。接続前は「対話の開始を待っています...」と表示されます                                                                                                                                                                                                      |
| <mark style="color:blue;">マイクをオフ</mark>／<mark style="color:blue;">マイクをオン</mark> | 一時的にミュートしたり、解除したりできます。録音中は「録音中」と表示されます                                                                                                                                                                                                                  |
| <mark style="color:blue;">通話を終了</mark>                                          | 接続を切断してウィンドウを閉じます。通話内容は元の対話にテキストとして残るため、そのまま文字入力で続けられます                                                                                                                                                                                                 |

### よく表示されるメッセージ <a href="#voice-mode-messages" id="voice-mode-messages"></a>

| 画面の表示                                            | 対処方法                                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------------------ |
| 「マイクへのアクセスが拒否されました」「音声機能を使うにはマイクへのアクセスを許可してください」 | ブラウザーのアドレスバー左側にあるサイトの権限でマイクを許可し、もう一度クリックしてください                                 |
| 「マイクが見つかりません」                                    | マイクまたはヘッドセットが接続され、システムのサウンド設定で選択されていることを確認してください                               |
| 「アシスタントへの接続がタイムアウトしました。しばらくしてから再試行してください」        | 音声サービスに一時的に接続できていません。数秒待ってから再試行してください。続く場合は、管理者に Agent の音声プロバイダー設定の確認を依頼してください |
| 「音声対話モードを開始できません」                                | システムが一時的に音声接続を確立できません。しばらくしてから再試行してください。続く場合は管理者にお問い合わせください                    |

## 通常のテキスト対話との違いは何ですか？ <a href="#voice-vs-text" id="voice-vs-text"></a>

|           | テキストアシスタント                 | 音声アシスタント                        |
| --------- | -------------------------- | ------------------------------- |
| **入力**    | キーボード入力、ファイルの添付です          | マイクからの音声です。DTMF キー入力を使う場合もあります  |
| **出力**    | テキスト、Markdown、画像、ファイルです    | 音声で応答し、最後に文字起こしが付きます            |
| **遅延の要件** | 秒単位の遅延を許容できます              | 自然な会話にはミリ秒単位の遅延が必要です            |
| **適した用途** | 詳細な情報が必要な場合や、記録を後から見返す場合です | すぐに応答が必要な場合、手が離せない場合、電話での顧客対応です |

## 適した用途 <a href="#when-to-use" id="when-to-use"></a>

* **電話でのカスタマーサポート**：従来の IVR に代わり、AI が直接電話を受け、質問を聞いて回答します
* **音声照会システム**：顧客が電話で注文、残高、保険契約を確認できます
* **音声 FAQ**：よくある質問を音声で直接尋ねられます
* **運転中／手が離せない場面**：文字入力ができないユーザーが AI の支援を受けられます
* **アクセシビリティへの対応**：文字入力が難しいユーザーも利用しやすくなります

## 利用上の制限 <a href="#limitations" id="limitations"></a>

* **ツールのサポート**：現在、**Realtime** と **Realtime + TTS** モードで利用できるのは **MCP ツール**のみです。API ツールを使う場合は STT + LLM + TTS モードに変更してください
* **ナレッジベースの検索**：音声アシスタントは関連付けられたすべてのナレッジベースを検索します。**特定の文書だけに検索対象を限定することはできません**
* **Gemini Live モデル**：`gemini-3.8-live` と `gemini-live-2.5-flash-native-audio` は **Realtime** モードでのみ利用でき、「<mark style="color:blue;">音声応答を有効にする</mark>」をオンにする必要があります。Realtime + TTS との組み合わせ、音声応答の無効化（テキストのみの応答）、トリガーモードが「受信したすべてのメッセージ」の AI Copilot 対話プラットフォームでは、通話中に正常に応答できません。[リアルタイム音声モデルの選び方](#realtime-model-choice)をご覧ください
* **マイクの権限**：対話を始めるには、ユーザーがブラウザーによるマイクの使用を許可する必要があります

## 何をすればよいですか？ <a href="#what-do-i-need-to-do" id="what-do-i-need-to-do"></a>

1. **Agent 設定を開きます** — 音声を有効にする Agent の設定ページで<mark style="color:blue;">回答モード設定</mark>に切り替え、<mark style="color:blue;">音声アシスタント設定</mark>を見つけて<mark style="color:blue;">音声アシスタントを有効にする</mark>をオンにします。このセクションは、組織で AI 音声アシスタントが利用可能な場合にのみ表示されます
2. **音声アシスタントモードを選びます** — Realtime / Realtime + TTS / STT + LLM + TTS のいずれかを選択します
3. **プロバイダーと構成を設定します** — モードに応じた STT / TTS / Realtime プロバイダーを選びます。選択すると構成例が自動入力されます。[音声技術](#voice-settings-tech)をご覧ください
4. **音声プロンプトを設定します**（任意）— 空欄にしてロール指示を使用するか、[リアルタイム音声プロンプト](#voice-settings-prompt)の表を参考に入力します
5. **対話動作を調整します**（任意）— 音声応答を再生するか、割り込みを許可するかを設定します。STT + LLM + TTS モードでは最短発話時間と最小単語数も調整できます
6. **テストします** — 画面から音声通話を開始し、接続、聞き取り、応答がすべてスムーズに動作することを確認します

## 関連ドキュメント <a href="#further-reading" id="further-reading"></a>

* [音声カスタマーサポート：導入から運用開始まで](/maiagent-user-guide/ja/serve/voice.md)
* [電話カスタマーサポート（コールセンター）](/maiagent-user-guide/ja/build/choose-channel/call-center.md)
* [音声カスタマーサポートのシナリオ一覧](/maiagent-user-guide/ja/serve/voicecs.md)
* [IVR による問い合わせ意図の識別](/maiagent-user-guide/ja/serve/voicecs/ivr-intent-recognition.md)
* [音声通話の要約](/maiagent-user-guide/ja/serve/voicecs/call-summary.md)
* [音声通話の品質評価](/maiagent-user-guide/ja/serve/voicecs/call-qa.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/voice-agent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.