このページでは、データストアを作成して Google ドライブを Gemini Enterprise に接続する方法について説明します。この接続により、Gemini Enterprise は Google ドライブから情報を直接取得できます。データは Gemini Enterprise インデックスにコピーされないため、データ ストレージを管理する必要はありません。
始める前に
接続する Google ドライブ インスタンスで使用するアカウントと 同じアカウントで Google Cloud コンソールにログインする必要があります。Gemini Enterprise は、Google Workspace お客様 ID を使用して Google ドライブに接続します。個人用の Google アカウント(末尾が
@gmail.comの一般ユーザー向けアカウント)にはお客様 ID がないため、サポートされていません。Gemini Enterprise でデータソースのアクセス制御を適用してデータを保護するには、 ID プロバイダが 構成されていることを確認してください。
すべてのドキュメントにアクセスできることを確認します。このドメインが所有する共有ドライブにドキュメントを配置するか、所有権をこのドメインのユーザーに割り当てます。
[スマート機能を有効にする]: Google Workspace アカウントで、 [Google Workspace のスマート機能] と [その他の Google サービスのスマート機能]の両方をオンにします。詳しくは、Google Workspace のスマート 機能をオンまたはオフにするをご覧ください。
OAuth アプリを許可リストに追加する(管理者のみ): Google ドライブのデータ ストアは、 Google管理の OAuth アプリを使用してデータにアクセスします。組織で OAuth アプリへのアクセスが制限されている場合は、Google Workspace 管理者がこのアプリを組織の許可リストに追加する必要があります。詳しくは、管理の OAuth アプリ Googleを許可リストに追加するをご覧ください。
Google ドライブのデータストアを作成する
Google ドライブのデータストアを作成する手順は次のとおりです。
Google Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
Google Cloud プロジェクトを選択するか作成します。
ナビゲーション メニューで [データストア] をクリックします。
[データストアを作成] をクリックします。
[ソース] セクションで「Google ドライブ」を検索し、[選択] をクリックします。
[アクション] セクションで、リストからアクションを選択して、Google ドライブ コネクタに対して有効にします。
アクションのリストを管理するには、アクションの管理をご覧ください。
[続行] をクリックします。
[構成] セクションで、次の操作を行います。
- [マルチリージョン] リストから、データコネクタのロケーションを選択します。
- [データコネクタ名] フィールドに、コネクタの名前を入力します。
- ロケーションとして
usまたはeuを選択した場合は、暗号化設定を構成します。- [Google管理の暗号鍵] または [Cloud KMS 鍵] を選択します。
- [Cloud KMS 鍵] を選択した場合:
- [鍵管理のタイプ] リストで、適切なタイプを選択します。
- [Cloud KMS 鍵] リストで、鍵を選択します。
省略可: [タグ] フィールドに、データストアの安定した識別子を入力します。この識別子は、コネクタのさまざまなバージョンで使用され、データストアの作成後に変更できなくなるため、後で変更する必要のない値を選択してください。
省略可: [Sensitive Data Protection ポリシー] セクションで、既存の Sensitive Data Protection ポリシーをアタッチして、Gemini Enterprise がこのデータストアから取得するデータを検査して匿名化します。組織で Sensitive Data Protection ポリシーが必要ない場合は、この手順をスキップできます。
[作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。
データストアの状態を確認する手順は次のとおりです。
- データストア リストでコネクタに移動し、状態が「アクティブ」に変わるまでモニタリングします。
- データストアの状態が「作成中」から「アクティブ」に変わると、Google ドライブ コネクタを使用できるようになります。
データストアを作成したら、クエリを実行する前にアプリを作成し、Google ドライブ データストアに接続します。
クエリ実行
Google ドライブを認可した後、検索クエリを入力すると、次のようになります。
Gemini Enterprise は、検索クエリを Google Drive API に送信します。
Gemini Enterprise は、結果を他のソースからの結果と統合して表示します。
エラー メッセージとトラブルシューティング
次の表に、この Google データソースを扱う際に表示される可能性のあるエラー メッセージを、HTTP エラーコードや推奨のトラブルシューティング手順とともに示します。
| エラーコード | エラー メッセージ | 説明 | トラブルシューティング |
|---|---|---|---|
| 403 Permission Denied | Google Workspace データストアでは、サービス アカウントの認証情報を使用した検索はサポートされていません。 | 検索対象のエンジンに Google Workspace データストアがあり、渡された認証情報はサービス アカウントのものです。Google Workspace データストアでサービス アカウントの認証情報を使用して検索することはできません。 | ユーザー認証情報を使用して検索を呼び出すか、Google Workspace データストアをエンジンから削除します。 |
| 403 Permission Denied | Google Workspace データストアでは一般ユーザー向けアカウントはサポートされていません。 | 検索は一般ユーザー向けアカウント(@gmail.com)の認証情報を使用して呼び出されますが、これは Google Workspace データストアではサポートされていません。 | エンジンから Google Workspace データストアを削除するか、管理対象の Google アカウントを使用します。 |
| 403 Permission Denied | データストアのユーザー ID が一致しません | 検索は、Google Workspace データストアと同じ組織に属するユーザーのみに許可されます。 | ユーザーと Google Workspace データストアが異なる組織に属している場合は、Google Workspace データストアをエンジンから削除するか、サポートにお問い合わせください。 |
| 403 Permission Denied | Agentspace による Workspace へのアクセスが、組織の管理者によって無効にされています。 | Google Workspace 管理者が Gemini Enterprise の Google Workspace データへのアクセスを無効にしています。 | アクセスを有効にするには、Google Workspace 管理者にお問い合わせください。 |
| 400 Invalid Argument | リクエストに無効な引数が含まれています。 | このエラーは、リクエストのデータコネクタ名が命名要件を満たしていない場合に発生します。データコネクタ名が 1 ~ 63 文字で、先頭が英小文字、末尾が英小文字または数字で、英小文字、数字、ハイフン、アンダースコアのみが含まれていることを確認してください。たとえば、123456789-cymbal-collection ではなく cymbal-collection-123456789 のような名前を使用します。 |
|
Google ドライブデータをクエリする際に発生する一般的な検索の問題については、一般的な検索の問題をご覧ください。
次のステップ
- データをクエリするためのユーザー インターフェースを提供するため、アプリを作成して、Google ドライブのデータストアに接続する。
- アプリが設定された後に検索結果がどのように表示されるかをプレビューする。検索結果を取得するをご覧ください。
- データストアのアラートを有効にするには、サードパーティのデータストアのアラートを構成するをご覧ください。
- クロスドメイン ドキュメントを含むようにアプリが最初に構成されていない場合は、ウェブアプリの機能を管理するの設定で、クロスドメインのドキュメントを含める機能を有効にします。詳細については、ウェブアプリの機能 を管理するをご覧ください。