API接続
任意のHTTP APIを、エージェントが会話中に呼び出せる関数に変換します。cURLコマンドを貼り付けると、ウィザードがツール定義、パラメータ、認証を作成します。
API接続は、会話中にエージェントが呼び出せるカスタムHTTP関数です。注文の検索、チケットの作成、独自のバックエンドからのアカウントステータスの取得などに使用できます。エンドポイントは 接続 → API (/dashboard/api-connections) で一度定義すれば、その接続が追加されたエージェントは、会話の流れに応じていつでも呼び出せます。
作成方法は2つあります。ウィザードで解析できる内容を貼り付けるか、接続を手動で設定します。
最短の方法: 貼り付けて解析
- 新しいAPI接続をクリック
ダイアログがウィザードで開きます。サンプルの cURLコマンド、 OpenAPI/Swagger仕様、Postmanエクスポート、TypeScript インターフェース、または Zodスキーマをボックスに貼り付けます。
- 分析をクリック
ThunderPhoneが、貼り付けた内容から接続全体を推測します。URL、 メソッド、ヘッダー、および検出したクエリパラメータとリクエスト ボディから導出されたパラメータスキーマが含まれます。貼り付けたヘッダー （認証ヘッダーを含む）は、エンドポイント設定に引き継がれます。
- ハイライトされたフィールドを確認
推測された設定が開き、確認用に推定されたフィールドがハイライトされます。 エージェントが関数を呼び出すタイミングと方法を理解できるよう、名前、 説明、パラメータタイプを調整します。説明はモデルが読み取る内容です。
- 検証して保存
保存時にはまず、エンドポイントに対してライブテストリクエストが実行されます。 リクエストが失敗した場合、接続は保存されません。URL、認証 ヘッダー、またはボディを修正して再試行します。成功すると、接続は 検証済みバッジ付きで保存されます。
ウィザードが貼り付けた内容からリクエストURLを検出できない場合は、その旨が表示されます。完全な http(s) エンドポイントを含めて、もう一度試してください。
手動設定
ウィザードで 手動で設定 → をクリックします（戻るには AIに推測させますか？ ウィザードを試す → をクリック）。手動ビルダーには2つのエディターがあります。
- ビジュアル — 表示名、関数名、リクエスト
URL、メソッド（
POST、GET、PUT、PATCH、DELETE）、カスタム ヘッダー、およびパラメータスキーマのフォームフィールドです（エージェントが 指定できる各引数には プロパティを追加）。 - JSON — ツール仕様を直接貼り付けたり細かく調整したりするための、 生のJSONによる同じ定義です。
任意の リクエストをテスト パネルでは、保存前に設定済みのリクエストを 実行し、ステータス、レイテンシー、レスポンスプレビューを確認できます。 検証して保存 では常にこのテストが実行され、成功時のみ保存されます。
接続を管理
各接続行には、検証ステータス（検証済み、 未テスト、または エラー）、関数名、その接続を使用するエージェントが表示されます。 行のアクションメニューから、次の操作を実行できます。
- 編集 — 設定を再度開きます。
- 複製 — 開始点として複製します（コピーは未テストの状態で作成されます）。
- 改訂履歴 — 以前のバージョンを表示し、1つをエディターに復元します。
- 転送 — 所属する別の組織に接続をコピーまたは移動します。 移動すると、この組織からは削除されます。使用していたエージェントは再設定が必要になる場合があります。
- 削除 — 完全に削除されます。接続を使用しているエージェントは再設定が必要になります。
エージェントに追加
ビルダーのAPI接続セクションでエージェントに接続を追加します （エージェントを構築）。一覧には各接続を使用するエージェントが表示されるため、変更の影響をすぐに確認できます。