このページでは、データストアを作成して Microsoft Outlook を Gemini Enterprise に接続する方法について説明します。
始める前に
Microsoft Outlook の連携接続を設定する前に、次のことが完了していることを確認してください。
ディスカバリー エンジン編集者ロール(roles/discoveryengine.editor)を付与する。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。
- Google Cloud コンソールで、[IAM] ページに移動します。
- ユーザー アカウントを見つけて、edit 編集アイコンをクリックします。
- ユーザーに
Discovery Engine Editorロールを付与します。詳細については、IAM のロールと権限をご覧ください。
Gemini Enterprise を Microsoft Entra ID で OAuth 2.0 アプリケーションとして登録し、次の認証情報を収集します。
クライアント ID
クライアント シークレット
テナント ID
Microsoft Outlook 管理者の同意を得て、Microsoft API 権限を構成する。
Microsoft Outlook データストアを作成する
Microsoft Outlook のデータストアを作成する手順は次のとおりです。
Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
Google Cloud プロジェクトを選択または作成します。
ナビゲーション メニューで [データストア] をクリックします。
[データストアを作成] をクリックします。
[ソース] セクションで「Microsoft Outlook」を検索し、[選択] をクリックします。
[データ] セクションで、次の操作を行います。
- [コネクタモード] セクションで、接続モードとして [データの取り込み] または [連携検索] を選択します。
[続行] をクリックします。
[認証の設定] セクションで、選択した接続モードに基づいて認証を構成します。
必要に応じて、次の認証情報を入力します。
- クライアント ID: 組織の Microsoft Entra ID に登録されているアプリケーションの固有識別子。
- クライアント シークレット: Microsoft Entra ID での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。
- テナント ID: Microsoft Entra 管理センターでの組織の固有識別子。
詳細については、クライアント認証情報を取得するをご覧ください。
[連携検索] を選択した場合は、[ログイン] をクリックして Microsoft へのログインを完了します。
[続行] をクリックします。
[詳細オプション] で、次の操作を行います。
[連携検索] を選択した場合は、[Azure Tenant] フィールドに、Entra アプリケーションの作成時に取得したテナント ID を入力します。
[データの取り込み] を選択した場合:
- 省略可: システムで静的 IP アドレスのセットを許可するには、[Enable static IP addresses] チェックボックスをオンにします。
- 省略可: [Max QPS] フィールドに最大秒間クエリ数を入力して、コネクタが Outlook インスタンスに送信するクエリにレート制限を適用します。
[検索するエンティティ]([連携検索] を選択した場合)または [同期するエンティティ]([データの取り込み] を選択した場合)セクションで、次の操作を行います。
- 必要なエンティティをすべて選択します。
- [連携検索] を選択した場合は、次の手順に進みます。
- [データの取り込み] を選択した場合は、次の操作を行います。
- 省略可: 特定のプロジェクトを同期するには、次の操作を行います。
- [フィルタ] をクリックします。
- フィルタでインデックスからエンティティを除外するには、[インデックスから除外する] チェックボックスをオンにします。インデックスにエンティティが含まれるようにするには、[インデックスに含める] チェックボックスをオンにします。
- キーを入力します。キーを入力するごとに Enter キーを押します。
- [保存] をクリックします。
- 同期スケジュールを構成するには、次の操作を行います。
- [同期頻度] リストで、同期の頻度を選択します。
- エンティティ データと ID データの完全同期を個別にスケジュールするには、[完全同期] セクションのメニューを開き、[カスタマイズ オプション] を選択します。
- [増分同期の頻度] リストで、増分同期の頻度を選択します。詳細については、同期スケジュールをご覧ください。
- [同期頻度] リストで、同期の頻度を選択します。
- 省略可: 特定のプロジェクトを同期するには、次の操作を行います。
[続行] をクリックします。
[アクション] セクションで次の操作を行います。
- [連携検索] を選択した場合:
- [Select Microsoft Outlook actions to enable] で、カテゴリからアクションを選択して、そのコネクタを有効にします。
[データの取り込み] を選択した場合:
- [認証の設定] セクションで、選択した接続モードに基づいて認証を構成します。
必要に応じて、次の認証情報を入力します。
- クライアント ID: 組織の Microsoft Entra ID に登録されているアプリケーションの固有識別子。
- クライアント シークレット: Microsoft Entra ID での OAuth 2.0 アプリケーション登録プロセスで生成された秘密鍵。
- テナント ID: Microsoft Entra 管理センターでの組織の固有識別子。
認証情報の取得方法については、クライアント認証情報を取得するをご覧ください。必要なスコープについては、必要な権限をご覧ください。
[ログイン] をクリックして Microsoft Outlook にログインし、アカウントを確認します。
[続行] をクリックします。
[詳細オプション] で、次の操作を行います。
- Entra アプリケーションの作成時に取得したテナント ID である Azure テナントを入力します。
[Select Microsoft Outlook actions to enable] で、カテゴリからアクションを選択して、そのコネクタを有効にします。
- [連携検索] を選択した場合:
[続行] をクリックします。
[構成] セクションで、次の操作を行います。
- [マルチリージョン] リストから、データコネクタのロケーションを選択します。
- [データコネクタ名] フィールドに、コネクタの名前を入力します。
- ロケーションとして
USまたはEUを選択した場合は、暗号化設定を構成します。- 省略可: 単一リージョンの鍵を構成していない場合は、[設定ページに移動] をクリックして構成します。詳細については、サードパーティ コネクタの単一リージョンの鍵を登録するをご覧ください。
- [Googleが管理する暗号鍵] または [Cloud KMS 鍵] を選択します。
- [Cloud KMS 鍵] を選択した場合:
- [鍵管理のタイプ] リストで、適切なタイプを選択します。
- [Cloud KMS 鍵] リストで、鍵を選択します。
[続行] をクリックします。
[お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。
[作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。
[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が「作成中」から「アクティブ」に変わると、Microsoft Outlook コネクタを使用できるようになります。
Microsoft Outlook で作成された取り込みコネクタの場合、同期が開始されると、データストアの状態が「作成中」から「実行中」に変わります。取り込みが完了すると、「アクティブ」に変わり、データストアが完全に構成されたことを示します。データ量によっては、取り込みに数時間かかることがあります。
データストアを作成したら、アプリを作成し、それを Microsoft Outlook データストアに接続します。クエリを実行する前に、Gemini Enterprise が Microsoft Outlook にアクセスすることを承認します。
リアルタイム同期を有効にする
リアルタイム同期では、ドキュメント エンティティのみが同期され、ID エンティティに関連するデータは同期されません。次の表に、リアルタイム同期でサポートされているドキュメント イベントを示します。
| Outlook エンティティ | 作成 | 更新 | 削除 | 権限変更 |
|---|---|---|---|---|
| メール | ||||
| メール添付ファイル | ||||
| カレンダー | ||||
| 連絡先 |
データストアのリアルタイム同期を有効にする手順は次のとおりです。
Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
ナビゲーション メニューで [データストア] をクリックします。
リアルタイム同期を有効にする Microsoft Outlook データストアの名前をクリックします。
データストアの [データ] ページで、[コネクタの状態] が [アクティブ] に変わるまで待ちます。
[リアルタイム同期] フィールドで、[表示 / 編集] をクリックします。
リアルタイム同期を有効にするには、[リアルタイム同期を有効にする] 切り替えボタンをクリックします。
[クライアント シークレット] フィールドに値を入力します。この値は、Microsoft Outlook Webhook イベントの検証に使用されます。20 文字の文字列を使用することをおすすめします。
[保存] をクリックします。
[リアルタイム同期] フィールドが [実行中] に変わるまで待ちます。
データの取り扱いとクエリの実行
このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。
クエリ実行
Microsoft Outlook を承認した後、Gemini Enterprise に検索クエリを送信すると、次のようになります。
- Gemini Enterprise は、検索クエリを Microsoft API に直接送信します。
- Gemini Enterprise は、結果を接続された他のデータソースからの結果と統合して、包括的な検索結果を表示します。
データの取り扱い
サードパーティの連携検索を使用する場合、次のデータ処理ルールが適用されます。
- クエリ文字列がサードパーティの検索バックエンド(Microsoft API)に送信されます。
- これらのサードパーティは、クエリをユーザーの ID に関連付ける場合があります。
- 複数の連携検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
- データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーが適用されます。
次のステップ
- Microsoft Outlook データをクエリするためのユーザー インターフェースを提供する。アプリを作成し、Microsoft Outlook データストアに接続します。
- アクションのリストを表示する。アクションを表示するをご覧ください。
- アプリが設定された後に検索結果がどのように表示されるかをプレビューする。検索結果を取得するをご覧ください。
- データストアのアラートを有効にする。サードパーティのデータストアのアラートを構成するをご覧ください。