Skip to main content
API接続は、会話中にエージェントが呼び出せるカスタムHTTP関数です。注文の検索、チケットの作成、自社バックエンドからのアカウントステータス取得などに使用できます。エンドポイントは 接続 → API (/dashboard/api-connections) で一度定義します。接続が追加されているエージェントは、会話の状況に応じていつでも呼び出せます。 作成方法は2つあります。ウィザードで分析できる内容を貼り付けるか、接続を手動で設定します。

最短手順:貼り付けて分析

1

新しいAPI接続をクリック

ダイアログがウィザードで開きます。サンプルのcURLコマンドOpenAPI/Swagger仕様PostmanエクスポートTypeScript インターフェース、またはZodスキーマをボックスに貼り付けます。
2

分析をクリック

ThunderPhoneは、貼り付けた内容から接続全体を推論します。URL、 メソッド、ヘッダー、検出したクエリパラメータとリクエスト本文から導出した パラメータスキーマが含まれます。貼り付けたヘッダー(認証ヘッダーを含む)は、 エンドポイント設定に引き継がれます。
3

ハイライトされたフィールドを確認

推論された設定が開き、推測されたフィールドが確認用にハイライトされます。 エージェントが関数をいつ、どのように呼び出すかを理解できるよう、名前、説明、 パラメータタイプを調整します。モデルが読むのは説明です。
4

検証して保存

保存時には、まずエンドポイントに対してライブテストリクエストが実行されます。 リクエストが失敗した場合、接続は保存されません。URL、認証ヘッダー、または本文を 修正して再試行してください。成功すると、接続は検証済みバッジ付きで保存されます。
ウィザードが貼り付けた内容からリクエストURLを見つけられない場合は、その旨が表示されます。 完全なhttp(s)エンドポイントを含めて、再試行してください。

手動設定

ウィザードで**手動で設定 →をクリックします(戻る場合はAIに推論させますか? ウィザードを試す →**をクリック)。手動ビルダーには2つのエディターがあります。
  • ビジュアル — 表示名、関数名、リクエスト URLメソッドPOSTGETPUTPATCHDELETE)、カスタム ヘッダー、パラメータスキーマ(エージェントが指定できる引数ごとにプロパティを追加)のフォームフィールド。
  • JSON — ツール仕様を直接貼り付けたり微調整したりするための、生のJSONによる同じ定義。
任意のテストリクエストパネルでは、保存前に設定したリクエストを実行し、 ステータス、レイテンシー、レスポンスプレビューを確認できます。 検証して保存では常にこのテストが実行され、成功した場合のみ保存されます。
パラメータには平易な説明を付けてください(「顧客のメールアドレス。 例:jane@example.com」)。エージェントは通話中にリアルタイムで、これらの説明に基づいて 引数を選択します。

接続を管理

各接続行には、検証ステータス(検証済み未テスト、またはエラー)、 関数名、その接続を使用しているエージェントが表示されます。行のアクションメニューから、次の操作を行えます。
  • 編集 — 設定を再度開きます。
  • 複製 — 開始点として複製します(コピーは未テストの状態で開始します)。
  • リビジョン履歴 — 以前のバージョンを表示し、1つをエディターに復元します。
  • 転送 — 所属する別の組織に接続をコピーまたは移動します。移動するとここから削除され、 使用していたエージェントは再設定が必要になる場合があります。
  • 削除 — 完全に削除されます。接続を使用しているエージェントは再設定が必要になります。

エージェントに追加

ビルダーのAPI接続セクションでエージェントに接続を追加します (エージェントを構築)。リストには各接続を使用しているエージェントが表示されるため、 変更の影響範囲を一目で確認できます。

次のステップ

API によるツール連携

同じ接続をプログラムで作成・管理します。

アプリを接続

Google、Slack、HubSpot、Salesforce、Cal.com 向けの事前構築済み接続。

MCP サーバーを追加

ツールサーバー全体をエージェントに公開します。

連携 API リファレンス

連携リソースのすべてのフィールド。