Agent Search を初めて使用する場合は、カスタム検索を使ってみる のチュートリアルに沿って サンプルアプリを作成することを検討してください。
プロジェクトを設定し、Agent Search を有効にして、プロジェクトのアクセス 制御を設定します。 Google Cloud 既存の Google Cloud プロジェクトがある場合は、それを使用できます。
操作
- 始める前にを確認し、手順が完了していることを確認します。
検索アプリで利用可能なデータの種類を決定し、Agent Search へのインポート用に準備します。
データストアは、次の種類のデータに基づいて作成できます。
- 非構造化データ。Cloud Storage に保存されているドキュメント（PDF、HTML ファイル、TXT ファイルなど）。必要に応じて、JSON ファイルまたは BigQuery テーブルにメタデータを提供できます。
- 構造化データ。特定のスキーマで提供されるデータ。たとえば、BigQuery テーブルのデータ、Cloud Storage の JSON ファイル、Jira などのサードパーティ コネクタからのデータを提供できます。
操作
検索アプリの結果でユーザーが表示できるデータを制限するためにアクセス制御を設定する必要がある場合は、前提条件を確認し、データソースのアクセス制御を使用するで ID プロバイダのタイプとデータソースの手順に沿って操作します。
データストアを作成してデータをインポートするか、サードパーティ コネクタを同期データソースとして設定します。
データのインポート方法は、インポート元によって異なります。たとえば、データが Cloud Storage にある場合は、データのバケットの場所を指定して、コンソールまたは API を使用してインポートできます。
操作
カスタム検索用の Agent Search は、次の 2 つの料金モデルをサポートしています。
- 一般: 使用量ベースの従量課金制モデル。
- 構成可能: 機能をバンドル解除し、特定のユースケースにより適したサブスクリプション パッケージを作成できる混合料金モデル。この料金モデルでは、必要な機能に対してのみ料金を支払い、その強力な機能を活用できます。2 つのサブスクリプションとオプションのアドオンが用意されています。プロジェクト レベルでこの料金モデルを有効にすると、アプリとデータストアに構成可能な料金を選択できます。
操作
デフォルトでは、プロジェクトは従量課金制モデルに設定されています。構成可能な料金に切り替えるには、次の操作を行います。
- 手順に沿って、 カスタム検索の構成可能な料金を設定します。
Agent Search には、多くの構成オプションがあります。一部のオプションは、検索ウィジェットをデプロイするかどうかによって異なります。
操作
ユースケースと、すぐに使える検索ウィジェットをデプロイするか、検索 API 呼び出しを独自のコードに統合するかに応じて、Agent Search にはいくつかの構成オプションがあります。
検索ウィジェットをウェブサイトに埋め込むことができます。ウィジェットは、検索バーと拡張可能な検索インターフェースを自動的に提供します。検索ウィジェットをデプロイする場合は、次の項目を構成します。
検索ウィジェットの検索結果。検索ウィジェットの結果を構成するをご覧ください。
検索ウィジェットのファセット（プレビュー）。検索ウィジェットのファセットを構成するをご覧ください。
ウィジェットを使用する代わりに、検索 API 呼び出しをサーバーまたはアプリケーションに統合する場合は、次のオプションを使用して検索設定を構成できます。
フィールド設定。構造化データまたはメタデータを含む非構造化データの場合は、フィールド設定を更新して、Agent Search が検索にメタデータを使用する方法を絞り込みます。検索のフィールドを 構成するをご覧ください。
予測入力。データに応じて、ドキュメントのコンテンツ、フィールド、検索履歴、ユーザー イベントに基づいて予測入力の候補を設定します。 予測入力を構成するをご覧ください。
サービス提供コントロール。検索結果のブースト、非表示化、フィルタ、リダイレクトのタイミングや、特定のクエリを他のクエリに関連付けるかどうかを制御します。サービス提供コントロールを構成するをご覧ください。
検索のチューニング（プレビュー）。独自のトレーニング データを使用して検索モデルを調整します。検索のチューニングで検索結果を改善するをご覧ください。
カスタム エンベディング（プレビュー）。独自のエンベディングを作成した場合は、Agent Search によって生成されたエンベディングではなく、独自のエンベディングを使用して、追加のコンテキストで検索を強化するほうが好ましいかもしれません。この機能は、構造化データまたはメタデータを含む非構造化データが入っているデータストアに対して使用できます。カスタム エンベディング を使用するをご覧ください。
検索 API 呼び出しを独自のコードに統合してアプリをデプロイする場合、Agent Search には、検索結果の返され方を構成するための追加オプションが用意されています。
操作
次のオプションを使用して検索結果を構成します。
- 構造化データまたは 非構造化データのカスタム検索をフィルタします。
- スニペット、抽出回答、抽出セグメントを取得します。スニペットと抽出されたコンテンツを取得するをご覧ください。
検索結果をプレビューして、アプリの構成が想定どおりに機能しているかどうかを確認できます。
アクション
検索結果をプレビューするには、コンソールまたは API を使用します。
コンソール。Agent Search コンソールの [プレビュー] ページを使用して、検索ウィジェットの構成が結果に与える影響をプレビューします。検索結果を取得するのコンソール の手順をご覧ください。
API。API 呼び出しをアプリケーションに統合する場合は、API 呼び出しを行って検索構成をプレビューします。検索結果を取得するのREST の手順をご覧ください。
検索アプリのプレビュー バージョンに問題がなければ、ウェブサイトにデプロイしてユーザーと共有します。
アクション
検索アプリは、次のいずれかの方法でデプロイできます。
検索ウィジェットをウェブサイトに埋め込む。Agent Search には、ウェブサイトまたはウェブ アプリケーションにコピーできるコードが用意されています。これにより、検索ウィジェットがデプロイされます。検索結果はコンソールでプレビューできます。 検索ウィジェットをウェブページに追加するをご覧ください。
検索 API 呼び出しをサーバーまたはアプリケーションに統合します。検索結果の表示方法を完全に制御するには、API 呼び出しをサーバーまたはアプリケーションに統合します。API 呼び出しの詳細については、検索結果を取得するをご覧ください。クライアント ライブラリのリソースについては、Agent Search client librariesをご覧ください。
パーソナライズされた検索結果と閲覧結果を取得するには、検索アプリのユーザー イベント を更新します。詳細については、 カスタムアプリのユーザー イベントについてをご覧ください。