> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 音声エージェント設定リファレンス

> ThunderPhone音声エージェントのすべての設定を解説：ティア、音声、言語、応答、ツール、発話順序、留守番電話、同意に関するアナウンス、無音時の処理、テスト、デプロイ。

**音声エージェント**を開き、エージェントを選択して、**設定**タブで音声、推論、通話の開始方法、ツールの使用、無音と留守番電話の処理、発信者への接続方法を管理します。変更は下書きに自動保存されます。**デプロイ**を選択するまで、本番トラフィックは変更されません。

このページはダッシュボードの完全なリファレンスです。フィールド名とリクエスト例については、[Agents API リファレンス](/api-reference/agents)を参照してください。

## プロンプトとアイデンティティ

エージェント名は、ダッシュボード、レポート、通話履歴、クライアントポータル全体でエージェントを識別します。プロンプトはエージェントの運用スクリプトです。ペルソナ、事業情報、必須の質問、エスカレーションポリシー、通話アクションを定義します。

プロンプトエディターでは推定トークン数を表示し、空のプロンプト、未解決のテンプレートプレースホルダー、エスカレーション経路の欠落、非常に長いプロンプトなどの一般的な問題を検出します。最初の**推定 5,000 トークン**は含まれます。より長いプロンプトには[ブロック単位の追加料金](/ja/guides/pricing)が適用されます。

<Tip>
  転送、キーパッド入力、保留時の動作、通話終了の判断は、プロンプトに直接記述できます。エージェントが外部データやアクションを必要とする場合は、API、アプリ、MCP、またはナレッジツールを接続してください。
</Tip>

## モデル階層

| 階層        | 基本料金 | 最適な用途                      |
| --------- | ---: | -------------------------- |
| **Spark** | 2¢/分 | コストを重視する単純な通話。             |
| **Bolt**  | 5¢/分 | 高速な応答と、バランスの取れた日常的なワークフロー。 |
| **Storm** | 9¢/分 | 複雑な指示、音声理解、推論。             |

Storm には、2 つの任意コントロールがあります。

* **応答待機** — **なし**では完全な応答を準備している間は無音です。**ティック**では控えめな待機音を再生します。**音声**では短い応答待機メッセージを発話し、**2¢/分**が追加されます。音声テキストはメインプロンプトから生成することも、API を通じて手動で指定することもできます。
* **追加インテリジェンス** — 複雑な通話に対するより深い推論を追加し、**3¢/分**が加算されます。

ビルダーには、階層、音声と言語の組み合わせ、プロンプトの長さ、音声での応答待機、追加インテリジェンス、監視を含む、エージェントの**1 分あたりの総費用**が継続的に表示されます。

## 音声、バックグラウンド、言語

音声を選択し、デプロイ前にサンプルを再生してください。ピッカーには、選択したすべての言語と互換性のある音声のみが表示され、プレミアムの組み合わせには追加料金が表示されます。カスタム音声は準備が完了すると同じピッカーに表示されます。[音声ライブラリとカスタム音声](/ja/guides/voice-library)を参照してください。

**バックグラウンドトラック**には次の選択肢があります。

* **なし** — 環境音を使用しません。
* **コールセンター** — コールセンターの環境音。ダッシュボード内でプレビューできます。

1 つの**主言語**を設定し、その後に任意の数の**追加言語**を設定します。発信者が選択済みの言語に切り替えると、エージェントは自動的に検出し、その言語で応答します。一部の音声と言語の組み合わせには**3¢/分**が追加されます。生成された[対応言語](/ja/guides/supported-languages)カタログを参照してください。

## 接続済み機能

設定タブには、個別に接続できる 4 つの機能セクションがあります。

| セクション        | 用途                                                                       |
| ------------ | ------------------------------------------------------------------------ |
| **接続済みアプリ**  | Google Calendar、Google Sheets、Slack、HubSpot、Salesforce、Cal.com で承認済みの操作。 |
| **API 接続**   | 呼び出し可能な関数として記述された独自の HTTP エンドポイント。                                       |
| **ナレッジ**     | 通話中にエージェントが検索できるファイルまたはウェブコンテンツ。                                         |
| **MCP サーバー** | リモートの Model Context Protocol サーバーから検出されたキャッシュ済みツール。                      |

接続は下書きの一部となり、デプロイ後に本番通話で利用できるようになります。まず**接続**または**ナレッジ**でリソースを設定してから、エージェントに接続してください。

## 電話とウェブエンドポイント

**電話番号**では、既存の番号を接続するか、デモ番号を発行するか、VoIP 接続を通じて番号をインポートします。1 つの番号で、着信と発信に異なるエージェントを使用できます。

**ウェブウィジェット**では、ウィジェットを接続して、サイト訪問者がエージェントと会話できるようにします。エージェント設定の一部として、ウィジェットの利用可否を有効または無効にすることもできます。

## 高度な通話動作

以下のコントロールを使用するには、設定の下部にある **詳細設定** を展開します。

### 監督

