> ## 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接続
> 任意のHTTP APIを、会話の途中でエージェントが呼び出せる関数に変換。cURLコマンドを貼り付ければ、あとはウィザードが処理します。
API接続は、会話中にエージェントが呼び出せるカスタムHTTP関数です。注文の検索、チケットの作成、自社バックエンドからのアカウントステータス取得などに使用できます。エンドポイントは
**接続 → API** (`/dashboard/api-connections`) で一度定義します。接続が追加されているエージェントは、会話の状況に応じていつでも呼び出せます。
作成方法は2つあります。ウィザードで分析できる内容を貼り付けるか、接続を手動で設定します。
## 最短手順：貼り付けて分析
ダイアログがウィザードで開きます。サンプルの**cURLコマンド**、
**OpenAPI/Swagger仕様**、**Postmanエクスポート**、**TypeScript
インターフェース**、または**Zodスキーマ**をボックスに貼り付けます。
ThunderPhoneは、貼り付けた内容から接続全体を推論します。URL、
メソッド、ヘッダー、検出したクエリパラメータとリクエスト本文から導出した
パラメータスキーマが含まれます。貼り付けたヘッダー（認証ヘッダーを含む）は、
エンドポイント設定に引き継がれます。
推論された設定が開き、推測されたフィールドが確認用にハイライトされます。
エージェントが関数をいつ、どのように呼び出すかを理解できるよう、名前、説明、
パラメータタイプを調整します。モデルが読むのは説明です。
保存時には、まずエンドポイントに対してライブテストリクエストが実行されます。
リクエストが失敗した場合、接続は保存されません。URL、認証ヘッダー、または本文を
修正して再試行してください。成功すると、接続は**検証済み**バッジ付きで保存されます。
ウィザードが貼り付けた内容からリクエストURLを見つけられない場合は、その旨が表示されます。
完全な`http(s)`エンドポイントを含めて、再試行してください。
## 手動設定
ウィザードで\*\*手動で設定 →**をクリックします（戻る場合は**AIに推論させますか？
ウィザードを試す →\*\*をクリック）。手動ビルダーには2つのエディターがあります。
* **ビジュアル** — 表示名、関数名、リクエスト
**URL**、**メソッド**（`POST`、`GET`、`PUT`、`PATCH`、`DELETE`）、カスタム
**ヘッダー**、パラメータスキーマ（エージェントが指定できる引数ごとに**プロパティを追加**）のフォームフィールド。
* **JSON** — ツール仕様を直接貼り付けたり微調整したりするための、生のJSONによる同じ定義。
任意の**テストリクエスト**パネルでは、保存前に設定したリクエストを実行し、
ステータス、レイテンシー、レスポンスプレビューを確認できます。
**検証して保存**では常にこのテストが実行され、成功した場合のみ保存されます。
パラメータには平易な説明を付けてください（「顧客のメールアドレス。
例：[jane@example.com](mailto:jane@example.com)」）。エージェントは通話中にリアルタイムで、これらの説明に基づいて
引数を選択します。
## 接続を管理
各接続行には、検証ステータス（**検証済み**、**未テスト**、または**エラー**）、
関数名、その接続を使用しているエージェントが表示されます。行のアクションメニューから、次の操作を行えます。
* **編集** — 設定を再度開きます。
* **複製** — 開始点として複製します（コピーは未テストの状態で開始します）。
* **リビジョン履歴** — 以前のバージョンを表示し、1つをエディターに復元します。
* **転送** — 所属する別の組織に接続をコピーまたは移動します。移動するとここから削除され、
使用していたエージェントは再設定が必要になる場合があります。
* **削除** — 完全に削除されます。接続を使用しているエージェントは再設定が必要になります。
## エージェントに追加
ビルダーのAPI接続セクションでエージェントに接続を追加します
([エージェントを構築](/ja/guides/build-an-agent))。リストには各接続を使用しているエージェントが表示されるため、
変更の影響範囲を一目で確認できます。
## 次のステップ
同じ接続をプログラムで作成・管理します。
Google、Slack、HubSpot、Salesforce、Cal.com 向けの事前構築済み接続。
ツールサーバー全体をエージェントに公開します。
連携リソースのすべてのフィールド。