---
title: "音声エージェント設定リファレンス"
description: "ThunderPhone音声エージェントのすべての設定を解説：階層、音声、言語、確認応答、ツール、発話順序、ボイスメール、同意告知、無音時の処理、テスト、デプロイ。"
---
**音声エージェント**を開き、エージェントを選択して **設定** タブを使用し、
音声、推論、通話の開始、ツールの使用、無音と留守番電話の処理、
発信者への接続方法を制御します。変更は下書きに自動保存されます。本番トラフィックは **デプロイ** を選択するまで変更されません。
このページはダッシュボードの完全なリファレンスです。フィールド名とリクエスト例については、
[Agents API リファレンス](/api-reference/agents)を参照してください。
## プロンプトとアイデンティティ
エージェント名は、ダッシュボード、レポート、通話履歴、クライアントポータル全体でエージェントを識別します。
プロンプトはエージェントの運用スクリプトです。ペルソナ、ビジネス情報、必須の質問、エスカレーションポリシー、通話アクションを定義します。
プロンプトエディターには推定トークン数が表示され、空のプロンプト、未解決のテンプレートプレースホルダー、
エスカレーション経路の不足、非常に長いプロンプトなどの一般的な問題がフラグ表示されます。最初の **推定5,000トークン** は含まれます。より長い
プロンプトには[ブロックベースの追加料金](/ja/guides/pricing)が適用されます。
転送、キーパッド操作、保留時の動作、通話終了の判断は、プロンプトに直接記述できます。エージェントが外部データやアクションを必要とする場合は、API、アプリ、MCP、またはナレッジツールを接続してください。
ルーティングルール、コールド転送、確認付きウォーム転送については、
[通話の転送](/ja/guides/call-transfers)を参照してください。
## モデルティア
{/* rate:tier-table */}
| ティア | 基本料金 | 最適な用途 |
| --- | ---: | --- |
| **Spark** | 2¢/分 | コストを重視する、シンプルな通話。 |
| **Bolt** | 5¢/分 | 高速な応答と、バランスの取れた日常的なワークフロー。 |
| **Storm** | 9¢/分 | 複雑な指示、音声理解、推論。 |
{/* /rate */}
Storm には、次の2つのオプションコントロールがあります。
- **確認応答** — **なし** は完全な応答を準備している間は無音を維持します。
**ティック** は控えめな待機音を再生します。**音声** は短い確認応答を発話し、
**{/* rate:ack */}2¢/分{/* /rate */}の追加料金**が加算されます。音声テキストはメインプロンプトから生成するか、
手動で指定できます。**カスタム確認応答プロンプト**は、選択した Storm モードが音声による確認応答をサポートする場合にのみ表示されます。サポートしない場合、このフィールドは使用できません。
- **追加インテリジェンス** — 複雑な通話向けに深い推論を追加し、
**{/* rate:extra */}3¢/分{/* /rate */}の追加料金**が加算されます。
ビルダーには、ティア、音声と言語のパス、プロンプトの長さ、音声による確認応答、追加インテリジェンス、監視を含む、
エージェントの **総分単価** が継続的に表示されます。
## 音声、バックグラウンド、言語
デプロイ前に音声を選択し、サンプルを再生します。選択ツールでは、選択した音声が**主要言語**に対応していることのみが必要です。**ネイティブ音声に切り替え**を有効にすると、追加言語は同じ性別のネイティブカタログ音声で対応できます。
プレミアムの組み合わせには追加料金が表示されます。カスタム音声は準備が完了すると、同じ選択ツールに表示されます。[音声ライブラリとカスタム音声](/ja/guides/voice-library)を参照してください。
**バックグラウンドトラック**には次の選択肢があります。
- **なし** — 環境音は再生されません。
- **コールセンター** — ダッシュボード内でプレビューできる、コールセンターの環境音。
1つの**主要言語**を設定してから、任意の数の**追加言語**を設定します。
発信者が選択した言語に切り替えると、エージェントは自動的に検出してその言語で応答します。一部の音声と言語の組み合わせには **{/* rate:language */}3¢/分{/* /rate */}** が追加されます。生成された
[対応言語](/ja/guides/supported-languages)カタログを参照してください。
エージェントに**追加言語**がある場合は、**ネイティブ音声に切り替える**を有効にして、
検出された言語に対応するカタログのネイティブ音声を性別に合わせて使用します。
主要言語には設定済みの音声に戻ります。一致するネイティブ音声がない場合は、現在の音声が引き続き使用されます。カスタム音声は切り替わりません。
各言語を **通話** でテストしてから、**デプロイ** を選択してください。
ネイティブ切り替えに個別の追加料金はかかりません。プレミアム言語料金が適用されるかどうかは、選択した言語と音声の組み合わせによって決まります。
## 接続済み機能
**設定**タブには、個別に接続できる4つの機能セクションがあります。
| セクション | 用途 |
| --- | --- |
| **接続済みアプリ** | Google カレンダー、Google スプレッドシート、Slack、HubSpot、Salesforce、または Cal.com で承認された操作。 |
| **API 接続** | 呼び出し可能な関数として記述された独自の HTTP エンドポイント。 |
| **ナレッジ** | 通話中にエージェントが検索できるファイルまたはウェブコンテンツ。 |
| **MCP サーバー** | リモートの Model Context Protocol サーバーから検出され、キャッシュされたツール。 |
接続は下書きの一部となり、デプロイ後に本番通話で利用できるようになります。
まず **接続** または **ナレッジ** でリソースを設定してから、エージェントに接続します。
## 電話とウェブのエンドポイント
**電話番号**では、既存の番号を接続するか、ThunderPhone 番号を取得するか、VoIP 接続を通じて番号をインポートします。1つの番号で、着信と発信に異なるエージェントを使用できます。
**ウェブウィジェット**では、ウィジェットを接続すると、サイト訪問者がサイト上からエージェントと会話できます。ウィジェットの利用可否は、エージェント設定の一部として有効化または無効化することもできます。
## タイムゾーン
電話番号の下にある**タイムゾーン**は、エージェントが「現在」として扱う時刻です。このタイムゾーンに基づいて日付と時刻を案内し、予約可能な時刻を提示し、「今日」と「明日」を判断します。レポート内のこのエージェントの営業時間にも使用されます。
新しいエージェントは、組織のタイムゾーン、または組織に設定がない場合はコンピューターのタイムゾーンで開始します。発信者が別の場所にいる場合は変更してください。エージェントの電話番号が選択したタイムゾーンと異なる場合、ビルダーがその旨を表示し、切り替えを提案します。
タイムゾーンがないエージェント（古いエージェント、または `timezone` を指定せずに API 経由で作成されたエージェント）は、まず通話に使用する番号のタイムゾーン、次にエージェントの番号のタイムゾーン、次に組織のタイムゾーン、最後に米国太平洋時間を使用します。ビルダーは使用されるタイムゾーンを表示し、確認を求めます。番号から判断できない場合（フリーダイヤル番号、または異なるタイムゾーンの番号）は、タイムゾーンの選択を求めます。
1 つのエージェントが複数のタイムゾーンにいる連絡先に対応する場合は、代わりに通話ごとにタイムゾーンを渡してください。[`POST /v1/call`](/api-reference/outbound-calls) の `timezone`、または[設定 webhook のレスポンス](/ja/guides/dynamic-call-config)で指定します。
### エージェントにタイムゾーンがまだない場合
新しいエージェントにはタイムゾーンが必要です。以前のエージェントには、タイムゾーンが設定されていない場合があります。
以前のエージェントにタイムゾーンがない場合、ThunderPhone はまずエージェント自身の設定を使用し、設定がない場合は組織の設定を使用します。次に、エージェントの電話番号から推定されるタイムゾーンを使用します。それでも確定しない場合は、ロサンゼルスにフォールバックします。ビルダーには解決されたタイムゾーンが表示され、確認を求められます。電話番号から確定できない場合は、タイムゾーンを選択します。
## 高度な通話動作
以下のコントロールを使用するには、設定画面の下部にある **詳細設定** を展開します。
### 監視
有効にすると、2つ目のAIモニターが各エージェントターンを指示と照合し、必要に応じて非表示で介入します。監視には **{/* rate:supervision */}毎分4¢{/* /rate */}** が追加され、Boltでは利用できません。
### 接続音
通話が接続された直後、どちらかが話し始める前に短い音を再生します。
### イントロクリップ
着信通話の開始時に録音済みのクリップを再生し、その後に呼び出し音を流すことで、エージェントが応答する前から会社の電話回線のように聞こえるようにします。ビルダーの着信通話および **通話**（ブラウザー）テスト通話で再生されます。発信通話、AI テスト通話、Web ウィジェット通話、Realtime API 通話では再生されません。
- **オフ**（デフォルト）— エージェントがすぐに応答します。
- **録音に関する通知** — 録音された音声で「この通話は品質保証の目的で監視または録音される場合があります。」と案内します。ビルダーでプレビューできます。
- **独自の録音** — 音声ファイル（MP3、WAV、M4A、およびブラウザーで再生できるその他の形式）をアップロードするか、ブラウザーで録音します。クリップの長さは 0.5～15 秒です。ビルダーはアップロード前にクリップを変換し、再生または削除できます。
**イントロ後の呼び出し音**では、クリップの後に再生する米国式の呼び出し音の回数を設定します。**オフ**、**1 回**（デフォルト）、または **2 回**から選択できます。
通話開始時の順序は次のとおりです。接続音（オンの場合）、イントロクリップ、呼び出し音、該当する場合は[同意に関する案内](#consent-announcement)または
[AI 処理に関する開示](#ai-processing-disclosure)、その後にあいさつが流れます。クリップ内で通話が録音されると案内していても、イントロクリップが同意に関する案内や AI 処理に関する開示に置き換わることはありません。クリップと呼び出し音の再生中は、発信者の音声は処理されません。カスタムクリップは通話開始時に取得されます。数秒以内に読み込めない場合は、クリップなしで通話が進行するため、読み込みに失敗するとあいさつが最大約 3 秒遅れることがあります。
イントロクリップは他の設定と同様に下書き設定です。デプロイするとライブ通話に反映されます。
標準の録音通知音声: Allison Smith、
[CC BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/)、ThunderPhone により調整
（トリミング、結合、リサンプリング）。
### ツール音
プロンプトから呼び出せるサウンドツールで再生する音を選択します。
- **なし** — ツールは提供されません。
- **チャイム**、**ディン**、または **ビープ** — それぞれビルダーでプレビューできます。
### タイピング音
**タイピング音** を有効にすると、エージェントがカスタムツールを実行している間に、控えめなキーボード音を再生します。プラットフォーム管理ツールでは再生されません。
有効にしたら、サウンドを選択します。各サウンドはビルダーでプレビューできます。
- **キーボードとマウス**（デフォルト）：誰かが調べているような、マウスクリックを伴うタイピング音。
- **メカニカルキーボード**：明るく、クリック感のあるメカニカルキー音。
- **デスクトップキーボード**：標準的なキーボードでの一定のタイピング音。
- **ノートパソコン**：柔らかく平坦なノートパソコンのキー音。
- **オフィスキーボード**：静かで控えめなオフィスキーボード音。
- **静かな部屋**：1人がタイピングしている、柔らかな室内環境音。
### ツール開始時の案内
エージェントがツールを呼び出す際に発話するかどうかを選択します。
- **常に**（新しいエージェントのデフォルト）：ツールの応答速度にかかわらず、ツールの呼び出しごとに何かを発話します。エージェントが呼び出しとともに発話した場合は、そのエージェント自身の言葉が案内になります。それ以外の場合は、呼び出し用に作成された短い案内が準備でき次第再生されます。約1秒以上かかる場合は、「少々お待ちください」などの標準案内が再生されます。独自の音声を再生するツールや、通話自体に作用するツール（キーパッド入力、効果音、保留、転送、通話終了、ステップの引き継ぎ）は、処理が遅い場合にのみ案内が再生されます。エージェントが電話メニュー内にいる場合や留守番電話と会話している場合のツールも同様です。
- **ツールが遅い場合のみ**：エージェントが最後に発話してから約3秒後もツールが実行中の場合にのみ、短い案内を再生します。この設定が追加される前に作成されたエージェントでは、この選択が維持されます。
- **しない**：ツールの開始時にThunderPhoneは何も発話せず、エージェントにもツール呼び出し時に発話しないよう指示されます。エージェントが呼び出しとともに発話した内容は、そのまま再生されます。
どのオプションを選択しても、エージェント自身の言葉は常に再生されます。発信者が1ターンで聞くツール開始時の案内は最大1つです。エージェント自身の言葉や遅い応答時のつなぎの発話など、そのターンですでに発話された案内がある場合は、それがカウントされます。
### 長時間待機時の更新
デフォルトで有効です。ツールが約12秒間無音のまま実行中の場合、エージェントは処理を継続していることを伝え、その後、結果が届くまで約15秒ごとに短い待機案内を追加します。これらの案内は通話に合わせて作成されます。エージェントのプロンプトやペルソナ、それまでの会話、通話言語に従うため、固定の1文を繰り返すことはありません。案内を時間内に作成できない場合、エージェントは「申し訳ありません。予想より少し時間がかかっています」などの標準案内を使用します。ツールを伴わない遅い応答では、「少々お待ちください」などの短い標準案内が使用されます。
ツール開始の案内の後、結果が届くまで何も話さないようにするには、**長時間待機時の更新**をオフにします。ツールを使用しない遅い応答でも、つなぎの発話は行われません。オンになっている場合、入力音は引き続き再生されます。Storm の確認応答設定は別であり、影響を受けません。
### 設定はプロンプトより優先されます
ツール開始時の案内と長時間待機時の更新によって、ツールの実行中にThunderPhoneが発話する内容が決まります。プロンプトのテキストでこれらの案内を停止したり追加したりすることはできません。ツールの実行中に無音を維持するエージェントにするには、プロンプトで無音を求めるのではなく、**ツール開始時の案内**を**しない**に設定し、**長時間待機時の更新**をオフにします。プロンプトで無音を求めている場合、またはツールの呼び出しごとに案内を求めている一方でこれらの設定が異なる場合、ビルダーのプロンプトチェックで警告が表示されます。
### メールを送信
**メールを送信** を有効にし、受信者アドレスを1件入力すると、エージェントに `send_email` ツールが付与されます。アドレスはエージェント設定で固定されます。モデルは件名とプレーンテキスト本文を作成しますが、受信者を選択または変更することはできません。発信者の氏名と折り返し電話番号を収集した後にメッセージを送信する場合など、メールを送信すべき状況を正確にエージェントへ指示してください。
ツールの完全な動作については、[組み込みツール](/ja/guides/built-in-tools)を参照してください。
### Calculator
エージェントに `calculate` ツールを付与するには、**Calculator** を有効にします。エージェントは自ら計算する代わりにこのツールを使用し、注文合計、手数料、釣り銭を正確に計算します。デフォルトでは無効です。価格を案内するエージェントでは有効にしてください。プロンプトを変更する必要はありません。
ツールの完全な動作については、[組み込みツール](/ja/guides/built-in-tools)を参照してください。
### SMSを送信
**SMSを送信** を有効にすると、エージェントに `send_sms` ツールが付与されます。
送信元として使用する接続済みのVoIP番号（SMS対応かつ認証済みのTwilioまたはTelnyx）を選択します。ThunderPhoneが提供した番号からはSMSを送信できません。送信先を発信者のみに制限することも、他の受信者を許可して承認済み番号の許可リストを管理することもできます。通話後に送信するメッセージ用のSMSフォローアップテンプレートを有効にすることもできます。
ツールの完全な動作については、[組み込みツール](/ja/guides/built-in-tools)を参照してください。
### 追加オーディオコンテキスト
**追加オーディオコンテキスト** は、ターン間で保持する直近の発信者音声の量を制御します。
- **自動（推奨）** では、着信、ブラウザー、WebSocket通話ではより多くの直近音声を使用し、発信電話では最新ターンのみを使用します。
- **オン** では、修正、スペル確認、数字を多く含むデータ収集に役立つよう、直近数回の発信者ターンを含めます。
- **オフ** では、レイテンシーを抑えるため、最新の発信者ターンのみを含めます。
Agents APIでは、Storm専用の `audio_context_mode` 互換性フィールド（`full` または `reduced`）も公開されています。これは、上記のダッシュボードにある `additional_audio_context` の3段階設定とは別のものです。
### 最初に話す側
着信通話と発信通話をそれぞれ設定します。
- **着信:** エージェントが先に話す、または発信者が先に話す。
- **発信:** エージェントが先に話す、または着信先が先に話す。
エージェントの最初のあいさつを削除するには、着信通話では **発信者が先に話す**、発信通話では **着信先が先に話す** を選択します。
この設定は、スクリプトを開始する前に担当者または電話メニューを待機する必要がある発信ダイヤラーで役立ちます。
### ボイスメール処理
発信通話がボイスメールに接続された場合の動作を選択します。
| オプション | 動作 |
| --- | --- |
| **エージェントに判断させる** | プロンプトと会話コンテキストに基づいて、話すか切断するかを判断します。 |
| **無言で切断** | メッセージを残さずに終了します。 |
| **メッセージを残して切断** | 設定したメッセージを話して通話を終了します。 |
ボイスメールメッセージには最大 **2,000文字** を含めることができ、`{agent_name}` と `{org_name}` をサポートします。通話時間の計測方法については、[料金](/ja/guides/pricing)を参照してください。
### 同意告知
デフォルトでは、すべての通話の開始時に短い告知が再生され、AIアシスタントと話していること、および通話が録音されることを発信者に伝えます。告知テキストは最大 **2,000文字** まで編集でき、エージェントの言語でそのまま再生されます。
対象となるエージェントで告知を無効にするには、組織管理者が、組織が法的に必要な告知を行い、法的に必要な同意を取得することを確認する必要があります。再度有効にしてから後で無効にする場合は、新たな確認が必要です。この設定を変更する前に、[録音同意に関する法律ガイド](/ja/guides/recording-consent-laws)を確認してください。
### 通話を録音
**通話を録音**では、このエージェントが通話音声、文字起こし、その他の通話コンテンツを保存するかどうかを制御します。録音を行うには、組織全体の録音設定も有効にする必要があります。録音がオフの場合、これらのデータは保存されません。録音の対象は通話の最初の3時間までです。通話が3時間を超えても継続しますが、3時間以降の音声は録音されません。[通話録音に関する同意法](/ja/guides/recording-consent-laws)を参照してください。
### AI処理の開示
録音がオフの場合、**AI処理の開示** は、音声がライブで処理されるものの録音されないことを伝える短い告知を制御します。**組織設定を使用**、**常に再生**、または **再生しない** を選択します。開示を無効にするには、組織管理者による確認が必要です。
### 中断不可の告知
**中断不可の告知** は互換性のために表示されたままですが、有効にしても効果はありません。オフのままにしてください。必須の開始時メッセージには、会話前に再生され中断できない **同意告知** を使用します。
### 無音時の確認
有効にすると、一定時間無音が続いた後に、エージェントが発信者がまだ通話中かどうかを確認します。設定した上限まで繰り返した後、通話を切断します。
- **確認までの秒数:** 10～120秒。
- **確認の最大回数:** 1～10回。
デフォルトは15秒、確認回数は3回です。
### 通話時間とタイムアウト
以下のコントロールを使用して、停止した通話や通常より長い通話による通話時間と電話料金の増加を防ぎます。
- **切断までの無音時間（分）:** 1～60分。デフォルトは10分で、無音確認が無効な場合に適用されます。
- **最大通話時間:** 1～360分。新しいエージェントは60分から開始しますが、Interpreterテンプレートから作成されたエージェントにはエージェントレベルの上限がありません。上限を引き上げる、引き下げる、または無効にしてエージェントレベルの上限をなくすことができます。このデフォルトの導入前に作成されたエージェントは、既存の設定を維持します。上限の45秒前（上限が3分未満の場合はその4分の1）に、エージェントは会話を締めくくって別れの挨拶をするよう指示されます。
- **プラットフォーム上限:** エージェントの設定にかかわらず、すべての通話は6時間後に終了します。エージェントにはその前に同じ締めくくりの警告が表示されます。
- **呼び出し時間:** 発信通話および転送通話の呼び出し時間を5～120秒に設定します。未設定の場合はプラットフォームのデフォルトが適用されます。発信通話は60秒、ウォーム転送は45秒、コールド転送は通信事業者のデフォルトです。この設定は着信時の呼び出しには影響しません。
## ビルダーのタブとライフサイクル
| タブまたは操作 | 目的 |
| --- | --- |
| **ライブ / 通話** | ブラウザで現在の下書きと会話し、文字起こしとツールのアクティビティを確認します。 |
| **通話** | このエージェントが処理した通話を確認します。 |
| **A/B** | プロンプトまたは設定のバリエーションを作成し、ライブ結果を比較します。 |
| **シミュレーション** | 保存済みまたはアドホックのAI発信者シナリオを下書きに対して実行します。 |
| **検証** | デプロイ前に、固定した実通話のターンを下書きに対して再生します。 |
| **履歴** | デプロイ済みのリビジョンを比較し、1つを下書きに復元します。 |
| **破棄** | 保留中のすべての下書き設定をデプロイ済みバージョンに戻します。 |
| **デプロイ** | 完全な下書きをアトミックに昇格し、リビジョンを作成します。 |
別の編集者が読み込み後に同じエージェントを保存した場合、ThunderPhoneは
競合する保存またはデプロイを停止し、その変更を上書きせずに更新を求めます。
## リストからエージェントを管理
**音声エージェント**ページでは、組織レベルのライフサイクル操作もサポートしています。
- 同じ組織内で、新しい開始点としてエージェントを**複製**します。
- 所属する別の組織へエージェントを**転送**します。**コピー**では
元のエージェントを保持します。**移動**では現在の組織から削除され、管理者アクセスが必要です。
- 確認後、1つのエージェントを削除するか、選択したエージェントを一括削除します。
### エージェントリストをエクスポート
1つ以上のエージェントを選択し、その概要フィールドを**CSV**または
**JSON**としてエクスポートします。エクスポートには完全なプロンプトは含まれず、
設定のバックアップではありません。
組織間でエージェントをコピーまたは移動しても、転送先の組織に元の組織限定の接続へのアクセスが自動的に付与されることはありません。そこにデプロイする前に、
コピーしたエージェントのアプリ、API、ナレッジ、MCP、電話番号、ウィジェットの関連付けを確認してください。
## 関連ページ
簡潔なエンドツーエンドのビルダーガイド。
基本料金プラン、アドオン、通話の計測、電話番号、単発料金。
実通話のターンを固定し、デプロイ前に再生します。
リクエストフィールド、下書き、デプロイ、バージョン、例。