---
title: "API接続"
description: "任意の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による同じ定義です。
任意の **リクエストをテスト** パネルでは、保存前に設定済みのリクエストを
実行し、ステータス、レイテンシー、レスポンスプレビューを確認できます。
**検証して保存** では常にこのテストが実行され、成功時のみ保存されます。
ヘッダー値は書き込み専用です。保存されると暗号化され、ダッシュボードでも API でも二度と表示されません。接続を編集すると、保存済みのヘッダーには値の代わりにドットと名前、および **保存済み** の注記が表示されます。保存済みの値を保持するにはそのままにし、置き換えるには新しい値を入力します。テストリクエストと実際の通話では保存済みの値が使用されます。**複製** は保存済みの値を新しい接続にコピーします。
パラメータには平易な説明を付けてください（「顧客のメールアドレス。
例: jane@example.com」）。エージェントは通話中にリアルタイムで、
これらの説明に基づいて引数を選択します。
## 接続を管理
各接続行には、検証ステータス（**検証済み**、
**未テスト**、または **エラー**）、関数名、その接続を使用するエージェントが表示されます。
行のアクションメニューから、次の操作を実行できます。
- **編集** — 設定を再度開きます。
- **複製** — 開始点として複製します（コピーは未テストの状態で作成されます）。
- **改訂履歴** — 以前のバージョンを表示し、1つをエディターに復元します。
- **転送** — 所属する別の組織に接続をコピーまたは移動します。
移動すると、この組織からは削除されます。使用していたエージェントは再設定が必要になる場合があります。
- **削除** — 完全に削除されます。接続を使用しているエージェントは再設定が必要になります。
## エージェントに追加
ビルダーのAPI接続セクションでエージェントに接続を追加します
（[エージェントを構築](/ja/guides/build-an-agent)）。一覧には各接続を使用するエージェントが表示されるため、変更の影響をすぐに確認できます。
## 次のステップ
同じ接続をプログラムで作成・管理します。
Google、Slack、HubSpot、Salesforce、Cal.com 向けの事前構築済み接続。
ツールサーバー全体をエージェントに公開します。
連携リソースのすべてのフィールド。