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

# 最初の音声エージェントを構築する

> エージェントビルダーのエンドツーエンドガイド：プロンプト、エンジン、音声と言語、ツールとナレッジ、会話、デプロイ。

エージェントに関するすべては、**音声エージェント**
(`/dashboard/agents`) のビルダーで管理します。作成すると、そのままビルダーが開きます。このガイドでは、アプリ内の「エージェントを作成」ツアーと同じ手順を説明します。

<Tip>
  初めての場合は、[ダッシュボードクイックスタート](/ja/quickstart-dashboard)
  で、このページの内容に加え、請求、電話番号、シミュレーションを
  5ステップのセットアップウィザードで確認できます。
</Tip>

## 1. プロンプトを作成する

プロンプトは音声エージェントの台本です。エージェントが誰であり、通話をどのように処理すべきかを、任意の言語で説明します。ペルソナ、把握している情報、実行すべきことと実行すべきでないことを記述します。

通話アクションもプロンプトで指示します。転送、キーパッド操作、通話終了は、*"発信者が担当者を求めた場合は、通話を +1 555… に転送する"* のように通常のプロンプト行として記述します。個別の設定は不要です。

<Tip>
  一般的な指示より具体的な指示が有効です。「変更を行う前に注文番号を発信者に復唱して確認する」は、「注文は慎重に扱う」より優れています。
</Tip>

## 2. エンジンを選択する

**設定** タブでは、エンジン選択ツールで3つの階層にわたるコストとパフォーマンスのバランスを調整できます。**Spark** はコスト向け、**Bolt** は速度向け、**Storm** は複雑なプロンプトに対するインテリジェンス向けに最適化されています。各カードには分単価が表示されます。いつでも切り替えできます。詳しくは、[階層の完全な比較](/api-reference/agents#product-tiers-at-a-glance)を参照してください。

## 3. 音声と言語を選択する

音声を選択し、ビルダー内でサンプルを再生します。通話開始時の **主要言語** と、必要に応じて **追加言語** を設定します。発信者が追加言語のいずれかを使用すると、エージェントは自動的に切り替えます。音声リストには、選択したすべての言語をサポートする音声のみが表示されます。完全なカタログについては、[対応言語](/ja/guides/supported-languages)を参照してください（プレミアム言語は 2¢/分 が追加されます）。

## 4. ツールとナレッジを接続する

設定タブの4つのセクションで、エージェントに機能を追加できます。

* **接続済みアプリ** — 最も簡単な方法です。
  数回のクリックで [Slack、HubSpot、Google などを接続](/ja/guides/connect-apps)し、
  エージェントが通話中に利用できるようにします。
* **API 接続** — その他の API には、
  エージェントに必要なアクション用の[API 接続を作成](/ja/guides/api-connections)します
  （cURL コマンドを貼り付けると、AI ウィザードがツールの下書きを作成します）。
* **ナレッジ** — エージェントが
  通話中に検索できる[ナレッジベース](/ja/guides/knowledge-base)を接続します。
* **MCP サーバー** — URL を使用して [MCP サーバーを追加](/ja/guides/mcp-servers)します。

4種類の違いについては、[接続](/ja/guides/concepts)を参照してください。

## 5. 総額の分単価を確認する

ビルダーには、エンジン料金と追加料金を含む **総額の分単価** が表示され、設定の変更に応じてリアルタイムで更新されます。請求時に想定外の料金は発生しません。

## 6. 会話する

**通話** をクリックして話しかけます。エージェントはブラウザ内で応答します
（マイクへのアクセスを求められます）。これは最も速い反復サイクルです。
プロンプトを調整し、会話し、繰り返します。自身ではなく通話相手として発信者を設定したい場合は、[シミュレーションを実行](/ja/guides/simulate-a-call)します。

## 7. デプロイする

すべての編集は **下書きに自動保存** されます。上部バーに「保存済み」と表示されることを確認してください。下書きの変更は、**デプロイ** をクリックするまで本番環境に反映されません。

デプロイごとに **履歴** タブでスナップショットが作成されます。バージョン間の変更内容を確認し、以前の任意のバージョンを復元できます。そのため、頻繁にデプロイしても安全です。いつでもロールバックできます。

## 8. 外部に接続する

設定タブの **電話番号** と **Web ウィジェット** セクションでは、ビルダーを離れずにエンドポイントを接続できます。既存の番号を接続する、新しいデモ番号をプロビジョニングする、VoIP 経由でインポートする、または Web ウィジェットをリンクできます。

***

## 次のステップ

<CardGroup cols={2}>
  <Card title="電話番号を取得" icon="phone" href="/ja/guides/get-a-phone-number">
    数秒でデモ番号を取得するか、VoIP 経由で独自の番号を使用できます。
  </Card>

  <Card title="通話をシミュレーション" icon="flask" href="/ja/guides/simulate-a-call">
    AI 発信者がエージェントと実際の会話を行います。
  </Card>

  <Card title="通話を確認" icon="headset" href="/ja/guides/review-calls">
    文字起こし、録音、ライブリスニング、ささやき。
  </Card>

  <Card title="Agents API リファレンス" icon="code" href="/api-reference/agents">
    プログラムからエージェントを作成・管理します。
  </Card>
</CardGroup>