生成 AI を活用した Power Pages 検索 (プレビュー)

[アーティクル]
01/22/2025

このトピックはプレリリースドキュメントであり、変更される場合があります。

Power Pages 検索に生成 AI を使用するというのは、生成人工知能 (AI) モデルを Web 検索機能に組み込むことです。生成 AI はコンテキスト、意味、ユーザーの目標を理解して検索結果を要約できます。この方法では、自然言語処理 (NLP) と機械学習技術を使用して、より正確で多様な検索結果を提供することでユーザー体験を向上させます。

重要

これはプレビュー機能です。
プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
生成 AI 検索は英語で作成されたサイトで利用できます。
この機能は、Government Community Cloud (GCC)、Government Community Cloud - High (GCC High)、または国防総省 (DoD) リージョンでは利用できません。
Power Pages サイトのバージョンは 9.6.3.41 以上である必要があります。
生成 AI 検索を有効にすると、ファセット検索は利用できなくなります。

Power Pages 検索における AI 生成の検索結果概要のスクリーンショット。

生成 AI を活用したサイト検索を有効にする

Power Pages 検索で生成 AI を含めるには:

ワークスペース設定に移動します。
Copilot の下で サイト検索 (プレビュー) を選択します。
生成 AI によるサイト検索を有効にする (プレビュー) をオンにします。

検索ソースを絞り込む

Web サイトで検索機能を有効にすると、Web サイト全体が検索可能なドメインとして指定されます。 Dataverse サービスは、Web サイトのコンテンツと構成されたテーブルのインデックス作成を調整します。次に、Azure OpenAI はインデックス化されたコンテンツを集約して検索の要約を作成します。

注意Note

生成 AI 検索とキーワード検索の両方で同じコンテンツが使用されます。

検索コンテンツのソースをカスタマイズするには:

ワークスペースの設定に移動し、サイト検索 を選択します。
データの調整 の下で、変更を選択します。
テーブルを選択または選択解除するには、テーブルを選択 を選択します。
- このセクションでは複数のテーブルを選択できます。
- 選択したテーブルがサイト上で使用されていることを確認します。
- 以降のページでは、引用 URL を作成するためにテーブルが使用されているページを指定する必要があります。
次へを選択します。
テーブルの選択 を選択し、選択する列とページリンクを含むテーブルを選択します。
- 少なくとも 1 つの複数行の列がないと、テーブルは表示されません。
- 一度に選択できるテーブルは 1 つだけです。
テーブルに関連付けるページを選択 の下で、テーブルが使用されるページを選択します。
注意Note
- テーブルが使用されている正しいページを選択していることを確認してください。間違ったテーブルを選択すると、ボットは回答に対して間違った引用 URL を提供します。
- ページではクエリ文字列パラメーターとして "id" を使用する必要があります。他のパラメーター名が使用されている場合、引用 URL は正しく機能しません。
列を選択 で、ページで使用される列のリストを選択します。
- 複数行テキストを含む列のみ選択できます。
次へを選択して選択したものを確認します。

重要

複数のテーブルを選択した場合は、次へを選択する前に各テーブルのページと列のオプションを設定する必要があります。
保存を選択し、変更を送信します。

テーブル行のフィルター

検索範囲にテーブルが含まれている場合、サイト設定 Search/IndexQueryName で定義されているように、新しいビューがテーブルに追加されます。 Search/IndexQueryName の既定値は "ポータル検索" です。

検索範囲の内容をさらに絞り込みたい場合は、このフィルターを使用してカスタマイズします。

検索結果ページにスタイルを適用する

生成AI検索を搭載した Power Pages 検索結果ページは、スタイルワークスペースで定義されるテーマに従います。外観を変更するには、スタイルワークスペースを使用します。

検索結果コンポーネントの静的コンテンツは、コンテンツスニペットを使用してデザインされます。生成 AI サマリーのタイトルまたはキーワード結果のタイトルを更新する場合は、次のコンテンツスニペットを使用します。

生成 AI の要約 - Search/Summary/Title
キーワード検索 - Search/Results/Title

概要の検索 API

検索コントロールを使用せず、検索の概要を提供するカスタムページを開発している場合は、次の API を使用して詳細を取得します。

メソッド	URI
投稿	[サイト URI]_api/search/v1.0/summary

例: 要求

POST https://contoso.powerappsportals.com/_api/search/v1.0/summary
{
        data: { userQuery: "Fix problems with slow coffee dispense" }
}

例: 応答

HTTP/1.1 200 OK
Content-Type: application/json
Body
{
    "Summary":"To fix problems with slow coffee dispense, consider the following steps:\n\n1. **Check for Mineral Deposits**: One of the most common reasons for slow brewing is the buildup of mineral deposits inside the coffee maker. If you are using tap water, minerals like calcium can accumulate, leading to slow brew times and poor-tasting coffee.",
    "Citations’":{
                  "[1]": " https://contoso.powerappsportals.com /knowledgebase/article/KA-01055",
    }
}

サンプル JavaScript

このサンプルでは、非同期の JavaScript と XML (AJAX) を使用して検索の概要 API を呼び出す方法を示します。

    shell.ajaxSafePost({
        type: "POST",
        url: "https://contoso.powerappsportals.com/_api/search/v1.0/summary",
        contentType: "application/x-www-form-urlencoded",
        data: { userQuery: "Fix problems with slow coffee dispense" }
    })
    .done(function (response) {
        // Handle success
    })
    .fail(function() {
        // Handle failure
    });

次の方法で共有