Gemini Enterprise アシスタントとチャットする際に、ユーザーはファイル選択ツールを使用してファイルを添付できます。このアシスタントは、ローカル ファイル、Google ドライブのファイル、Microsoft OneDrive のファイルの 3 つのファイルソースをサポートしています。このページでは、管理者がこの動作を構成する方法について説明します。
エンドユーザーが Google ドライブと OneDrive からファイルを選択できるようにするには、Google ドライブ データストアと OneDrive データストアの構成時に設定したデータストア構成を再利用して、エンドユーザーのログイン方法を制御します。これにより、次の項目を管理できます。
- 選択ツールが使用するログインアプリ。ピッカーは、デフォルトの Google 管理アプリケーションではなく、コネクタで構成した Microsoft Entra(旧 Azure AD)または Google アプリケーションを再利用できます。
- OneDrive の選択ツールで使用する Microsoft Entra テナント。OneDrive ピッカーは、特定の Microsoft Entra テナントに対してユーザーをログインさせることができます。
ファイルを添付してチャットするエンドユーザー エクスペリエンスについては、ファイルをアップロードしてチャットするをご覧ください。
ファイル選択ツールの仕組み
Google ドライブと OneDrive のデータストアでファイル選択ツールに同じ認証構成を使用するように構成した場合、ファイル選択ツールは同じ設定を使用してユーザーを認証します。次の表に、2 つのコントロールと、それらが影響する選択ツールの概要を示します。
| 管理 | 機能 | 対象 |
|---|---|---|
| カスタム ログインアプリ | ユーザーがファイル選択ツールを使用してアシスタントにファイルを添付する際にユーザーを認証するために、Gemini Enterprise は、デフォルトの Google 管理アプリケーションではなく、データストアの既存の Microsoft Entra ID または Google Identity 構成を使用できます。 | Google ドライブと OneDrive |
| テナントの適用 | OneDrive の選択ツールでは、ユーザーは共有ログイン エンドポイント(/common/)ではなく、特定の Microsoft Entra テナント(https://login.microsoftonline.com/{your-tenant}/...)に対してログインする必要があります。これにより、他のテナントのユーザーは認証できなくなります。テナントは、接続された OneDrive コネクタから読み取られます。 |
OneDrive のみ |
管理者は、コネクタをアプリに接続してこの動作を構成します。
構成プロバイダを指定すると、次のルールが適用されます。
- コネクタタイプごとに 1 つのプロバイダ。アプリに接続できる OneDrive 構成プロバイダと Google ドライブ構成プロバイダは、一度に 1 つだけです。同じタイプの 2 番目のコネクタをプロバイダとしてマークすると、invalid-argument エラーで拒否されます。
- プロバイダは、アクション対応のコネクタである必要があります。構成プロバイダは、アクションまたはフェデレーション アクセスをサポートする OneDrive または Google ドライブ コネクタである必要があります。取り込み専用コネクタは構成プロバイダにできません。詳細については、アクションを管理するをご覧ください。
始める前に
ファイル選択ツールを構成する前に、次のことを確認してください。
- 管理者権限。ディスカバリー エンジン編集者ロール(
roles/discoveryengine.editor)を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。- Google Cloud コンソールで、[IAM] ページに移動します。
- ユーザー アカウントを見つけて、edit 編集をクリックします。
- ユーザーに
Discovery Engine Editorロールを付与します。詳細については、IAM のロールと権限をご覧ください。
- カスタム OneDrive ログインアプリ。クライアント ID、クライアント シークレット、テナント ID など、管理する Microsoft Entra ID アプリケーションと、テスト用にそのテナント内の OneDrive アカウントがあることを確認します。詳細については、Microsoft Identity Platform にアプリケーションを登録するをご覧ください。
- 構成済みのデータストア。OneDrive データストアまたは Google ドライブ データストアを構成します。データストアを構成するときに、クライアント ID、クライアント シークレット、OneDrive データストアのテナント ID などの認証設定を構成します。詳細については、次をご覧ください。
- 接続されたデータストア。OneDrive データストアまたは Google ドライブ データストアを Gemini Enterprise app に接続します。詳細については、データストアをアプリに接続するをご覧ください。
独自のログインアプリを使用する
デフォルトでは、選択ツールは Google が管理するアプリケーションを使用してログインします。1 つのコネクタをピッカーの構成プロバイダとして指定することで、ピッカーで独自の Microsoft Entra ID または Google Identity を使用するように設定できます。
OneDrive または Google ドライブのデータストアがすでに構成されている場合は、次の手順に沿って操作します。
Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
Google Cloud プロジェクトを選択するか作成します。
ナビゲーション メニューで [データストア] をクリックします。
データストアを検索し、データストアの名前をクリックします。
[パラメータを表示 / 編集] をクリックします。
[Picker Config Provider] オプションを選択します。
[保存] をクリックします。
変更を元に戻して Google 管理のアプリケーションを使用する
ファイル選択ツールの認証にデフォルトの Google 管理アプリケーションを使用するように戻す手順は次のとおりです。
Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
Google Cloud プロジェクトを選択します。
ナビゲーション メニューで [データストア] をクリックします。
データストアの名前をクリックします。
[パラメータを表示 / 編集] をクリックします。
[Picker Config Provider] フィールドをクリアします。
[保存] をクリックします。
エンドユーザー エクスペリエンス
選択ツールを構成すると、エンドユーザーは次の操作を行うことができます。
- OneDrive の場合、ユーザーは組織の Microsoft テナントにログインするよう求められます。他のテナントのアカウントは拒否されます。
- ログインには、構成したアプリケーション(デフォルトでは Google が管理するアプリケーション、構成プロバイダを設定した場合は独自のアプリケーション)が使用されます。
- 最初のログインに成功すると、その後のファイル選択のために接続が記憶されます。
エンドユーザー エクスペリエンスの詳細については、ファイルをアップロードしてチャットするをご覧ください。
トラブルシューティング
| 症状 | 考えられる原因 | 解決策 |
|---|---|---|
コネクタを **Picker Config Provider** としてマークすると、Cannot enable picker_config_provider on data connector '...'
because another connector in the same engine is already the picker config
provider: '...'. An engine can have at most one picker_config_provider
connector; disable it on the other connector first. で失敗する |
同じエンジン内の別のコネクタがすでに選択ツールの構成プロバイダになっています。エンジンに設定できるのは 1 つだけです。 | もう一方のコネクタの [**Picker Config Provider**] パラメータをクリアしてから、もう一度お試しください。 |
OneDrive へのログインが AADSTS50020: User account
'user@domain.com' from identity provider '...' does not exist in tenant
'...' で失敗する |
ユーザーのアカウントが、コネクタで構成されているテナントとは異なる Microsoft Entra テナントにある。テナント固有のログイン エンドポイントがアカウントを拒否します。 | テナントの適用は想定どおりに機能します。構成済みのテナントのアカウントでユーザーにログインしてもらうか、コネクタのテナント ID を更新します。 |
| OneDrive は引き続き共有ログイン エンドポイントをプロンプトします。 | テナントがまだ構成されていないか、変更が反映されていません。 | コネクタのテナント ID を確認します。構成の変更が有効になるまでには、最長で 3 分ほどかかることがあります。しばらく待ってから再試行してください。 |
次のステップ
- Microsoft OneDrive コネクタを設定します。
- Google ドライブ コネクタを設定します。
- エンドユーザー エクスペリエンスについては、ファイルをアップロードしてチャットするをご覧ください。