このページでは、Agent Search アプリとデータストアについて説明します。
Agent Search では、検索アプリまたはレコメンデーション アプリを作成し、それをデータストアに接続します。 1 つの Google Cloud プロジェクトに複数のアプリを含めることができます。
アプリとデータストアの関係
アプリとデータストアの関係は、アプリのタイプによって異なります。
カスタム検索アプリは、データストアと多対多の関係にあります。複数のデータストアが 1 つのカスタム検索アプリに接続されている場合、これを統合検索と呼びます。 1 つの検索アプリを複数の データストアに接続する際の制限事項については、統合検索についてをご覧ください。
カスタム レコメンデーション アプリは、データストアと 1 対 1 の接続にあります。
メディアアプリは、データストアと多対 1 の関係にあります。アプリは 1 つのデータストアにしか接続できませんが、1 つのデータストアを複数のアプリに接続することが可能です。たとえば、メディア検索アプリとメディア レコメンデーション アプリで 1 つのデータストアを共有できます。
ヘルスケア検索アプリは、データストアと多対 1 の関係にあります。アプリは 1 つのデータストアにしか接続できませんが、1 つのデータストアを複数のアプリに接続することが可能です。たとえば、患者向けアプリと医療機関向けアプリから同じデータストアに接続できます。
ヘルスケアデータのバッチデータ インポートの場合、データはアプリ内のデータ ストアにインポートされます。ヘルスケアデータのストリーミング データ インポート（プレビュー）の場合、データはエンティティにインポートされます。これは、データコネクタ内のデータ ストアの一種です。データコネクタは、アプリ内のデータストアの一種でもあります。
データストアをアプリに接続した後に切断することはできません。
アプリ作成とデータの取り込みの方法
アプリを作成してデータを取り込む方法は、データの種類によって次のように異なります。
ウェブサイトのデータについては、 Google Cloud コンソールと API のどちらも使用できます。 API で作成したウェブサイトのデータを使用するには、コンソールで Enterprise 機能が有効になっているアプリに接続する必要があります。 Google Cloud
構造化データまたは非構造化データについては、 Google Cloud コンソールと API のどちらも使用できます。
ヘルスケアデータについては、 Google Cloud コンソールと API のどちらも使用できます。
ドキュメント
各データストアには、「ドキュメント」と呼ばれるデータレコードが 1 つ以上あります。ドキュメントが何を表すかは、データストア内のデータの種類によって次のように異なります。
Websiteドキュメントはウェブページです。
構造化データドキュメントは、特定のスキーマに従うテーブルの 1 行または 1 つの JSON レコードです。このスキーマを独自に指定することも、取り込んだデータから Agent Search で自動的にスキーマを取得することもできます。
メディアの構造化データ 。ドキュメントは、メディアに固有のスキーマに従うテーブルの 1 行または JSON レコードです。ドキュメントは、動画、ニュース記事、音楽ファイル、ポッドキャストなどのメディア コンテンツに関するレコードです。ドキュメントには、メディア アイテムを説明する情報（タイトル、コンテンツの場所の URI、カテゴリ、再生時間、利用可能日など）が少なくとも含まれています。
非構造化データ 。ドキュメントは、TXT、PDF、HTML、DOCX、PPTX、XLSX、XLSM のいずれかの形式のファイルです。
医療 FHIR データ 。ドキュメントは、サポートされている FHIR R4 リソースです。Agent Search でサポートされている FHIR R4 リソースのリストについては、 Healthcare FHIR R4 データスキーマ リファレンスをご覧ください。
データストアとアプリ
Agent Search には、さまざまな種類のデータストアがあります。 各データストアには 1 種類のデータのみを含めることができます。
ウェブサイトのデータ
ウェブサイトのデータを含むデータストアは、公開ウェブサイトからインデックス登録されたデータを使用します。データストアに含める URL パターンのセットを指定できます。URL パターンに一致するウェブページは、含まれるウェブページと呼ばれます。 含まれるウェブページからクロールされたデータに対する検索を設定できます。
たとえば、example.com/faq/* や example.com/events/* などの URL パターンを指定して、パターンに一致するウェブページからクロールされたデータに対する検索を有効にできます。このデータには、テキスト、メタデータでタグ付けされた画像、その他の構造化データ（meta タグ、PageMap 属性、schema.org データなど）が含まれます。
除外するウェブサイトの部分の URL パターン（example.com/events/members-only/* や example.com/events/past-* など）を指定することもできます。除外された URL は、含まれる URL よりも優先されます。
ウェブサイトのデータストアには次の 2 種類があります。
基本的なウェブサイト検索:
- 含まれるウェブサイトの既存の Google 検索インデックスに対する検索機能を提供します。
- ドメインの所有権を証明する必要はありません。
ウェブサイトの高度なインデックス登録:
- 次のいずれかに基づいて生成されたインデックスに対する高度な検索機能を提供します。
- Agent Search アプリのオーナーは、サイトマップを送信して管理することで、インデックス登録するウェブページを制御できます。詳細については、 サイトマップを使用してウェブページをインデックス登録して更新するをご覧ください。このプロセスにより、手動で操作しなくてもインデックスを最新の状態に保つことができます。
- Agent Search アプリのオーナーは、Google 検索インデックスをミラーリングする初期インデックス登録を行い、必要に応じてウェブサイトを再クロールしてインデックスの範囲を拡大し、最新の状態に保つことができます。詳細については、ウェブページを更新するをご覧ください。ウェブサイトの高度なインデックス登録の高度な機能については、 ウェブサイトの高度なインデックス登録をご覧ください。
- Agent Search データストアのオーナーは、含まれるウェブサイトが属するドメインを確認する必要があります。詳しくは、 ウェブサイトのドメインを確認するをご覧ください。
- データストア スキーマに構造化データを追加する機能を提供します。
ウェブサイトには非構造化データが含まれていますが、
metaタグ、PageMap 属性、schema.org データの形式で構造化データをウェブページに追加できます。この構造化データを使用して、ウェブサイトの高度なインデックス登録に構造化データを使用する で説明されているように、データストア スキーマを編集できます。
- 次のいずれかに基づいて生成されたインデックスに対する高度な検索機能を提供します。
次のステップ
ウェブサイト検索の場合:
- インデックス登録の前提条件については、ウェブサイト検索用にデータを準備する方法をご覧ください。
- ウェブサイトのコンテンツを使用してデータストアを作成します。
- 検索アプリを作成します。