Bing カスタム検索ツールによるグラウンディングを使って、Azure AI エージェントは構成可能なパブリックウェブドメインのセット内で情報を探すことができます。 これにより、ユーザーが選択したドメインとサブドメインからの関連する結果のみを表示できるように、描画する Web の部分を定義できます。 最初に、Azure portal で Bing Custom Search リソースを使用して Grounding を作成する必要があります。
リソースがデプロイされたら、Azure AI Foundry ポータルで [構成] に移動し、ユーザーが関心を持つ Web サイトからのコンテンツのみを含む構成インスタンスを作成します。 カスタム構成を作成する方法については、「 セットアップ」セクションを参照してください。
ツールが構成されたら、それを Azure AI エージェントに接続できます。 ユーザーがクエリを送信すると、エージェントは、Bingカスタム検索を使用して Grounding を利用するかどうかを決定します。 その場合は、Bingを使用して指定したドメインを検索し、関連するチャンクを返します。 最後に、Azure AI エージェントは返されたチャンクを使用して、ユーザーに返す応答を生成します
Von Bedeutung
- Bingカスタム検索で Grounding を使用すると、コストが発生する可能性があります。 詳細については、価格ページを参照してください。
- Azure CLI などのコードファースト エクスペリエンスを使用して Bing Custom Search リソースを使用して Grounding を作成して使用したり、デプロイ テンプレートを使用してデプロイしたりすることで、定期的に更新される可能性のある 使用条件に従うことに同意したものと見なされます。
- Bing Custom Search で Grounding を使用すると、顧客データは Azure コンプライアンス境界の外部から Bing Custom Search サービスを使用して Grounding に転送されます。 Bing Custom Search を使用したグラウンド処理は、同じデータ処理用語 (処理場所を含む) の対象ではなく、「Bing Custom Search Terms of Use でのグラウンド処理」で説明されているように、Azure AI Foundry Agent Service と同じコンプライアンス標準と認定資格を持ちません。 エージェントでの Bing Custom Search での Grounding の使用がニーズと要件を満たしているかどうかを評価するのは、お客様の責任です。
Bing Custom Search を使用した典拠のしくみ
ユーザー クエリは、エンド ユーザーがエージェントに送信するメッセージです 。たとえば、"使用可能なウォーター ボトルは何ですか?(Contoso 製品 Web サイトへのインスタンスを作成すると仮定します)。 命令は、開発者がコンテキストを共有し、さまざまなツールの使用方法や動作に関する指示を AI モデルに提供するために提供できるシステム メッセージです。
ユーザーがクエリを送信すると、顧客の AI モデル デプロイは、(提供された手順を使用して) 最初にクエリを処理し、後でカスタム検索クエリ (開発者に表示される) Bingを実行します。 Bing カスタム検索を用いた基盤整備により、関連する検索結果が顧客のモデルデプロイメントに返され、最終的な出力が生成されます。
注
Bingカスタム検索で Grounding を使用すると、Bingカスタム検索クエリ、構成インスタンス、ツール パラメーター、およびリソース キーがBingに送信され、エンド ユーザー固有の情報は含まれません。 リソース キーは、請求とレート制限の目的でのみ Bing に送信されます。
承認は、Bing Custom Search サービスを使用した Grounding と Azure AI Foundry Agent サービスの間で行われます。 Bingに対して生成および送信される Bing Custom Search クエリは、リソース キーと構成インスタンスとともに、Azureコンプライアンス境界外に移され、Bing Custom Searchサービスを用いて根拠付けのために処理されます。 Bing Custom Searchによるグラウンディングは、Bingの利用規約の対象であり、「Bingカスタム検索のグラウンディング利用規約」に記載されているように、Azure AI Foundry Agent Serviceと同じコンプライアンス基準と認証を持っていません。 エージェントでの Bing Custom Search での Grounding の使用がニーズと要件を満たしているかどうかを評価するのは、お客様の責任です。
開発者とエンド ユーザーは、Bing Custom Search を使用して Grounding から返された生コンテンツにアクセスできません。 ただし、モデルの応答には、応答の生成に使用される Web サイトへのリンクを含む引用が含まれており、Agents Service によって提供されるメカニズムを使用して保存できます。 作成されたスレッド内のデータにアクセスすることで、モデルの応答を取得できます。 これらの参照は、Grounding with Bing カスタム検索の使用と表示の要件に従って、Microsoft が提供する正確な形式で保持して表示する必要があります。
設定
注
Azure OpenAI モデルは、Bingカスタム検索でのグラウンド処理でのみ使用できます。
クイックスタートの手順に従って、Azure AI エージェントを作成します。
Azure portal でカスタム検索リソースBing使用して Grounding を作成します。 作成するには、サブスクリプションまたはリソース グループに所有者ロールまたは共同作成者ロールが必要です。 Azure AI エージェント、AI プロジェクト、その他のリソースと同じリソース グループ内に、Bing Custom Search リソースを使用して、この Grounding を作成してください。
Bing Custom Search リソースを使用して Grounding を作成したら、構成インスタンスを作成できます。
Bing Custom Search を使用した典拠リソースに移動する
左側のパネルで [ リソース管理 ] を選択します。
[構成] を選択します。
[ 新しい構成の作成] を選択します。
構成を作成または更新する場合は、次の情報を入力します。
構成の名前。 これはいつでも変更できます。
URL を含めて、次のフィールドの少なくとも 1 つに検索スライスを定義します。
注
Bingカスタム検索を使用したグラウンド処理では、パブリックであり、Bingによってインデックスが作成されたドメインと Web ページの結果のみが返されます。
- ドメイン (たとえば、
https://www.microsoft.com
) - ドメインとパス (例:
https://www.microsoft.com/surface
) - Web ページ (例:
https://www.microsoft.com/en-us/p/surface-earbuds/8r9cpq146064
)
検索対象の許可されているドメイン。 許可されるドメインの場合、サブページを含める場合は、ドメインに最大 2 レベルのサブページがあることを確認してください。
検索スペースから除外するブロックされたドメイン。
- ドメイン (たとえば、
サブページを含めるかどうかを決定します。 サブページ スライスはドメイン パスを指定します。 Bingは、パスの下にあるすべてのコンテンツを検索します。 パスには、最大 2 つのサブフォルダーを指定できます。 たとえば、
www.microsoft.com/windows/
のようにします。必要に応じてランク付けを調整します。
Azure AI Foundry ポータルでエージェントの[エージェント]画面に移動し、右側の[セットアップ]ペインを下にスクロールして知識に移動してください。 その後、追加を選択します。
[Grounding with Bing Custom Search ツール] を選択します。
選択して新しい接続を作成するか、既存の接続を使用します
- 新しい接続の場合は、Bing Custom Search リソースを使用して Grounding を選択します。
リソースに接続したら、構成名を選択します。
ツールを保存し、エージェントとのチャットを開始します。
カスタム検索の構成機能
Bing Custom Search を使用した典拠は、エージェントの基礎知識を制限するために Web のサブスペースを選択できる強力なツールです。 ここでは、この機能を最大限に活用する方法に関するいくつかのヒントを見つけることができます。
Bingがインデックスしていないが、検索に含めたいパブリックサイトを所有している場合、サイトのインデックス作成方法の詳細については、Bingウェブマスタードキュメントを参照してください。 Webマスター用のドキュメントでは、インデックスが古い場合にBingにサイトをクロールさせる方法に関する詳細も説明しています。
特定のドメインのみをブロックし、Web の残りの部分 (競合他社のサイトなど) に対して検索を実行できます。
省略可能なパラメーター
Bingカスタム検索ツールを使用して Grounding をエージェントに追加する場合は、次のパラメーターを渡すことができます。 これらのパラメーターは、Bing Custom Search ツールの出力によるグラウンディングに影響を与え、AI モデルではすべての出力が完全に使用されない場合があります。 API バージョンのサポートとこれらのパラメーターを渡す方法については、 コード例 を参照してください。
名前 | 価値 | タイプ | 必須 |
---|---|---|---|
count |
応答で返される検索結果の数。 既定値は 5 で、最大値は 50 です。 実際に配信される数は、要求された数より少ない場合があります。 結果に複数のページが重複している可能性があります。 このパラメーターは、Web ページの結果にのみ影響します。 AI モデルでは、Bingによって返されるすべての検索結果が使用されない可能性があります。 | UnsignedShort |
いいえ |
freshness |
次の大文字と小文字を区別しない年齢値で検索結果をフィルター処理します。 日: Bing が過去 24 時間以内に検出したウェブページを返します。 週: 過去 7 日以内にBingが検出したWebページを返す。 月: Bing が過去 30 日以内に発見した Web ページを返します。 特定の期間にBingによって検出された記事を取得するには、日付範囲を " YYYY-MM-DD..YYYY-MM-DD " という形式で指定します。 たとえば、freshness=2019-02-01..2019-05-30 のようにします。 結果を 1 つの日付に制限するには、このパラメーターを特定の日付に設定します。 たとえば、freshness=2019-02-04 のようにします。 |
糸 | いいえ |
market |
結果の出所となる市場。 通常、 mkt は、ユーザーが要求を行っている国です。 ただし、Bingが結果を提供する国にユーザーがいない場合は、別の国になる可能性があります。 市場は、 <language>-<country/region> の形式である必要があります。 たとえば、en-US のようにします。 文字列では大文字と小文字が区別されません。 使用可能な市場価値の一覧については、「 市場コード」を参照してください。 既知の場合は、常に市場を指定することをお勧めします。 市場を指定すると、Bing要求をルーティングし、適切で最適な応答を返すのに役立ちます。 市場コードに記載されていない市場を指定した場合、Bingは変更される可能性がある内部マッピングに基づいて最適な市場コードを使用します。 |
糸 | いいえ |
set_lang |
ユーザー インターフェイス文字列に使用する言語。 言語は、2 文字または 4 文字のコードを使用して指定できます。 4 文字のコードを使用することをお勧めします。 サポートされている言語コードの一覧については、サポートされている 言語Bing参照してください。 Bing、有効な 2 文字のニュートラル カルチャ コード ( setlang ) または有効な 4 文字の固有カルチャ コード (fr ) がfr-ca に含まれている場合は、ローカライズされた文字列を読み込みます。 たとえば、 fr-ca の場合、Bing fr ニュートラル カルチャ コード文字列を読み込みます。setlang が有効でない (zh など) か、Bingが言語 (af 、af-na など) をサポートしていない場合は、Bing既定で en (英語) になります。2 文字のコードを指定するには、このパラメーターを ISO 639-1 言語コードに設定します。 4 文字のコードを指定するには、 <language>-<country/region> が ISO 639-1 言語コード (ニュートラル カルチャ) で、<language> が ISO 3166 国/地域 (特定のカルチャ) コードである<country/region> 形式を使用します。 たとえば、米国英語の en-US を使用します。省略可能ですが、常に言語を指定する必要があります。 通常、ユーザーがユーザー インターフェイス文字列を別の言語で表示する場合を除き、 setLang で指定した言語と同じ言語に mkt を設定します。 |
糸 | いいえ |