Microsoft Web IQ の使用に関する一般的な質問への回答。 API の詳細と要求の例については、 API リファレンスを参照してください。
サービスとデプロイ
Microsoft Web IQ とは
Microsoft Web IQ は、現在の関連する Web 情報へのアクセスを LLM、AI エージェント、アプリケーションに提供する、AI ネイティブ Web 検索およびグラウンディング API のスイートです。 これにより、ユーザーが検証できるソースを含む、より正確な up-to-date AI の回答が可能になります。 Web IQ は、Microsoft Copilot や ChatGPT などの最先端の AI アシスタントを支えています。
Web IQ は、 https://api.microsoft.ai/v3 の REST と https://api.microsoft.ai/v3/mcp の MCP を通じて利用できます。 現在使用可能な API は、Web Search、ニュース、ビデオ、画像、および Browse です。
自動 はベータ版で利用できます。
Web グラウンディングとは何ですか。また、AI エージェントがそれを必要とするのはいつですか?
Web grounding を使用すると、AI が最新の Web 情報にアクセスできるため、トレーニング データ以外の現在の事実を使用して、ユーザーが確認できる引用元を付けて回答できます。 これは、市場の発展、競合他社の活動、ニュース、規制の更新など、頻繁に変化する情報に最も役立ちます。
Web IQ は LLM ですか? 最終的な回答は生成されますか?
No. Web IQ は AI モデルまたは LLM ではありません。 これは、LLM、AI エージェント、およびアプリケーションに現在の関連する Web 情報へのアクセスを提供する、AI ネイティブ Web 検索およびグラウンディング API のスイートです。
Web IQ では、最終的な AI 回答は生成されません。 Web から関連情報を取得し、選択した LLM、AI エージェント、またはアプリケーション ロジックがその証拠を使用して応答を生成します。
Web IQ が他の Web 検索 API やグラウンディング サービスと異なる理由
ほとんどの Web 検索 API では、速度か正確さ、コスト効率か完全性のトレードオフを迫られます。 Microsoftの公開された比較では、Web IQは、最高のグラウンディング満足度、最速の速度、およびクエリあたりのトークン数の最少を実現しています。 これは、Copilot や ChatGPT などの AI アシスタントが毎日依存しているのと同じプラットフォームであり、世界規模で実証されており、あらゆる AI エージェントやアプリがその上に構築できる状態が整っています。
Web IQ は、コンテンツへのアクセス方法によっても区別されます。 Web アクセスに対して責任あるアプローチを取り、エンタープライズ レベルのセキュリティと保護が組み込まれたオープン Web と構造化データを統合します。
Web IQ は、既に使用している AI スタックで動作します。 好みの AI モデルを使用し、1 つのモデルまたはプラットフォームに縛られることなく、REST API またはモデル コンテキスト プロトコル (MCP) 経由で接続できます。
ソース: Web IQ ベンチマークの結果 (品質、効率、速度のセクション)。
Web IQ を使用して何を構築できますか?
Web IQ は、パブリック Web からの新しい外部情報を必要とする AI エージェントとアプリケーションを支えます。 内部チームは、競合インテリジェンス、監視、規制調査、営業インテリジェンス、コンテンツの最適化に使用できます。 顧客向けのエクスペリエンスは、調査、発見、推奨事項、および専門エージェントに使用できます。
これは、情報が頻繁に変化し、多数の外部ソースにまたがるシナリオに最適であり、最新で出典を示せる Web コンテンツに基づく必要があります。
ユース ケースに適した Web IQ API はどれですか?
Web Search API を使用してモデルに関連する公開ページや抜粋を見つけ、現在のイベントには News API、ビジュアルおよび動画の結果には Images API と Videos API、URL がすでにわかっている場合には Browse API を使用します。 アカウントで使用できる機能と制限については、API リファレンスを確認してください。
既存の AI モデルとエージェント フレームワークで Web IQ を使用できますか?
Yes. Web IQ を使用すると、選択した AI モデルとエージェント ワークフローに Web 情報を追加できます。 REST API と MCP を使用すると、それをどのように接続するかを柔軟に選べます。 サポートされている構成については、SDK と MCP 統合ドキュメントを参照してください。
統合とはどのようなものですか?
AI エージェントまたはアプリケーションは Web IQ を呼び出して Web 上の根拠情報を探し、選択した結果をモデルに渡して応答を生成します。 あなたは情報の選択、使用、および引用方法を制御します。 クイック スタートに従って最初のワークフローを接続するか、Playground の使用を開始します。
Web IQ は非公開の企業情報を取得できますか?
No. Web IQ は、パブリック Web 情報を取得します。 エンタープライズ コンテキストでは、Microsoftは Work IQ、Fabric IQ、Foundry IQ を提供し、それぞれ組織コンテキスト、ビジネス データ、エンタープライズ ナレッジにまたがって異なる役割を果たします。
Web IQ は Foundry IQ、Work IQ、および Fabric IQ とどのように関連していますか?
Microsoft IQ は、Microsoft全体のエンタープライズ インテリジェンスを支える 4 つの統合レイヤーをまとめます。 Web IQ は、パブリック Web からの情報を提供します。 Work IQ は業務シグナルに、Fabric IQ はビジネス データに、そして Foundry IQ は組織の知識に重点を置いています。 これらの製品は、AI エージェントとアプリケーションのさまざまな情報ニーズに対応し、一緒に使用する場合に最も強力です。
Web IQ はAzureリソースですか?
Azure サブスクリプションに Web IQ リソースをデプロイします。 リソースは、ID、使用状況測定、課金を処理します。
サービス自体は、Microsoft によってホストされ、マルチテナントです。 Web の取得とランク付けはMicrosoftインフラストラクチャで実行され、アプリケーションは api.microsoft.aiを HTTPS 経由で呼び出します。 Azure リソースは Web IQ をホストせず、要求パスにありません。
Web IQ はどこにデプロイされますか?
Web IQ は Microsoft によってホストされ、パブリック https://api.microsoft.ai/v3 エンドポイント経由で使用できます。 アプリケーションが API を呼び出し、Web IQ がサーバー側で Web 取得を実行します。
財務、スポーツ、または天気用の専用 API はありますか?
今日はできません。 専用 API は、Web Search、ニュース、ビデオ、画像、および Browse です。 財務、スポーツ、天気、および専用 API がないその他の対象については、関連するクロールされたコンテンツを返す Web Search を使用します。 そのコンテンツは、構造化フィードではなく、非構造化ページ テキストです。
アクセスとオンボーディング
評価から運用環境に移行するにはどうすればよいですか?
- 評価を完了し、サービスが要件を満たしていることを確認してください。
- Azure サブスクリプションが Web IQ に対して有効になっている。
- そのサブスクリプションに Web IQ リソースをデプロイし、Web IQ カスタマー サイトにサインインしてリソースを接続してください。 これにより、運用 AppID が作成されます。既定の上限である 1 秒あたり 15 クエリ (QPS) から始まります。
- Entra IDで認証するには、Web IQ カスタマー サイトのその AppID 項目にアプリケーションのクライアント ID を追加します。
お客様の Web IQ の使用は、既存の Microsoft 顧客契約 の枠組みにおいて、Web IQ 使用条件に準拠します。
どのAzureサブスクリプションを使用できますか?
Web IQ には有料のAzure サブスクリプションが必要です。 Azure クレジットは Web IQ では機能しません。
サインインに使用する必要があるアドレスはどれですか?
Web IQ にアクセスできる Microsoft サインイン アドレス (Microsoft が有効にしたアドレス、または Web IQ カスタマー サイトで Web IQ リソースの接続に使用したアカウント) を使用します。 これは通常、Azure、Teams、または Office に使用するアドレスであり、メールボックスのアドレスとは異なる場合があります。
確認するには、Azure ポータルにサインインし、右上隅に表示されるアドレスを確認します。
サインインすると、アクセス権がないと表示されるのはなぜですか?
まず、Azure portal の右上隅に表示されているアドレスが、Web IQ にアクセスできるアドレスと正確に一致することを確認します。 組織では、多くの場合、1 つのアドレスをMicrosoftサインインに使用し、もう 1 つのアドレスを電子メールに使用します。
アドレスが一致する場合、お客様の組織は、Microsoft Corporation テナントへのテナント間ゲスト アクセスをブロックする可能性があります。 そのアクセスを許可するように IT 管理者に依頼してください。
助けはどこで得られますか?
製品のサポートについては、Microsoft Web IQ サポート サイトを参照してください。 許可されている使用、プライバシー、ストレージ、または表示に関する質問については、現在の Web IQ Terms of Use と該当する顧客契約を参照してください。
API 認証
どのような認証方法がサポートされていますか?
Web IQ でサポートされる機能:
- OAuth 2.0 クライアント資格情報フローを通じて Microsoft Entra ID のベアラー トークン 運用環境のワークロードにはこれをお勧めします。
-
x-apikeyリクエストヘッダーで送信される API キー。
すべての API トラフィックで HTTPS が使用されます。
サーバー間認証を構成する方法
Microsoft Entra IDにアプリケーションを登録し、OAuth 2.0 クライアント資格情報フローを使用します。 Web IQ カスタマー サイトの Web IQ AppID にアプリケーションのクライアント ID を追加し、アクセス トークンを取得して、 Authorization: Bearer <access_token>として送信します。
完全なセットアップ手順については、「認証」を参照してください。
独自の API キーを管理できますか?
Yes. Web IQ カスタマー サイトから必要な数の API キーを作成できます。 キーの作成には料金はかかりません。
Web IQ は API 認可に Azure RBAC を使用しますか?
No. Web IQ は、インターネット経由で呼び出すMicrosoftホスト型サービスです。 Azure サブスクリプションにデプロイした Web IQ リソースは ID、使用状況測定、課金を処理しますが、要求パスには含まれていないため、Azure RBAC ロールを割り当てる対象のサービス リソースはありません。
Web IQ は、AppID ごとにリクエストを承認します。 各 AppID には独自のコンテンツ適格性プロファイルとクォータがあり、承認されていない呼び出しでは HTTP 403 が返されます。 異なるアクセス ポリシーやクォータなど、チームまたはワークロードを分離するには、複数の AppID を使用します。
1 つの Entra ID を複数の AppID から呼び出すことができますか?
Yes. 1 つの Entra アプリケーション (クライアント) ID は、1 つ以上の AppID を呼び出すことが承認される場合があります。 AppID を指定するには、たとえば https://api.microsoft.ai/v3/search/web?appid=<AppID> のようにクエリ パラメーターとして渡します。 API は AppID を次のように解決します。
- Entra IDは 1 つの AppID にバインドされます: AppID を指定しない場合、またはその AppID を指定した場合、要求は成功します (HTTP 200)。 別の AppID を指定すると、要求は HTTP 403 を返します。
- Entra IDは複数の AppID にバインドされています。1 つを指定する必要があります。 AppID が見つからないか空白の場合、HTTP 400 が返されます。バインドされた AppID の 1 つでは成功します (HTTP 200)。その他の AppID は HTTP 403 を返します。
- Entra IDはどの AppID にもバインドされていません。要求は HTTP 401 を返します。
API キー認証 (x-apikey) は影響を受けません。 各 API キーは 1 つの AppID にバインドされるため、キー認証呼び出しに ?appid= は必要もなく、受け付けられもしません。
ホストされるエージェントでは、マネージド ID と AgentID のどちらの認証を使用すべきですか。
どちらでも問題ありません。 マネージド ID と AgentID はどちらも Entra ID の ID であり、Web IQ は、Web IQ カスタマー サイトのプロファイル管理ページからアプリケーション (クライアント) ID が Web IQ アプリケーション プロファイルにリンクされている任意の Entra ID の ID を受け入れます。
どちらを使用するかは、エージェントがホストされている場所によって異なります。
- マネージド ID は、Foundry、App Service、Container Apps、AKS、Functions、VM など、Azureインフラストラクチャで実行されるエージェントに適合します。 システム割り当て ID とユーザー割り当て ID の両方が機能します。
- AgentID は、エージェント ID を公開する Foundry または Copilot Studio ホスト型エージェントに適しています。
- 独自の Kubernetes クラスターや別のクラウドなど、Azureの外部でホストされているエージェントは、クライアント シークレットまたはフェデレーション資格情報で標準の Entra アプリケーション登録を使用できます。
どの場合も、呼び出しは OAuth 2.0 クライアント資格情報フローを使用し、トークンをAuthorization: Bearer <access_token>として送信します。 セットアップ手順については、「認証」を参照してください。
x-apikey ヘッダーの API キーは、プロトタイプでは引き続きより簡単な選択肢です。
ネットワークとセキュリティ
Web IQ は、Private Link、プライベート エンドポイント、VNet 統合、または IP 許可リストをサポートしていますか?
No. 現時点では、これらのいずれもサポートされていません。 Web IQ は、Entra IDまたは API キー認証を使用して HTTPS 経由で単一のパブリック エンドポイント (https://api.microsoft.ai/v3) 経由でアクセスされます。 API エンドポイントに IP ベースのアクセス制御はありません。
Azure サブスクリプションの Web IQ リソースは ID、測定、課金を処理しますが、要求パスには含まれていないため、Private Link、VNet 統合、Azure Firewall、NSG、ハブアンドスポーク トポロジなどの Azure ネットワーク制御は、Web IQ 側には接続先がありません。 ID 管理 (Entra ID) 統合は Azure に準拠しています。ネットワーク レイヤーは準拠していません。
お客様側で、エグレス コントロールで api.microsoft.ai ホスト名を許可してください。
Azureから Web IQ へのトラフィックは、Microsoft のネットワーク(Azure バックボーン)にとどまりますか?
これは保証されません。 クライアントはパブリック https://api.microsoft.ai エンドポイントに接続し、トラフィックは HTTPS を使用して転送中にセキュリティで保護されます。
Web IQ API トラフィックは、次の暗号スイートで TLS 1.2 と TLS 1.3 をサポートする Azure Front Door で終了します。
-
TLS 1.3:
TLS_AES_256_GCM_SHA384、TLS_AES_128_GCM_SHA256 -
TLS 1.2:
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384、TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
Zscaler または別のエグレス検査ツールが Web IQ に干渉しますか?
api.microsoft.aiへの接続を許可するように構成されている場合は、干渉しないはずです。 これは標準の許可リスト アクションであり、広範なバイパスではありません。 Netskope などの他のセキュア Web ゲートウェイにも同じ方法が適用されます。
Web IQ をAzure API Managementの後ろに配置できますか?
Yes. 可観測性とガバナンスのために、独自の Azure サブスクリプションに Azure API Management または別のゲートウェイを Web IQ の前に配置できます。また、既知の阻害要因となる制限はありません。 API 呼び出しは、呼び出し元からhttps://api.microsoft.ai/v3へ、TLS 上で API キーまたは Entra ID トークンを使用して送信されるため、そのトラフィックの前に配置するものはテナント内の独自のインフラストラクチャになります。 Microsoft では、これらのデプロイの参照アーキテクチャは公開されません。クラウド アーキテクチャ チームがその設計を担当します。
Web IQ Terms of Use では、ゲートウェイの動作に関係なく、応答コンテンツをキャッシュまたは保存して派生データセットを構築することはできません。 状態、待機時間、ヘッダー、トレース ID などの運用テレメトリは、たとえば Application Insights や Log Analytics で保持される場合があります。
どのようなセキュリティ制御を使用できますか?
- 認証: Entra ID (OAuth 2.0 クライアント資格情報) または API キー。
- 認可: API への AppID ごとのアクセス。 未承認の呼び出しは HTTP 403 を返します。
- レート制限: AppID ごとのクォータの強制。 制限を超える要求は HTTP 429 を返します。
- 転送: HTTPS のみ。
境界のネットワーク ポリシーはお客様の責任です。 特定のアーキテクチャ要件の評価をご希望の場合は、Web IQ サポートにお問い合わせください。
レート制限と API キー
レート制限はありますか?
Yes. 各 Web IQ リソースの既定の制限は、1 秒あたり 15 クエリ (QPS) です。 この制限は、リソースの接続時に作成された AppID に適用され、その AppID は Web IQ カスタマー サイトに表示されます。
この制限は、すべての API キーとその AppID の Entra ID クライアント全体で共有されます。 制限を超える要求は HTTP 429 を返します。
レート制限を引き上げることはできますか?
Yes. 各 Web IQ リソースは 15 QPS から始まります。 より高い制限を要求するには、予想されるトラフィックとユース ケースについて Web IQ サポート にお問い合わせください。
いくつの API キーを作成できますか?
アプリケーションで必要な数のキーを作成できます。 キーの作成は無料ですが、1 つのリソースのすべてのキーでレート制限が共有されます。
プライバシーとデータの処理
Web IQ は API クエリをログに記録しますか?
Yes. API 要求は、サービスの信頼性、デバッグ、品質の向上という運用上の目的でログに記録されます。 これはMicrosoft サービスの標準です。
- アクセスは、承認されたMicrosoftエンジニアリングおよび運用担当者に制限され、Microsoftの内部アクセス制御ポリシーによって管理されます。 ログ内のデータには、他の顧客や第三者がアクセスすることはできません。
- ログはMicrosoftの運用インフラストラクチャに格納され、ロールベースのアクセス制御や監査証跡など、Microsoftの標準的なセキュリティ制御の対象となります。
- ログは転送中 (HTTPS) で暗号化され、保存時にも Microsoft の標準的な暗号化プラクティスを使用して暗号化されます。
Microsoftは、Microsoftプライバシーに関する声明に基づき、データ管理者として位置付けられます。
クエリはどのくらいの期間保持されますか?
クエリ テレメトリの保持は、Web IQ 使用条件のセクション 4 によって規定されており、これにより Microsoft による処理は Microsoft プライバシー ステートメントの適用対象となります。 プライバシーに関する声明に記載されている内容を超えて、Web IQ 固有の保持コミットメントは別途ありません。
規制されたワークロードまたは機密性の高いワークロードのクエリ ログを無効にすることはできますか?
クエリ テキストは標準要求テレメトリの一部としてキャプチャされ、その処理は、Microsoftプライバシーに関する声明および Web IQ 使用条件のセクション 4 によって管理されます。
特定の規制またはコンプライアンス ドライバーがある場合、Web IQ ではZero Query Loggingが提供され、テレメトリからのクエリ テキストが抑制されます。 セルフサービス機能ではありません。利用案件ごとに個別にレビューおよび承認され、すべてのアプリケーションに適用することも、特定のアプリケーションにのみ適用することもできます。 要求するには、Microsoft アカウント チームに連絡して次を共有してください:
- 適用される規制またはコンプライアンスフレームワーク (GLBA、HIPAA、GDPR、APPI など)。
- デプロイ シナリオの簡単な説明。
Web IQ ではどのようなデータレジデンシーへの取り組みを提供していますか?
今日はなし。 Web IQ では、リージョン固有のデータ レジデンシーやリージョン内処理のコミットメントを提供せず、使用可能な最も近いエンドポイントへのリージョン間ルーティングは想定される動作です。 プライバシーには、Microsoft プライバシーに関する声明が適用されます。
Web IQ は、Azure データ保護補遺または EU データ境界の対象ですか?
No. Web IQ 利用規約のセクション 4.1 では、本サービスをMicrosoft製品およびサービス データ保護補遺の適用対象から除外しています。
代わりに、Microsoftおよびお客様は、利用規約 (セクション 4.4) に基づいて処理されるすべての個人データの独立したデータ管理者として機能します。 Microsoftの処理は、Microsoftプライバシーに関する声明 (セクション 4.2) に準拠しており、エンド ユーザーに適切な通知を行う責任があります。
国際移転の場合、利用規約には、必要に応じて標準契約条項が組み込まれます (セクション 4.6.1)。 この転送メカニズムは、データ保護補遺ではなく、Microsoft 顧客契約の下にある利用規約を経由します。
Web IQ は現在、EU データ境界、リージョン固有のデータ レジデンシー、またはリージョン内処理について約束していません。
Web IQ はクエリで個人データを検出またはマスクしますか?
No. Web IQ では、受信クエリ内の個人データのサーバー側の検出またはマスキングは実行されません。 ワークロードが個人データまたは機密データを送信する可能性がある場合は、Web IQ を呼び出す前にスクラブします。たとえば、前処理ステップとして Azure AI Language PII Detection を使用します。 そうすることで、機密性の高いものは何も環境から離れないため、API に到達するものを完全に制御できます。
Web IQ は規制対象の業界をサポートしていますか?
Yes. Web IQ は、さまざまなエンタープライズおよび規制対象のユース ケースをサポートします。 特殊なコンプライアンス、ガバナンス、または業界の要件がある場合は、 Web IQ サポートにお問い合わせください。
コンテンツの安全性とカバレッジ
どのようなコンテンツ安全管理が適用されますか?
Web IQ では、クロール時の品質と安全性の分類、成人コンテンツのフィルター処理、顧客ごとのコンテンツ適用可否ルールが適用されます。 SafeSearch は、strict で既定でサーバー側により適用されます。 Web 検索結果には、クライアント側の追加処理用の isAdult フィールドも含まれます。
Web IQ は、取得されたコンテンツ内のプロンプトインジェクションから LLM を保護しますか?
Microsoft Web IQ は、Web からコンテンツを取得してランク付けします。取得したコンテンツに埋め込まれた命令を実行、解釈、またはその命令に基づいて動作することはありません。 Web IQ は、Bing の既存の品質、信頼性、スパム、および悪意のあるコンテンツのスクリーニングを使用して、この検索動作を補完します。
間接的なプロンプト挿入、脱獄の試行、命令に従った攻撃に対する保護は、主にダウンストリーム モデルとオーケストレーションレイヤーの責任です。 プロンプトと取得したコンテンツを信頼できない入力として扱い、プロンプト シールド、Azure AI Content Safety、システム プロンプトの分離、最小特権ツール アクセス、グラウンド検証、出力検証などの階層化されたコントロールを適用します。 Web IQ は、プロンプトインジェクション軽減のための唯一の適用箇所として扱うべきではありません。
Web IQ から返される前に Web コンテンツはどのように処理されますか? プロンプトのような指示に対してサニタイズされていますか?
Microsoft Web IQ は、取得時に生のページ HTML では直接動作しません。 インデックス作成中、Web コンテンツは、意味のあるコンテンツとドキュメント構造を維持するように設計された構造化されたドキュメント表現に正規化されます。 Web IQ によって返されるパッセージはその表現から選択され、それによって API サーフェス全体でより一貫性のある抽出と取得が可能になります。 Bingの既存の品質、安全性、スパム、悪意のあるコンテンツのスクリーニングも、インデックス作成パイプラインの一部として適用されます。
この正規化は、プロンプトのようなテキストが識別または削除されることを保証するものとして解釈しないでください。 取得したコンテンツを信頼できない入力として扱い、前の回答で説明したモデル層とオーケストレーション層の保護を適用してください。
Web IQ は非表示またはユーザー向けでないページ コンテンツを返しますか?
Microsoft Web IQ は、通常のページ コントロールやクライアント側のレンダリングによって表示されるコンテンツを含め、通常のユーザー操作によって表示されるコンテンツを返そうとします。 これは保証されません。 ページの構造と実装は異なるため、アプリケーションでは、返されるすべてのパッセージがページの初期状態で表示されていた、または非表示のすべての要素が常に除外されると想定すべきではありません。
Microsoft はどのようにインデックスの品質を維持していますか。
ページは、品質、権威、信頼性について評価されます。 悪意のある、スパム、フィッシングのコンテンツが検出され、除外され、インデックスが継続的に更新されます。 これは、Microsoft自身のAI製品が依存しているのと同じインデックスです。
Web IQ では、発行元のコンテンツ設定の希望はどのように考慮されますか?
Web IQ は、Microsoftによって認識される適用可能な robots.txt ディレクティブやその他の発行元信号など、サポートされている発行元コントロールを尊重するように設計されています。
除外されたサイトまたはブロックされたカテゴリの発行済みリストはありますか?
No. 除外制御には、robots.txt コンプライアンス、法的およびコンプライアンスの削除 (DMCA 通知や裁判所命令など)、スパム、マルウェア、フィッシングフィルタリング、成人コンテンツフィルタリングが含まれます。 リスト自体は独自のものであり、継続的に更新されます。 結果に表示されるコンテンツの特定のカテゴリに関する懸念がある場合は、 Web IQ サポート に問い合わせて、アプリケーション プロファイルの構成がこれらの要件に対応しているかどうかを確認してください。
Web IQ はどのコンテンツをカバーし、どの程度新鮮ですか?
Web IQ は、Web ページ、ニュース、画像、およびビデオの結果に関する新しい情報を継続的に取得して、AI エージェントやアプリケーションがモデルのトレーニング データ以外の質問に答えるのに役立ちます。
可用性と鮮度は、API、ソースの種類、ユース ケースによって異なります。すべてのコンテンツに対して単一の鮮度保証はありません。 ソースと取得設定を選択するときは、ワークロードの鮮度要件を考慮してください。
Web IQ はどの言語と市場をサポートしていますか?
Web IQ はグローバル Web から引き出されますが、カバレッジは言語、市場、トピック、ソースの種類によって異なります。 各 API が受け入れるコードについては サポートされている言語と地域 ページを確認し、対象ユーザーが必要とする情報に照らしてカバレッジを評価してください。
ドメイン許可リストまたは拒否リストを構成できますか?
個々のドメインまたは小さなリストの場合は、site:example.com などの標準クエリ演算子を使用してドメインを含め、-site:example.com を使用して 1 つ除外します。 より大きい構成可能なリストは、現在、カスタマー マネージド機能として公開されていません。
LinkedIn結果が表示されないのはなぜですか?
LinkedIn結果は現在除外されています。
除外された URL に対して Browse が呼び出されるとどうなりますか?
ブラウズは HTTP 403 を返します。 基になる除外リストは表示されません。
Web IQ に Web サイトを見つけてもらうにはどうすればよいですか?
Web IQ は、Microsoft が自社の AI 製品に使用しているのと同じ Web インデックス上に構築されています。 サイトマップ、IndexNow、Bing Webmaster Tools、適切な robots.txt ポリシーなどの標準的な Web 検出プラクティスを使用します。 別の Web IQ 送信パスはありません。
クエリの動作と結果の品質
自然言語クエリまたはキーワード クエリを使用する必要がありますか?
どちらも機能します。 自然言語クエリは多くの場合、contentFormat=passageとの相性が良いですが、キーワード クエリは、会社名、ティッカー、特定のトピックなどの正確な検索に役立ちます。 過度に長いクエリや複合クエリを避ける。複数の情報ニーズを個別の API 呼び出しに分割します。
クエリの最大長は何ですか?
最大は 1,000 文字で、長いクエリは拒否されます。 一般に、短く焦点を絞ったクエリのほうがより良い結果を生みます。クエリに多くのコンテキストが含まれている場合は、検索が適切なシグナルに集中しない可能性があります。
Web 検索結果を日付でフィルター処理できますか?
Web Search では現在、日付範囲フィルターは提供されていません。本当に必要な場合を除き、ハード日付フィルターを使用しないことをお勧めします。 鮮度は既にクエリに基づいてランク付けに組み込まれており、ハードな日付制約を追加すると、ほぼ常に関連性が低下します。 ニュースのシナリオでは、Web 検索結果を日付でフィルター処理するのではなく、News API を使用します。
lastUpdatedAt は、Web IQ が最後にページをチェックした日付ではなく、パブリッシャーがコンテンツを最後に更新した日付であるため、古い日付はページが最近チェックされなかったことを意味しません。 応答で返され、要求フィルターではなく、すべての結果に含まれるわけではありません。 これを使用して、アプリケーションで結果を並べ替えたりフィルター処理したりできます。
Web Search では、いくつかの質問を含むプロンプトを処理できますか?
各 Web Search 要求は、1 つのクエリを処理します。 プロンプトに複数の質問または意図が含まれている場合は、それをアプリケーション内の個別のクエリに分割し、それぞれについて Web Search を呼び出し、結果を組み合わせてから回答を生成します。
Web IQ はマルチステップ エージェント ワークフローをサポートできますか?
Yes. エージェントは、タスク中に追加の Web 証拠が必要な場合は常に Web IQ を呼び出すことができます。 取得の待機時間は、回答を生成する前に複数の呼び出しを行うワークフローで特に重要です。
AI エージェントまたはアプリケーションは取得した証拠をどのように処理すべきですか。
質問に関連する証拠を使用し、どのソースが回答をサポートするかを追跡します。 取得したコンテンツは、エージェントを制御する命令とは別に保持します。 ソースの競合や証拠が不完全な場合は、サポートされていないステートメントでギャップを埋めるのではなく、その不確実性を明確にします。
グラウンディングの品質はどのように比較されますか?
Microsoftは、公開された比較において、グラウンディング満足度が最も高く、スコアは79.05です。 結果はクエリ セット、モデル、および評価方法によって異なります。そのため、独自のシナリオで品質を検証してください。
ソース: Web IQ ベンチマークの結果。 prod からサンプリングされた 3K Global のブラインド クエリ、構成: 結果 10 件、結果あたり 10,000 文字 (または同等)。
なぜ結果は Bing.com と異なるのですか?
Web IQ は、LLMによる利用、事実密度、パッセージ品質、低遅延に最適化されています。 Bing.com は、追加のランク付けシグナル、パーソナル化、視覚的な回答、および API を通じて再頒布できない可能性があるコンテンツを含む、一般消費者向けのエクスペリエンスです。 一部のランク付けの違いが予想されます。
同じリクエストで異なる結果が返ることはありますか?
インデックスが継続的に更新され、更新がデータ センター間で伝達されるため、一部のバリエーションが予想されます。 同一の要求が短時間に続けて行われた場合でも、結果は大きく安定しているはずです。 数秒以内に同じクエリに大きな差異がある場合は、 Web IQ サポートにお問い合わせください。
クエリから返される結果が予想よりも少なくなるのはなぜですか?
結果をカウントする前に、生の Web IQ 応答を確認します。 最も一般的な原因は、測定前に有効な結果を除外するクライアント側の設定またはダウンストリーム パイプライン ステップです。 また、maxResults、コンテンツの適格性、SafeSearch の動作、クエリ内の任意の site: 演算子または -site: 演算子も確認します。
応答コンテンツ
Web 検索とニュース検索で snippet フィールドが返されないのはなぜですか?
これは仕様です。 どちらも、個別のクエリ非依存の passage ではなく、クエリ依存の抽出 (snippet) として content を返します。
Web Search はどのようなコンテンツ形式をサポートしていますか?
passageでは、各結果で、クエリに最も関連するドキュメントの部分が最大 maxLength 文字まで返されます(ドキュメント全体にアクセスできない場合は最大 3,000 文字)。 これは、グラウンディングに推奨される形式です。 完全なドキュメント アクセス権を持つアプリケーションでは、 text、 html、および markdownを使用することもできます。 「文章とコンテンツの形式」を参照してください。
passageとは何か、なぜそれを使用するのですか?
contentFormat=passage設定すると、API は結果ごとに、クエリに最も関連するドキュメントのセグメントのみを返し、完全なドキュメントは返しません。 完全なドキュメントは Web IQ 側で処理され、返される内容はクエリ対象の抽出であるため、LLM は関連する文を見つけるために関連のない段落をスキミングする必要はありません。
- トークンの節約: LLM は、すべてのドキュメントではなく、ドキュメントの一部を受け取ります。
- 事実性の向上: コンテキスト内のトピック外のコンテンツが少ないほど、モデルは本筋からそれた段落に固定される可能性が低くなります。
すべての Web 検索とニュース要求で contentFormat=passage を設定します。 既に選択した特定の URL がフェッチされ、抽出対象のクエリがないため、Browse は passage をサポートしていません。
Web Search の最大 maxResults 値は何ですか?
Web Search では、要求ごとに最大 50 件の結果がサポートされます。
どの要求パラメーターを構成できますか?
Web Search では、 maxResults、 language 、 region、 contentFormat (passage、 text、 html、または markdown)、 maxLength、および safeSearchが公開されます。 パラメーターの完全な一覧については、 API リファレンスを参照 してください。
lastUpdatedAtとcrawledAtの違いは何ですか?
lastUpdatedAt は、Web Search、ニュース、ビデオ、画像、Browse、Auto で利用可能な場合に返される、発行元から報告されたコンテンツの更新日です。
crawledAt は、Web Search、Browse、News、Auto によって返されたページを Web IQ が最後にフェッチした時刻です。両方のフィールドのカバレッジは結果によって異なります。
コンテキスト ウィンドウとトークンのコストを管理するために、 maxResults と maxLength を調整するにはどうすればよいですか?
Web IQ では、不要なページ コンテキストを提供する代わりに、クエリに関連する一節に優先順位を付けることができます。 これにより、モデルに渡されるテキストの量を減らし、入力トークンのコストを削減できます。 利点は、お使いのモデル、プロンプト、クエリ構成、取得の設定によって異なります。
ほとんどのグラウンディングのシナリオでは、合計トークン予算がほぼ同じであれば、より長いパッセージを含む結果を少なく返すよりも、より短いパッセージを含む結果を多く返すほうが、より良い出力が得られます。 適切な開始点は、passage とともに maxLength で約 3,000 文字の maxResults=10 形式です。 独自のクエリとモデルでベンチマークを実行します。
Browse Live Crawl とは何ですか。また、どのような場合に使用する必要がありますか?
Browse は、Bing Web インデックスからコンテンツを返します。これは、クローラーが Web 全体の変化を検出するのに合わせて継続的に更新されます。 これは、Web 検索の一般的な動作です。検索結果は、すべての要求でライブのすべての URL をフェッチするのではなく、インデックスから提供されます。これは、Browse の速度と一貫性を提供します。
要求時に URL の Just-In-Time フェッチが特に必要なシナリオ (リアルタイム監視、競合チェック、変更が発生した場合にトリガーされるワークフローなど) の場合、Browse では ライブ クロールがサポートされます。 インデックス付きコピーが見つからないか古い場合に、要求でライブ フェッチをオプトインするには、liveCrawl: "fallback" を設定します。 パラメーターを省略 (または liveCrawl: "none"設定) すると、インデックス付きコンテンツのみが返されます。 完全なパラメーターの詳細については、Browse API リファレンスを参照してください。
ライブ クロールは、Web IQ Browse で既定で使用でき、全体的な Browse QPS とは別に、控えめな秒間容量上限が設定されています。 この上限は、AppID のすべての API キーで共有されます。 ほとんどの Browse ワークロードはライブ クロールを必要とせず、標準のインデックス付きパスによって最適に処理されます。上記のシナリオの狭いセットには、ライブ クロールを使用します。
Browse は JavaScript でレンダリングされたページを取得できますか?
Yes.
renderDynamicPages: true を liveCrawl: "fallback" と一緒に使用します。 完全なパラメーター セットと応答の詳細については、 Browse API リファレンス を参照してください。 運用環境でこの動作に依存する前に、代表的な URL をテストしてください。
Browse はオンライン PDF ファイルを抽出できますか?
オンラインでホストされている PDF は、現在文書化されているブラウズ シナリオではありません。 特定の PDF ユース ケースがある場合は、該当する URL と期待される動作を Web IQ サポート にお問い合わせください。明確な回答が得られます。
課金と法務
Web IQ のコストは何ですか?
Web IQ では、従量課金制で、呼び出しごとに課金されます。 価格は、アカウントで有効になっている API、使用状況、および商用条件によって異なります。 現在の料金については、料金を参照してください。
Web IQ には SLA、RTO、または RPO コミットメントが含まれていますか?
No. Microsoft Web IQ には、サービス レベル アグリーメントは含まれません。 Web IQ 使用条件は、アップタイム、遅延、目標復旧時間 (RTO)、または目標復旧時点 (RPO) にコミットせず、個々の顧客に対して SLA 条件は追加されません。
引用文献を表示する必要がありますか?
Yes. Web IQ 使用条件の別紙A、第1節(LLMの使用)では、表示されたLLMコンテンツの近くに、そのコンテンツに使用された各ソースの出典表示と各ソースへのリンクを記載することが求められています。
- 答えを生成するために実際に使用されたソースのみを引用してください。 Web IQ が 10 件の結果を返し、モデルで 3 件を使用した場合は、その 3 件を表示してください。
- 引用文献は回答に表示され続け、1 つのアクションで到達可能である必要があります。 一時的にしか表示しない、複数の画面の背後に非表示にする、またはユーザーに別途ソースを求めさせる。
- 自動車、ウェアラブル、音声優先デバイス、キオスクなどの制約のあるインターフェイスの場合は、現在の回答に使用されているすべての引用文献を一覧表示するページに移動する永続的なQRコード、クリック可能な引用文献を含む回答を表示するコンパニオン アプリ、またはユーザーが直接開くことができる画面上のリストを使用します。
個々のエンド ユーザーのチャット履歴の一部として、引用文献を最大 30 日間保存できます。 以下のキャッシュに関する質問を参照してください。
AI エージェントまたはアプリケーションで表示できるソース コンテンツの量はどのくらいですか?
Web IQ 使用条件の別紙 A では、表示されるグラウンディング コンテンツを、任意の単一ソースについて 200 文字または Web サイト所有者もしくはウェブマスターが指定した最大文字数のいずれか小さい方に制限します。 音声またはオーディオ エクスペリエンスの場合は、読み上げ出力に同じ制限を適用します。 サマリーと表示には、追加の制限が適用されます。 抜粋を設計する前に利用規約を確認してください。この上限は、ソース ページ全体を再現する許可を意味するものではありません。
画像とビデオの結果を使用してLLMをグラウンディングできますか?
画像とビデオのメタデータと代替テキストは、Grounding Content の定義に含まれています。 ただし、Web IQ 利用規約では、グラウンディングのために結果の実際の画像または動画を使用したり、それらを LLM 出力に含めたり、それらから派生画像や動画を作成したりすることは禁止されています。 目的の実装の利用条件を確認します。
Web IQ コンテンツをキャッシュまたは保存できますか?
原則として、いいえ。 Web IQ 利用規約では、狭い例外を除き、コンテンツのコピー、保存、キャッシュ、アーカイブ、またはデータベースの作成を禁止します (別紙 A および B のセクション 3.2.15 およびセクション 4)。
- エンド ユーザーのチャット履歴 (最大 30 日間): コンテンツは、個々のエンド ユーザーのチャット履歴に対して、最大 30 日間、非集計のエンド ユーザー単位で保存できます。 LLMの使用(別紙A)の場合、これは一般的にコンテンツを対象とします。検索用(別紙B)では、画像および動画のURLを対象とします。
- アトミック アクションの一時的な処理: コンテンツは、LLM によって開始された 1 つの論理的な要求またはワークフロー(複数の内部ステップまたはエージェント的なやり取りを伴う場合がある「アトミック アクション」)を完了するために厳密に必要な場合にのみ、一時的な処理状態に保持される場合があります。 アトミック アクションが完了したら、コンテンツをすぐに削除する必要があります。
- お客様自身の成果物: 著作権法で認められている限り、コンテンツは、その成果物が本サービスの代替として作成されたものでない限り(たとえば、コンテンツのデータベースを構築すること、クロール用にリンクにインデックスを付けること、または別個の検索を提供すること)、お客様自身の成果物に統合された一部としてコピーまたは保存することができます。
これらの例外を除き、利用規約では、派生データベース、永続的キャッシュ、またはコンテンツの長期アーカイブは許可されません。
Web IQ 利用規約はどこで確認できますか?
現在の使用条件は、Microsoft Web IQ 利用規約で公開されています。 これらは、既存のMicrosoft 顧客契約と一緒に適用されます。
ドキュメントへのフル アクセス
contentFormatを html に設定すると HTTP 403 が表示されるのはなぜですか?
Web 検索とニュース検索では、 text、 html、 markdown はドキュメント全体を返し、完全なドキュメント アクセス権を持つアプリケーションで使用できます。 他のアプリケーションでは、エラー コード AuthContentFormatForbidden を伴う HTTP 403 が返されます。
passage は、すべてのアプリケーションに対して機能します。 「Passages とコンテンツ形式」を参照してください。
ドキュメント全体へのアクセスを申請するにはどうすればよいですか?
Azure Support から Web IQ サポート リクエストを作成し、ページ全体のコンテンツ カテゴリを選択します。
htmlまたはtextを既に使用しているアプリケーションは、現在も動作し続けます。