コンテンツAI 検索コンポーネント content-ai-search-component
コンテンツAI 検索コンポーネントは、生成AIを利用した検索でサイト訪問者に提供します。
使用方法 usage
コンテンツAI 検索コンポーネントを使用すると、訪問者はページから直接 コンテンツSourceを検索し、オプションで生成AIによる結果の概要を表示できます。 標準のフルテキスト/セマンティック検索ボックスと、AEM Content AIを活用した切り替え可能なAI生成の概要を表示 パネルを組み合わせています。
編集ダイアログ を使用すると、コンテンツ作成者は、検索、検索動作、および生成設定のコンテンツ範囲を定義できます。 テンプレートレベルで使用できる設定がないので、デザインダイアログはありません。
バージョンと互換性 version-and-compatibility
このドキュメントでは、コンテンツAI 検索コンポーネントの現在のバージョン(2026年7月にコアコンポーネントのリリース 2.32.0で導入されたv1)について説明します。
コンポーネントのすべてのサポート対象バージョン、コンポーネントの各バージョンと互換性のある AEM バージョン、以前のバージョンのドキュメントへのリンクを次の表に示します。
コアコンポーネントのバージョンとリリースについて詳しくは、 コアコンポーネントのバージョン を参照してください。
コンポーネント出力のサンプル sample-component-output
コンテンツAI 検索コンポーネントを体験し、そのコンフィギュレーションオプションやHTMLおよびJSON出力の例を確認するには、 コンポーネントライブラリ を参照してください。
技術的詳細 technical-details
コンテンツAI 検索コンポーネント に関する最新の技術ドキュメントは、GitHubにあります。
コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントを参照してください。
編集ダイアログ edit-dialog
編集ダイアログでは、コンテンツ作成者が検索、検索動作、生成設定のコンテンツ範囲を定義できます。 テンプレートレベルで使用できる設定がないので、デザインダイアログはありません。
「コンテンツ範囲」タブ content-scope
-
ID – このオプションを使用すると、HTMLおよび データレイヤーのコンポーネントの一意のIDを制御できます。
- 空白のままにした場合、一意の ID が自動的に生成されます。生成された ID は結果のページを調べることで確認できます。
- ID を指定した場合、作者はその ID が一意であることを確認する必要があります。
- ID を変更すると、CSS、JS、およびデータレイヤーのトラッキングに影響を与える可能性があります。
-
Content Source Type – このフィールドは、コンテンツソースのタイプを定義します。 タイプを選択すると、コンテンツSource ドロップダウンに一致するソースが入力されます。
- ACQUISITION - クロール/獲得パイプラインを介してインデックス付けされたパブリックな匿名アクセス ソースに使用されるデフォルト値
- AEM_AUTHOR - コンテンツがAEM オーサーインスタンスから取り込まれたContent-AI側のソース
- AEM_PUBLISH -AEM パブリッシュインスタンスからコンテンツを取り込んだContent-AI側のソース
- CUSTOM - AEMの独自の取り込みパイプラインの外部で登録されたソース
-
コンテンツソース – このコンポーネントが検索するコンテンツSourceを定義します。
- 使用可能なエントリは、既に存在し、使用可能のコンテンツソースと一致し、Content Source Typeで設定された型とも一致します
- 詳しくは、 コンテンツ AI ソースの設定と管理のドキュメントを参照してください。
「検索行動」タブ search-behavior
-
結果レイアウト – このオプションは、検索結果を訪問者に表示する方法を定義します。
- カード – このオプションは、結果をグリッド形式で表示します。
- リスト – このオプションは、結果をリスト形式で表示します。
-
結果サイズ – 検索リクエストごとに取得される結果の数を定義します。
- デフォルト値は
12です。 - 一致する項目が追加されると、訪問者はより多くの結果を読み込むことができます。
- デフォルト値は
-
プレースホルダーテキスト – これは、訪問者が検索クエリに入る前に、空の検索入力フィールドに表示されるテキストです。
「生成検索」タブ generative-search
-
生成サマリーの表示を訪問者に切り替えます – オフにすると、訪問者はAI サマリーを表示するかどうかを変更できません。
- デフォルト値は有効です。
-
生成サマリーをデフォルトで表示 – このオプションは、AIが生成したサマリーの訪問者向けトグルのデフォルト状態を制御します。
- デフォルト値は有効です。
-
GenSearch Error Fallback – 検索の動作またはエラーを定義します。
- 結果のみ(エラーを非表示) - エラーがある場合は、返された結果のみを表示し、エラーと再試行ボタンは表示しません。 これがデフォルト値です。
- 再試行でエラーを表示 - エラーがある場合は、再試行ボタンでエラーを表示します。
- エラーメッセージのみを表示 - エラーがある場合は、エラーメッセージのみを表示し、結果を表示しません。