重要
この記事で "(プレビュー)" と付記されている項目は、現在、パブリック プレビュー段階です。 このプレビューはサービス レベル アグリーメントなしで提供されており、運用環境ではお勧めしません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。
プロンプト フロー Serp API ツールでは、Serp API Google Search Engine Results API と Serp API Bing Search Engine Results API に対するラッパーが提供されます。
このツールを使用すると、Google や Bing など、さまざまな多数の検索エンジンから検索結果を取得できます。 検索クエリ、場所、デバイスの種類など、さまざまな検索パラメータを指定できます。
[前提条件]
注
この機能には ハブ ベースのプロジェクト を使用する必要があります。 Foundry プロジェクトはサポートされていません。 「 自分が持っているプロジェクトの種類を確認する方法 」と 「ハブ ベースのプロジェクトを作成する」を参照してください。
- Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、無料アカウントを作成してください。
- ない場合は、 ハブ ベースのプロジェクトを作成します。
Serp API のホーム ページにサインアップします。
Serp 接続を作成するには:
Azure AI Foundry にサインインします。
[管理センター] >[概要] を選択して、プロジェクト設定に移動します
[接続されたリソース] で、[+ 新しい接続] を選びます。
[その他のリソースの種類] で、[Serp] を選びます。
Serp の API キーを追加し、接続名を作成します。 [接続の追加] を選択します。
接続は、Serp API との接続を確立するために使われるモデルです。 Serp API アカウント ダッシュボードから API キーを取得します。
| タイプ | 名前 | API キー |
|---|---|---|
| Serp | 必須 | 必須 |
Serp API ツールを使用してビルドする
Azure AI Foundry でフローを作成するか、開きます。 詳細については、「フローの作成」を参照してください。
[+ その他のツール]>[Serp API] を選択して、フローに Serp API ツールを追加します。
プロビジョニングされたリソースの 1 つへの接続を選択します。 たとえば、[Serp 接続] (この名前で接続を作成した場合) を選びます。 詳細については、「前提条件」を参照してください。
「入力」の表で説明されている Serp API ツールの入力パラメータの値を入力します。
必要に応じて、フローにさらにツールを追加します。 または、[実行] を選択してフローを実行します。
出力については、出力の表で説明します。
入力
次の入力パラメータを使用できます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| 問い合わせ | ひも | 実行する検索クエリ。 | イエス |
| エンジン | ひも | 検索に使う検索エンジン。 既定値は google です。 |
イエス |
| num | 整数 (integer) | 返す検索結果の数。 既定値は 10 です。 | いいえ |
| ロケーション | ひも | 検索を実行する地理的な場所。 | いいえ |
| 金庫 | ひも | 検索に使う安全な検索モード。 既定はオフです。 | いいえ |
出力
serpapi クエリからの JSON 表現:
| エンジン | 戻り値の型 | アウトプット |
|---|---|---|
| グーグル | JSON | サンプル |
| Bing | JSON | サンプル |