Salesforce データストアを設定する

このページでは、データストアを作成して Salesforce を Gemini Enterprise に接続する方法について説明します。データストアは Salesforce レコードをリアルタイムで検索し、エンドユーザーが自然言語を使用して操作できるようにします。

始める前に

Salesforce 接続を設定する前に、次の操作を行います。

  1. ディスカバリー エンジン編集者ロール（roles/discoveryengine.editor）を付与します。このロールは、ユーザーがデータストアを作成する際に必要になります。このロールを付与する手順は次のとおりです。

    1. Google Cloud コンソールで、[IAM] ページに移動します。

      [IAM] に移動

    2. ユーザー アカウントを見つけて、edit 編集をクリックします。
    3. ユーザーに Discovery Engine Editor ロールを付与します。詳細については、IAM のロールと権限をご覧ください。

  2. Salesforce 管理者に、接続先の Salesforce 組織で SObject All MCP サーバーを有効にし、選択した認証方法を構成してもらいます。

    • OAuth 2.0（Google 管理）（デフォルト）: Salesforce AppExchange から Gemini Enterprise - Salesforce Connector 管理パッケージをその組織にインストールします。クライアント ID やクライアント シークレットは必要ありません。
    • OAuth 2.0（Bring Your Own App）: その組織で外部クライアント アプリを作成し、コンシューマ キー（クライアント ID）とコンシューマ シークレット（クライアント シークレット）を取得します。

    OAuth アプリが構成されるまで、ユーザーはコネクタを認可できません。SObject All MCP サーバーがアクティブになるまで、アクションは使用できません。Salesforce の構成をご覧ください。

  3. 組織の [私のドメイン] の URL（https://example.my.salesforce.com など）をメモします。これを [インスタンス URI] として入力します。サンドボックス組織の場合は、サンドボックスの [私のドメイン]（例: https://example--sandbox.sandbox.my.salesforce.com）を使用します。

[私のドメイン] の URL を確認する

[インスタンス URI] として入力する [私のドメイン] の URL を確認するには:

  1. Salesforce で [Setup] に移動します。
  2. [クイック検索] ボックスで、[My Domain] を検索して選択します。
  3. [Current My Domain URL] で、URL（例: https://example.my.salesforce.com）をコピーします。

サンドボックス組織の場合は、サンドボックスでこの操作を行います。マイドメインの URL は https://example--sandbox.sandbox.my.salesforce.com のようになります。

Salesforce データストアを作成する

Salesforce データストアを作成する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. Google Cloud プロジェクトを選択するか作成します。

  3. ナビゲーション メニューで [データストア] をクリックします。

  4. [データストアを作成] をクリックします。

  5. [ソース] セクションで「Salesforce」を検索し、[選択] をクリックします。

  6. [データ] セクションで、次の操作を行います。

    1. [認証の設定] の [認証方法を選択する] で、次のいずれかのオプションを選択します。

      • OAuth 2.0（Google 管理）（デフォルト）:
        1. [インスタンス URI] に、Salesforce サイトの [私のドメイン] の URL（例: https://example.my.salesforce.com）を入力します。サンドボックス組織の場合は、サンドボックスの [私のドメイン]（例: https://example--sandbox.sandbox.my.salesforce.com）を入力します。
      • OAuth 2.0（Bring Your Own App）:
        1. [インスタンス URI] に、Salesforce サイトの [私のドメイン] の URL（例: https://example.my.salesforce.com）を入力します。サンドボックス組織の場合は、サンドボックスの [私のドメイン]（例: https://example--sandbox.sandbox.my.salesforce.com）を入力します。
        2. [クライアント ID] に、Salesforce 外部クライアント アプリのコンシューマ キーを入力します。
        3. [クライアント シークレット] に、Salesforce 外部クライアント アプリのコンシューマ シークレットを入力します。
        4. [Verify Auth] をクリックし、Salesforce へのログインを完了して OAuth 認証情報を確認します。

    2. [詳細オプション] で、サンドボックス組織を接続する場合は、[サンドボックスを使用する] を選択します。Salesforce は、サンドボックス組織からアクションを提供します。

    3. [続行] をクリックします。

    4. [検索するエンティティ] セクションで、Gemini Enterprise で検索するエンティティを選択します。Salesforce の場合は、[Salesforce MCP] を選択します。

  7. [続行] をクリックします。

  8. 省略可: [アクション] セクションで、ユーザーに有効にする作成、更新、削除のアクションを選択します。コネクタを読み取り専用にする場合は、選択を解除したままにします（読み取り専用アクションはデフォルトで有効になっています）。これらのアクションは、データストアの作成後に有効または無効にすることもできます。アクションを有効にするをご覧ください。

  9. [続行] をクリックします。

  10. [構成] セクションで、次の操作を行います。

    1. [マルチリージョン] リストから、データコネクタのロケーションを選択します。
    2. [データコネクタ名] フィールドに、コネクタの名前を入力します。
    3. ロケーションとして us または eu を選択した場合は、[暗号化設定] を構成します。
      • 省略可: 単一リージョンの鍵を構成していない場合は、[設定ページに移動] をクリックして構成します。詳細については、サードパーティ コネクタの単一リージョンの鍵を登録するをご覧ください。
      • [Googleが管理する暗号鍵] または [Cloud KMS 鍵] を選択します。
      • [Cloud KMS 鍵] を選択した場合:
        • [鍵管理のタイプ] リストで、適切なタイプを選択します。
        • [Cloud KMS 鍵] リストで、鍵を選択します。
      詳細については、顧客管理の暗号鍵をご覧ください。

  11. [続行] をクリックします。

  12. [お支払い] セクションで、[全般的な料金] または [構成可能な料金] を選択します。詳細については、プロジェクトの課金ステータスを確認するとライセンスをご覧ください。

  13. [作成] をクリックします。Gemini Enterprise によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

