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

# コアコンセプト

> プラットフォーム内のすべてを把握するためのマップ。各オブジェクトの役割、ダッシュボード上の場所、操作するAPIを示します。

ThunderPhone は、AI音声エージェントを構築、運用、改善するためのフルプラットフォームです。このページは全体像を示します。出会うすべての概念を、ダッシュボード上の場所とそれを支える API とともに、それぞれ短いセクションで説明します。まず一度目を通し、用語の詳細を確認したくなったらいつでも戻ってきてください。

ダッシュボードのサイドバーはこの構成に対応しています。

<CardGroup cols={2}>
  <Card title="コア" icon="cube">
    [エージェント](#agents)、[電話番号](#phone-numbers)、
    [Web ウィジェット](#web-widgets)、[通話](#calls)、
    [ナレッジベース](#knowledge-bases)。
  </Card>

  <Card title="エンゲージメント" icon="megaphone">
    [ライブモニタリング](#live-monitoring)とアウトバウンド
    [キャンペーン](#campaigns)。
  </Card>

  <Card title="接続" icon="plug">
    エージェントで利用できる[アプリ、API、MCP サーバー、VoIP プロバイダー](#connections)。
  </Card>

  <Card title="品質とテスト" icon="flask">
    [シミュレーション](#simulations)、[実験](#experiments)、
    [課題](#issues)、[レポート](#reports)、
    [可観測性](#observability)。
  </Card>

  <Card title="組織" icon="building">
    [チームとロール](#team-and-roles)、[API キー](#organizations)、
    [アラート](#alerts)、[請求](#billing)。
  </Card>

  <Card title="イベント" icon="bolt">
    独自のコード向けの[Webhook](#webhooks)と[関数ツール](#function-tools)。
  </Card>
</CardGroup>

***

## 組織

**組織**はテナントの単位です。エージェント、電話番号、通話、キーなど、他のすべてのリソースは必ず 1 つの組織に属します。アカウントは複数の組織に所属でき、それぞれに独自の残高、キー、メンバーリストがあります。

**組織 → キー**で作成する `sk_live_` API キーは、1 つの組織に紐付けられます。この紐付けにより REST API は非常にフラットになります。キーがすでに組織を識別するため、URL パスに組織 ID を指定する必要はありません。

**ダッシュボード:** 組織切り替え（サイドバー下部）と
**組織**設定 — **一般**、**キー**、**アラート**、**請求設定**、
**請求履歴**のタブ。

**API:** [`/v1/orgs`](/api-reference/organizations)、
[`/v1/developer/api-keys`](/api-reference/developer-api-keys)。

***

## エージェント

**エージェント**は、通話を実行する AI 設定です。以下をまとめます。

* エージェントの発話内容と動作を定める**プロンプト**。転送、キーパッド操作、通話終了などの通話アクションも含まれ、これらは個別の設定ではなく通常のプロンプト行として指定します。
* **エンジンティア**（`spark`、`bolt`、`storm-*`）：Spark はコストに最適化され、Bolt は速度に、Storm は複雑なプロンプトに対する高度な推論に最適化されています。
* **音声**、**主要言語**、任意の**追加言語**。発信者が言語を切り替えると、エージェントも自動的に切り替わります。[対応言語](/ja/guides/supported-languages)を参照してください。
* 接続する機能：[連携アプリ](#connections)、
  [API 接続](#connections)、[ナレッジベース](#knowledge-bases)、
  [MCP サーバー](#connections)、インライン
  [関数ツール](#function-tools)。
* 動作設定：発話順序、応答モード、バックグラウンドトラック、
  保留タイムアウト。

ビルダーでの編集は**下書きに自動保存**されます。**デプロイ**をクリックするまで本番環境には反映されません。各デプロイはビルダーの**履歴**タブにスナップショットとして保存されるため、以前の任意のバージョンを確認して復元できます。

**ダッシュボード:** **音声エージェント** → エージェントビルダー
(`/dashboard/agents`)。[最初の音声エージェントを構築する](/ja/guides/build-an-agent)を参照してください。

**API:** [`/v1/agents`](/api-reference/agents) — CRUD、
複製、転送、バージョン履歴、プロンプトヘルパー。

## 電話番号

**電話番号**は組織に属し、着信通話をエージェントにルーティングします
（発信通話にも使用できます）。取得元は2種類あります。

* **デモ番号** — ThunderPhoneのプールからプロビジョニングされる実在の米国番号で、数秒で利用可能になります。着信専用で、短い音声免責事項を流して応答します。ダッシュボードでは、1組織あたり最大10件に制限されています。最初のテストには最適ですが、本番環境向けではありません。
* **VoIP番号** — [VoIP接続](#connections)を通じて、独自のプロバイダーから持ち込む番号です。TwilioとTelnyxは直接接続できます（Telnyxにはガイド付きセットアップがあります）。SignalWireとVonageは近日対応予定です。現在は、任意のSIPトランクを受け付ける手動SIP設定を介して接続できます。インポートと検証が完了すると、VoIP番号は着信と発信の両方に対応します。

各番号の行では、ルーティングモードの設定、着信エージェントの選択、番号へのラベル付けができます。

**ダッシュボード:** **電話番号** (`/dashboard/phone-numbers`)。
[電話番号を取得する](/ja/guides/get-a-phone-number)を参照してください。

**API:** [`/v1/phone-numbers`](/api-reference/phone-numbers)、
[`/v1/voip-connections`](/api-reference/voip-connections)、
[`/v1/phone-number-labels`](/api-reference/phone-number-labels)。

***

## 通話

すべての着信通話、発信通話、シミュレーション、ウィジェットセッションは、
**通話ログ**になります。通話ログには、ロールタグ付きの完全な文字起こし、
構造化されたターン履歴（ツール呼び出しを含む）、録音、請求合計、
任意のAI評価と問題レポートが含まれます。

通話が**ライブ**中の場合は、開いて**通話を聞く**ことができます。無音で参加するため、通話中の誰にも聞こえません。聞き始めると、
**ささやき**を使用できます。通話中にエージェントへ直接送信される指示を入力します。発信者には聞こえず、エージェントはリアルタイムで指示に従います。

**ダッシュボード:** アーカイブと通話ごとの詳細は**通話履歴** (`/dashboard/call-history`)、
進行中の通話は**ライブ**。 [通話を確認、聞く、コーチする](/ja/guides/review-calls)を参照してください。

**API:** [`/v1/calls`](/api-reference/calls) — 一覧、文字起こし、
履歴、音声、評価、エクスポート。
[`/v1/issue-reports`](/api-reference/issue-reports)。

***

## Webウィジェット

**Webウィジェット**は、サイト訪問者にエージェントとのマイクベースの会話を提供します。
電話番号は不要です。許可したドメインにオリジン制限された
**公開可能キー** (`pk_live_...`)で認証するため、クライアントサイドコードでも安全に使用できます。

キーは2つのモードのいずれかで動作します。`agent`（1つのエージェントに静的に紐付け）、
または`webhook`（訪問者ごとにサーバーが設定を選択 —
[通話ごとの動的設定](/ja/guides/dynamic-call-config)を参照）。ウィジェットセッションは電話通話と同じ通話インフラストラクチャを通ります。

**ダッシュボード:** **Webウィジェット** (`/dashboard/web-widgets`) —
ウィジェットの作成、モードとエージェントの設定、許可ドメインの管理、
埋め込みスニペットのコピーを行えます。
[Webウィジェットを作成する](/ja/guides/embed-a-web-widget-dashboard)を参照してください。

**API:** [`/v1/publishable-key`](/api-reference/publishable-keys)、
[`/v1/mic-session`](/api-reference/mic-sessions)、および
[Widget SDKドキュメント](/ja/widget/overview)。

***

## ナレッジベース

**ナレッジベース**は、通話中にエージェントが回答の根拠として検索できるドキュメントの集合です。
ファイルを直接アップロードするかGoogle Driveからインポートし、ビルダーでナレッジベースをエージェントに紐付けます。
会話で必要になったとき、エージェントは組み込みの検索ツールでナレッジベースをクエリします。

**ダッシュボード:** ドキュメントライブラリは**ナレッジ** (`/dashboard/knowledge`)、
エージェントへの紐付けはビルダーの**ナレッジ**セクション。
[エージェントにナレッジベースを提供する](/ja/guides/knowledge-base)を参照してください。

***

## 接続

接続により、エージェントは外部の世界と連携できます。4種類の接続を、1つの
サイドバーグループで管理します。

* **アプリ**（`/dashboard/app-connections`） — Slack、HubSpot、Salesforce、Google Calendar、Google Sheets、
  Cal.com への OAuth 接続です。一度接続すれば、操作ごとのツール（Slack メッセージの投稿、
  HubSpot コンタクトのアップサート、Cal.com スロットの予約など）を任意のエージェントに
  切り替えて追加できます。[アプリを接続](/ja/guides/connect-apps)を参照してください。
* **API**（`/dashboard/api-connections`） — 任意の HTTP API を
  エージェントアクションに変換します。cURL コマンドを貼り付けると、AI ウィザードがツール
  定義の下書きを作成します。手動で作成することもできます。リリース前に **リクエストをテスト**
  ボタンでサンドボックス呼び出しを実行できます。
  [API 接続](/ja/guides/api-connections)を参照してください。これは
  [`/v1/integrations`](/api-reference/integrations)のダッシュボード画面です。
* **MCP**（`/dashboard/mcp-connections`） — URL で Model Context
  Protocol サーバーを追加し、エージェントが公開されているツールを使用できるようにします。
  [MCP サーバーを追加](/ja/guides/mcp-servers)を参照してください。
* **VoIP**（`/dashboard/voip-connections`） —
  [独自の電話番号を使用する](#phone-numbers)ためのプロバイダー認証情報です。
  [VoIP プロバイダーを接続](/ja/guides/voip-providers)を参照してください。

**API:** [`/v1/integrations`](/api-reference/integrations) と
[`/v1/voip-connections`](/api-reference/voip-connections)。
[ツール統合を構築](/ja/guides/build-tool-integration)も参照してください。

***

## キャンペーン

**キャンペーン**では、大規模にアウトバウンド通話を発信します。コンタクトの CSV をアップロードし、
エージェントと発信番号を選択して、通話時間帯（曜日、時間、タイムゾーン対応）、
同時実行数、再試行ポリシー（最大試行回数と、再試行する結果（応答なし、留守番電話、失敗））を
設定します。キャンペーンはリストを順に処理し、すべての通話を通話履歴に記録します。

**ダッシュボード:** **キャンペーン**（`/dashboard/campaigns`）。
[アウトバウンド通話キャンペーンを実行](/ja/guides/outbound-campaigns)を参照してください。

**単発のプログラムによる通話:**
[アウトバウンド通話 API](/ja/guides/place-outbound-calls)。

***

## ライブモニタリング

**ライブ**には、組織全体で進行中のすべての通話が表示され、任意の通話を開いて
リアルタイムで[通話を聞き、ささやく](#calls)ことができます。これは監督用の画面です。新しい
プロンプトへの最初の実トラフィックを確認したり、実行中のキャンペーンを監視したりできます。

**ダッシュボード:** **ライブ**（`/dashboard/live`）。
[ライブ通話を監視・監督](/ja/guides/monitor-live-calls)を参照してください。

***

## シミュレーション

**シミュレーション**は、AI 発信者がエージェントと実際の会話を行う機能です。同じ電話経路、
実際の文字起こし、実際の評価を使用するため、リリース前後にテストできます。エージェントまたは
電話番号を指定し、発信者シナリオを自分で作成するか、エージェントのプロンプトから **AI で
シナリオを生成**します。指定すればエッジケースも含められます。通話はライブで確認できます。

シナリオは**スイート**にグループ化され、最低合格率を固定できます。また、CI でリリースを
制限することもできます。承認済みベースラインに対するリグレッションは、シナリオごとに
報告されます。

**ダッシュボード:** **シミュレーション**（`/dashboard/simulations`）と、
エージェントビルダー内の **シミュレーション** ボタン。
[通話をシミュレート](/ja/guides/simulate-a-call)を参照してください。

**API:** [`/v1/test-calls`](/api-reference/test-calls) と
スイートランナー。[エージェントをエンドツーエンドでテスト](/ja/guides/test-agents)を参照してください。

***

## 実験

**実験**では、ライブトラフィック上でエージェント設定の A/B テストを行います。
バリアント（異なるプロンプト、エンジン、設定）を定義し、トラフィックを分割して、
バリアントごとの結果を比較します。Webhook でバケットロジックを手作業で実装する代わりに
使用できます。

**ダッシュボード:** **実験**（`/dashboard/experiments`）と、
エージェントビルダーの **A/B** タブ。
[実験（A/B テスト）](/ja/guides/experiments-ab-testing)を参照してください。

## 問題

**問題**とは、特定の通話でフラグ付けされた問題です。人間のレビュアーが報告したもの、またはAI評価によって検出されたものがあります。問題には重大度、ソース、ステータスが含まれ、問題ページはトリアージキューとして機能します。フィルタリング、該当する通話の確認、修正の追跡を行えます。

**ダッシュボード:** **問題**（`/dashboard/issues`）、および通話履歴での通話ごとのフラグ付け。[問題のトリアージ](/ja/guides/issues)を参照してください。

**API:** [`/v1/issue-reports`](/api-reference/issue-reports)。

***

## レポート

**レポート**は、選択したエージェントと期間の範囲で、通話データに関する自然言語の質問（「先週、発信者が人間の担当者を求めた理由の上位3つは何でしたか？」）に対し、AIが作成した分析で回答します。

**ダッシュボード:** **レポート**（`/dashboard/reports`）。[レポート](/ja/guides/reports)を参照してください。

***

## 可観測性

**可観測性**は、通話量、結果、品質を時系列で確認できるメトリクス画面です。エージェントと時間範囲でフィルタリングでき、後続の分析用にエクスポートできます。

**ダッシュボード:** **可観測性**（`/dashboard/observability`）。[可観測性](/ja/guides/observability)を参照してください。

***

## アラート

**アラートルール**は、指定した時間範囲でメトリクス（成功率、失敗率、平均スコア、通話量、スイートの回帰）を監視し、しきい値を超えるとトリガーされます。通知はメールとSlackに送信され、[Webhookエンドポイント](/ja/webhooks/endpoints)に `alert.triggered` イベントを送信します。

**ダッシュボード:** **組織 → アラート**。[アラート](/ja/guides/alerts)を参照してください。

***

## Webhook

ThunderPhoneは、通話中および通話後にイベントが発生すると、サーバーに **HTTP POST Webhook** を送信します。配信モデルは2種類あります。

* **Webhookエンドポイント**（推奨）: 複数のURLを[`/v1/developer/webhook-endpoints`](/ja/webhooks/endpoints)で管理できます。エンドポイントごとのシークレットと、エンドポイントごとのイベントサブスクリプションを設定できます。
* **レガシーの単一URL Webhook**: 組織ごとに1つのURLです。[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)または**組織 → 一般**で管理します。後方互換性のために維持されています。

イベントは2つのクラスに分かれます。

* **ブロッキングイベント**では、進行中の通話を制御する設定をサーバーから応答として返す必要があります。対象は[incoming-callイベント](/ja/webhooks/call-incoming)（`telephony.incoming` / `web.incoming`）です。応答まで最大10秒です。タイムアウトした場合は、静的に割り当てられたエージェントが通話を処理します。
* **非ブロッキングイベント**は、送信後に応答を待たない通知であり、指数バックオフで再試行されます。[配信セマンティクス](/ja/webhooks/overview)を参照してください。

すべてのリクエストには、`X-ThunderPhone-Signature` にHMAC-SHA256署名が含まれます。[署名の検証](/ja/webhooks/overview)を参照してください。

***

## 関数ツール

**関数ツール**は、エージェントが会話の途中で呼び出せるHTTPエンドポイントです。OpenAI形式の関数スキーマとエンドポイントURLをThunderPhoneに指定します。エージェントが呼び出すタイミングを判断し、ThunderPhoneがそのサーバーから署名付きHTTPリクエストを送信して、結果をエージェントに返します。

エージェントには、通話の転送、キーパッド（DTMF）入力の送信、通話の終了、保留中の待機といった**組み込みの通話機能**もあります。ツール定義ではなく、シンプルなプロンプト行で有効にできます。

**ダッシュボード:** ビルダーの**API接続**セクション（[接続](#connections)を参照）。

**API:** [`/v1/integrations`](/api-reference/integrations)および[関数ツール仕様](/ja/tools/overview)。

***

## チームとロール

各組織には、2つのロールを持つメンバー一覧があります。**メンバー**はエージェントを構築・運用し、**管理者**はチームと請求も管理できます。メールで招待できます。招待は7日後に期限切れとなり、取り消すこともできます。メンバー行の⋯メニューからロールの変更やメンバーの削除を行えます。シングルサインオンは組織全体で設定できます。[SSO](/ja/guides/sso)を参照してください。

**ダッシュボード:** **組織 → 一般**。[チームを招待する](/ja/guides/invite-your-team)を参照してください。

**API:** [`/v1/members`](/api-reference/members)、[`/v1/invites`](/api-reference/invites)。

***

## 請求

ThunderPhoneは**前払い制**です。各組織は米ドル残高を保有し、通話ごとにエージェントの分単価（エンジンティアと追加料金。ビルダーでは設定変更に応じて総額レートがリアルタイムで表示され、[プレミアム言語](/ja/guides/supported-languages)には2¢/分が追加されます）が差し引かれます。残高がゼロになると、着信通話は拒否され、発信通話は`402 Payment Required`を返します。

手動でチャージするか、残高しきい値、補充額、任意の月間利用上限を指定して**自動チャージ**を有効にすると、通話が文の途中で切れることを防げます。

**ダッシュボードの場合：** **組織 → 請求設定**および
**請求履歴**。詳細は
[資金を追加して自動チャージを有効にする](/ja/guides/billing-and-topups)を参照してください。

**APIの場合：** [`/v1/billing`](/api-reference/billing)。

***

## アプリ内コパイロット

ダッシュボードには組み込みの**コパイロット**が搭載されています。「Xをするにはどうすればよいですか」と質問すると、このドキュメントに基づいて回答し、実際のコントロールを強調表示するクリックごとのガイドを提示し、任意のガイドツアーを再生できます。このページで紹介しているコントロールを見つける最も速い方法です。
[アプリ内コパイロットに質問する](/ja/guides/ask-the-copilot)を参照してください。

***

## 全体を組み合わせる

<CardGroup cols={2}>
  <Card title="ダッシュボードのクイックスタート" icon="wand-magic-sparkles" href="/ja/quickstart-dashboard">
    5ステップのウィザード：エージェント → 請求 → 電話番号 → シミュレーション → 確認。
  </Card>

  <Card title="APIクイックスタート" icon="terminal" href="/ja/quickstart">
    同じ最初の通話を4つのREST呼び出しで実行。
  </Card>

  <Card title="ダッシュボードの使用" icon="table-columns" href="/ja/guides/build-an-agent">
    エージェントを構築し、資金を追加し、電話番号を取得して、通話をシミュレーション・確認。
  </Card>

  <Card title="ツールとデータを接続" icon="plug" href="/ja/guides/connect-apps">
    OAuthアプリ、カスタムAPI、MCPサーバー、VoIPプロバイダー。
  </Card>

  <Card title="分析と改善" icon="chart-line" href="/ja/guides/reports">
    レポート、可観測性、実験、問題、アラート。
  </Card>

  <Card title="チームとアカウント" icon="users" href="/ja/guides/invite-your-team">
    招待とロール、APIキー、セキュリティ、SSO。
  </Card>

  <Card title="開発者クックブック" icon="phone-arrow-down-left" href="/ja/guides/handle-inbound-calls">
    APIレシピ：着信、発信、動的設定、ツール、テスト。
  </Card>

  <Card title="Webhook署名を検証" icon="shield-check" href="/ja/guides/verify-webhook-signatures">
    HMACチェックを一度正しく実装し、どこでも再利用。
  </Card>
</CardGroup>