有効にすると、2つ目のAIモニターが各エージェントのターンを指示に照らして確認し、必要に応じて非表示で介入します。監督には **1分あたり8¢** が追加でかかり、Boltでは利用できません。

### 接続音

通話の接続直後、どちらかが話す前に短い音を再生します。

### ツール音

プロンプトから呼び出せる音声ツールで再生する音を選択します。

* **なし** — ツールは提供されません。
* **チャイム**、**ディン**、または **ビープ** — それぞれビルダーでプレビューできます。

### 最初に話す人

着信通話と発信通話を個別に設定します。

* **着信:** エージェントが先に話す、または発信者が先に話す。
* **発信:** エージェントが先に話す、または着信者が先に話す。

この設定は、スクリプトを開始する前に人または電話メニューを待つ必要がある発信ダイヤラーで役立ちます。

### ボイスメール処理

発信通話がボイスメールに接続された場合の動作を選択します。

| オプション                | 動作                                     |
| -------------------- | -------------------------------------- |
| **エージェントに判断させる**     | プロンプトと会話コンテキストに基づいて、話すか通話を終了するかを判断します。 |
| **無言で通話を終了**         | メッセージを残さずに終了します。                       |
| **メッセージを残してから通話を終了** | 設定したメッセージを話し、通話を終了します。                 |

ボイスメールメッセージは最大 **2,000文字** まで入力でき、`{agent_name}` と `{org_name}` をサポートしています。通話時間の計測方法については、[料金](/ja/guides/pricing)を参照してください。

### 同意に関するアナウンス

デフォルトでは、すべての通話の開始時に短いアナウンスが再生され、発信者にAIアシスタントと話していること、および通話が録音されていることを伝えます。アナウンスのテキストは最大 **2,000文字** まで編集でき、エージェントの言語でそのまま再生されます。

対象エージェントでアナウンスを無効にするには、組織管理者が、組織が法的に必要な通知を提供し、法的に必要な同意を取得することを確認する必要があります。再度有効にしてから後で無効にする場合は、改めて確認が必要です。この設定を変更する前に、[録音同意法ガイド](/ja/guides/recording-consent-laws)を確認してください。

### 無音時の確認

有効にすると、無音状態が続いた後にエージェントが発信者がまだいるかを確認し、設定した上限回数まで繰り返してから通話を終了します。

* **確認前の秒数:** 10～120秒。
* **最大確認回数:** 1～10回。

デフォルトは15秒、確認回数は3回です。

## ビルダータブとライフサイクル

| タブまたは操作      | 目的                                     |
| ------------ | -------------------------------------- |
| **ライブ / 通話** | ブラウザで現在の下書きと会話し、トランスクリプトとツールの動作を確認します。 |
| **通話**       | このエージェントが処理した通話を確認します。                 |
| **A/B**      | プロンプトまたは設定のバリアントを作成し、実際の結果を比較します。      |
| **シミュレーション** | 保存済みまたはアドホックなAI発信者シナリオを下書きに対して実行します。   |
| **検証**       | デプロイ前に、凍結された実通話のターンを下書きに対して再生します。      |
| **履歴**       | デプロイ済みリビジョンを比較し、そのうち1つを下書きに復元します。      |
| **破棄**       | 保留中のすべての下書き設定をデプロイ済みバージョンに戻します。        |
| **デプロイ**     | 完全な下書きをアトミックに昇格させ、リビジョンを作成します。         |

読み込み後に別の編集者が同じエージェントを保存した場合、ThunderPhoneは競合する保存またはデプロイを停止し、変更を上書きする代わりに更新を求めます。

## リストからエージェントを管理

**音声エージェント**ページでは、組織レベルのライフサイクル操作もサポートしています。

* 同じ組織内で、新しい開始点としてエージェントを**複製**します。
* 所属する別の組織にエージェントを**転送**します。**コピー**では元のエージェントを保持し、**移動**では現在の組織から削除され、管理者アクセスが必要です。
* 1つ以上のエージェントを選択し、表示されている設定を**CSV**または**JSON**としてエクスポートします。
* 確認後、1つのエージェントを削除するか、選択したエージェントを一括削除します。

組織間でエージェントをコピーまたは移動しても、移動先の組織に元の組織限定の接続へのアクセスが自動的に付与されることはありません。コピーしたエージェントをそこでデプロイする前に、アプリ、API、ナレッジ、MCP、電話番号、ウィジェットの関連付けを確認してください。

## 関連ページ

<CardGroup cols={2}>
  <Card title="最初のエージェントを構築" icon="robot" href="/ja/guides/build-an-agent">
    エージェント構築を最初から最後まで簡潔に解説します。
  </Card>

  <Card title="料金" icon="coins" href="/ja/guides/pricing">
    基本プラン、アドオン、通話計測、電話番号、単発料金。
  </Card>

  <Card title="検証セット" icon="list-check" href="/ja/guides/validation-sets">
    実際の通話ターンを固定し、デプロイ前に再生します。
  </Card>

  <Card title="エージェント API" icon="code" href="/api-reference/agents">
    リクエストフィールド、下書き、デプロイ、バージョン、例。
  </Card>
</CardGroup>