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