Bing検索による基礎固め

2025-06-17

Bing 検索を使用したグラウンディングによって、Azure AI エージェントが応答を生成するときに、リアルタイムのパブリック Web データを組み込むことができます。 Bing 検索を使用したグラウンディングリソースを作成し、このリソースを Azure AI エージェントに接続する必要があります。ユーザーがクエリを送信すると、Azure AI エージェントは Bing 検索を使用したグラウンディングを活用するかどうかを判断します。その場合、Bing を活用してパブリック Web データを検索し、関連するチャンクを返します。最後に、Azure AI エージェントは返されたチャンクを使用して応答を生成します。

"今日のトップニュースは何ですか" や "米国の小売業界の最新情報は何ですか?" など、リアルタイムのパブリックデータが必要な質問をすることができます。

開発者やエンドユーザーは、Bing 検索を使用したグラウンディングから返された生のコンテンツにアクセスすることはできません。ただし、モデルの応答には、応答の生成に使用される Web サイトへのリンクを含む引用文献と、検索に使用されるBing クエリへのリンクが含まれます。作成されたスレッド内のデータにアクセスすることで、 モデルの応答 を取得できます。これら 2 つの参照は、Bing Search の使用と表示の要件に従って、Microsoft が提供する正確な形式で保持および表示する必要があります。詳細については、Bing 検索を使用したグラウンディングの結果を表示する方法に関する記事を参照してください。

Von Bedeutung

Bing Search を使用したグラウンディングの使用には、コストが発生する場合があります。詳細については、価格ページを参照してください。
Azure CLI などのコード第一のエクスペリエンスを通じた Bing 検索を使用したグラウンディングリソースの作成および使用や、デプロイテンプレートを通じたデプロイにより、https://www.microsoft.com/en-us/bing/apis/grounding-legal (随時更新される可能性があります) で利用可能な条件にバインドされ、これに準拠することに同意するものとします。
Bing Search を使用したグラウンディングを使用すると、顧客データは、Azure コンプライアンス境界の外部にある Bing Search を使用したグラウンディングサービスに転送されます。 Bing Search を使用したグラウンディングは、同じデータ処理条件 (処理場所を含む) の対象ではなく、Azure AI Foundry Agent Service と同じ準拠基準と認証を持っていません。詳細は、Bing検索使用条件で説明されています。エージェントでの Bing Search を使用したグラウンディングの使用がニーズと要件を満たしているかどうかを評価するのは、お客様の責任です。

Bing Search を使用したグラウンディングのしくみ

ユーザークエリとは、エンドユーザーがエージェントに送信するメッセージです。たとえば、"シアトルにいます。今日は傘を持っていく必要がありますか" などです。指示は、開発者がコンテキストを共有し、さまざまなツールの使用方法や動作方法について AI モデルに指示を与えるために提供できるシステムメッセージです。

ユーザーがクエリを送信すると、顧客の AI モデルデプロイでは最初にそれを処理し (提供された指示を使用)、その後 Bing 検索クエリ (開発者に表示されます) を実行します。 Bing を使用したグラウンディングから、関連する検索結果が顧客のモデルデプロイに返され、最終的な出力が生成されます。

注

Bing検索で Grounding を使用する場合、Bing検索クエリ、ツールパラメーター、およびリソースキーのみがBingに送信され、エンドユーザー固有の情報は含まれません。リソースキーは、請求とレート制限の目的でのみ Bing に送信されます。

承認は、Bing Search サービスを使用した Grounding と Azure AI Foundry Agent Service の間で行われます。グラウンディングの目的で生成され、Bing に送信される Bing 検索クエリは、リソースキーと共に、Azure コンプライアンス境界の外部にある Bing Search を使用したグラウンディングサービスに転送されます。 Bing Search を使用したグラウンディング利用規約に規定されているように、Bing Search を使用したグラウンディングは、Bing の使用条件の対象にはならず、コンプライアンス標準および認定も Azure AI Foundry エージェントサービスと同じではありません。エージェントでの Bing Search を使用したグラウンディングの使用がニーズと要件を満たしているかどうかを評価するのは、お客様の責任です。

サポートされている機能と既知の問題

Bing 検索ツールを使用したグラウンディングは、特定の Web ドメインではなく、Web からリアルタイム情報を取得するように設計されています。
Web ページ全体を要約することはお勧めしません。
1 回の実行で、AI モデルはツールの出力を評価し、詳細とコンテキストのためにツールを再度呼び出す場合があります。 AI モデルでは、応答の生成に使用されるツール出力の部分を決定することもできます。
Azure AI エージェントサービスは 、AI モデルによって生成された応答 を出力として返します。そのため、エンドツーエンドの待機時間は、LLM の前処理/後処理に影響を与えます。
Bing Search ツールを使用した接地では、ツールの出力は開発者やエンドユーザーに返されません。

利用サポート

Azure AI Foundry のサポート	Python SDK	C# SDK	JavaScript SDK	REST API	基本エージェントのセットアップ	標準エージェントのセットアップ
✔️	✔️	✔️	✔️	✔️	✔️	✔️

設定

注

Bing Search を用いた統合は、Azure AI Foundry エージェントサービスがサポートするすべての Azure OpenAI モデルで動作します。ただし、を除きます。

クイックスタートの手順に従って、Azure AI エージェントを作成します。
Grounding with Bing Search のリソースを作成します。作成するには、サブスクリプションまたはリソースグループに owner または contributor のロールが必要です。
1. Azure portal でリソースを作成し、作成フォームで異なるフィールドを選択できます。この Bing 検索を使用したグラウンディングリソースを、Azure AI エージェント、AI プロジェクト、その他のリソースと同じリソースグループに作成してください。
1. コードファーストエクスペリエンスを使用してリソースを作成することもできます。その場合は、Bing Search を Azure リソースプロバイダーとして手動で登録する必要があります。リソースプロバイダーの /register/action 操作を実行できるアクセス許可が必要です。このアクセス許可は、共同作成者ロールと所有者ロールに含まれます。
```
    az provider register --namespace 'Microsoft.Bing'
```
Bing 検索を使用したグラウンディングリソースを作成したら、Azure portal で検索できます。リソースを作成したリソースグループに移動し、作成した Grounding with Bing Search リソースを検索します。

省略可能なパラメーター

grounding with Bing Search ツールをエージェントに追加すると、次のパラメーターを渡すことができます。これらのパラメーターは、Bing 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` を設定します。	糸	いいえ

Grounding with Bing Search の結果を表示する方法

Bing を使用したグラウンディングの使用条件と利用と表示の要件によると、カスタムインターフェイスに Web サイトの URL と Bing 検索クエリ URL の両方を表示する必要があります。 Web サイトの URL は API 応答の annotations パラメーターを通じて検索でき、Bing 検索クエリ URL は runstep の詳細を通じて検索できます。 Web ページをレンダリングするには、Bing 検索クエリ URL のエンドポイントを www.bing.com に置き換えることをお勧めします。Bing 検索クエリ URL は "https://www.bing.com/search?q={search クエリ" のように表示されます。

run_steps = project_client.agents.list_run_steps(run_id=run.id, thread_id=thread.id)
run_steps_data = run_steps['data']
print(f"Last run step detail: {run_steps_data}")

次のステップ

Bing ツールを使用したグラウンディングの使用に関するコードサンプルをプログラムで参照してください。