[データストア] ページで、データストア名をクリックしてステータスを確認します。データストアの状態が「作成中」から「アクティブ」に変わると、Salesforce データストアを使用できるようになります。

データストアを作成したら、作成したデータストアを既存のアプリに接続するか、新しいアプリを作成して新しいアプリに接続します。クエリを実行する前に、Gemini Enterprise が Salesforce にアクセスすることを承認します。

アクションを有効にする

Salesforce データストアを作成すると、そのアクションがデータストアに事前入力されます。読み取り専用アクション（Soql Query、Find、Get Object Schema、Get Related Records、List Recent Sobject Records、Get User Info）はデフォルトで有効になっており、常に使用できます。レコードを作成、更新、削除するアクション（Create Sobject Record、Update Sobject Record、Update Related Record、Delete Sobject Record、Delete Related Record）は、デフォルトでオフになっています。

データストアの作成時に作成、更新、削除のアクションを有効にしなかった場合は、次の手順でいつでも有効にできます。

  1. Google Cloud コンソールで、Salesforce データストアに移動します。

  2. [アクション] タブを選択します。

  3. 有効にするアクション（[Create Sobject Record]、[Update Sobject Record]、[Update Related Record]、[Delete Sobject Record]、[Delete Related Record]）を選択します。コネクタを読み取り専用のままにするには、これらのアクションを選択しないでください。

  4. [アクションを有効にする] をクリックします。

アクションの一覧については、サポートされているアクションをご覧ください。

データの取り扱いとクエリの実行

このセクションでは、Gemini Enterprise がクエリを管理する方法と、フェデレーション データストアの使用によるプライバシーへの潜在的な影響について説明します。

クエリ実行

Salesforce を承認した後、Gemini Enterprise に検索クエリを送信すると、次のようになります。

  • Gemini Enterprise は、検索クエリを Salesforce MCP サーバーに直接送信します。
  • Gemini Enterprise は、結果を他の接続されたデータソースからの結果と統合して、包括的な検索結果を表示します。

データの取り扱い

サードパーティのフェデレーション検索を使用する場合、次のデータ処理ルールが適用されます。

  • クエリ文字列がサードパーティの検索バックエンド（Salesforce MCP サーバー）に送信されます。
  • これらのサードパーティは、クエリをユーザーの ID に関連付ける場合があります。
  • 複数のフェデレーション検索データソースが有効になっている場合、クエリはそれらすべてに送信されることがあります。
  • データがサードパーティ システムに到達すると、そのシステムの利用規約とプライバシー ポリシーが適用されます。

次のステップ