Salesforce-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und Salesforce mit Gemini Enterprise verbinden. Der Datenspeicher durchsucht Ihre Salesforce-Einträge in Echtzeit und ermöglicht es Endnutzern, mit natürlicher Sprache darauf zuzugreifen.

Hinweis

Führen Sie vor dem Einrichten der Salesforce-Verbindung die folgenden Schritte aus:

1. Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

   1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

      IAM aufrufen

   2. Suchen Sie das Nutzerkonto und klicken Sie auf Bearbeiten Bearbeiten.
   3. Weisen Sie dem Nutzer die Rolle Discovery Engine Editor zu: Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.

2. Lassen Sie Ihren Salesforce-Administrator das verwaltete Paket Gemini Enterprise – Salesforce Connector von Salesforce AppExchange in der Salesforce-Organisation installieren, die Sie verbinden, und aktivieren Sie den MCP-Server SObject All in dieser Organisation. Bis das Paket installiert ist, können Nutzer den Connector nicht autorisieren. Bis der Server aktiv ist, sind keine Aktionen verfügbar. Siehe Salesforce-Konfiguration.

3. Notieren Sie sich die „Meine Domain“-URL Ihrer Organisation, z. B. https://example.my.salesforce.com. Geben Sie diesen als Instanz-URI ein. Verwenden Sie für eine Sandbox-Organisation die Sandbox „Meine Domain“, z. B. https://example--sandbox.sandbox.my.salesforce.com.

URL für „Meine Domain“ finden

So finden Sie die URL für „Meine Domain“, die Sie als Instanz-URI eingeben müssen:

1. Gehen Sie in Salesforce zu Setup.
2. Suchen Sie im Feld Quick Find (Schnellsuche) nach My Domain (Meine Domain) und wählen Sie die Option aus.
3. Kopieren Sie unter Aktuelle URL für „Meine Domain“ die URL, z. B. https://example.my.salesforce.com.

Bei einer Sandbox-Organisation tun Sie dies in der Sandbox. Die URL „Meine Domain“ sieht so aus: https://example--sandbox.sandbox.my.salesforce.com.

Hinweis: Salesforce verwendet von Google verwaltetes OAuth. Sie müssen keine eigene OAuth-Anwendung erstellen oder eine Client-ID und einen Clientschlüssel angeben. Sie autorisieren den Connector mit Ihrem Salesforce-Konto, wenn Sie den Connector in der App aktivieren.

Salesforce-Datenspeicher erstellen

So erstellen Sie den Salesforce-Datenspeicher:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Projekt auswählen oder erstellen Google Cloud .

3. Klicken Sie im Navigationsmenü auf Datenspeicher.

4. Klicken Sie auf Datenspeicher erstellen.

5. Suchen Sie im Abschnitt Quelle nach Salesforce und klicken Sie auf Auswählen.

6. Im Abschnitt Daten:

   1. Geben Sie unter Instanz-URI die URL „Meine Domain“ Ihrer Salesforce-Website ein, z. B. https://example.my.salesforce.com. Geben Sie für eine Sandbox-Organisation Ihre Sandbox-Domain ein, z. B. https://example--sandbox.sandbox.my.salesforce.com.

   2. Wenn Sie eine Sandbox-Organisation verbinden, wählen Sie Sandbox verwenden aus. Aktionen werden dann von Ihrer Sandbox-Organisation bereitgestellt.

   3. Klicken Sie auf Weiter.

   4. Wählen Sie im Bereich Zu suchende Entitäten die Entitäten aus, die Gemini Enterprise durchsuchen soll. Wählen Sie für Salesforce Salesforce MCP aus.

7. Klicken Sie auf Weiter.

8. Optional: Wählen Sie im Abschnitt Aktionen die Aktionen zum Erstellen, Aktualisieren und Löschen aus, die Sie für Ihre Nutzer aktivieren möchten. Wenn Sie keine Auswahl treffen, bleibt der Connector schreibgeschützt (schreibgeschützte Aktionen sind standardmäßig aktiviert). Sie können diese Aktionen auch nach dem Erstellen des Datenspeichers aktivieren oder deaktivieren. Weitere Informationen finden Sie unter Aktionen aktivieren.

9. Klicken Sie auf Weiter.

10. Im Abschnitt Konfiguration:

    1. Wählen Sie in der Liste Multiregional den Speicherort für den Daten-Connector aus.
    2. Geben Sie im Feld Name des Daten-Connectors einen Namen für den Connector ein.
    3. Wenn Sie us oder eu als Speicherort gewählt haben, konfigurieren Sie die Verschlüsselungseinstellungen:
       • Optional: Wenn Sie keine Schlüssel für einzelne Regionen konfiguriert haben, klicken Sie auf Zur Einstellungsseite, um dies zu tun. Weitere Informationen finden Sie unter Einen Schlüssel für eine einzelne Region für Drittanbieter-Connectors registrieren.
       • Wählen Sie Googleverwalteter Verschlüsselungsschlüssel oder Cloud KMS-Schlüssel aus.
       • Falls Sie Cloud KMS-Schlüssel ausgewählt haben:
         • Wählen Sie in der Liste Schlüsselverwaltungstyp den entsprechenden Typ aus.
         • Wählen Sie in der Liste Cloud KMS-Schlüssel den Schlüssel aus.
       Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel.

11. Klicken Sie auf Weiter.

12. Wählen Sie im Bereich Abrechnung die Option Allgemeine Preise oder die Option Konfigurierbare Preise aus. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen und Lizenzen.

13. Klicken Sie auf Erstellen. Gemini Enterprise erstellt den Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

Klicken Sie auf der Seite Datenspeicher auf den Namen des Datenspeichers, um den Status anzuzeigen. Sobald sich der Status des Datenspeichers von Wird erstellt zu Aktiv ändert, ist der Salesforce-Datenspeicher einsatzbereit.

Nachdem Sie den Datenspeicher erstellt haben, verbinden Sie ihn mit einer vorhandenen App oder erstellen Sie eine neue App und verbinden Sie ihn mit der neuen App. Autorisieren Sie Gemini Enterprise für den Zugriff auf Salesforce, bevor Sie Abfragen ausführen.

Hinweis: Im Schritt Autorisieren werden alle Nutzer auf die Salesforce-Anmeldeseite Ihrer Organisation weitergeleitet, um der Gemini Enterprise-App die Bereiche mcp_api und refresh_token zu gewähren. Dieser Schritt schlägt fehl, wenn das verwaltete Paket nicht in dieser Organisation installiert ist oder das Profil des Nutzers keinen Zugriff auf die App hat. Die Konfiguration statischer IP-Adressen pro Datenspeicher wird nicht unterstützt. Die IP-Validierung für Authentifizierungs- und Tokenaktualisierungsaufrufe wird in der vonGoogleverwalteten AppExchange-App erzwungen und Datenaufrufe werden mit dem gültigen Zugriffstoken des Nutzers autorisiert. Weitere Informationen finden Sie unter Anmelde-IP-Richtlinie für die App festlegen.

Aktionen aktivieren

Wenn Sie einen Salesforce-Datenspeicher erstellen, werden die zugehörigen Aktionen im Datenspeicher vorab ausgefüllt. Aktionen mit Lesezugriff (Soql-Abfrage, Suchen, Objektschema abrufen, Zugehörige Datensätze abrufen, Letzte Sobject-Datensätze auflisten und Nutzerinformationen abrufen) sind standardmäßig aktiviert und immer verfügbar. Aktionen, mit denen Datensätze erstellt, aktualisiert oder gelöscht werden (Sobject-Datensatz erstellen, Sobject-Datensatz aktualisieren, Zugehörigen Datensatz aktualisieren, Sobject-Datensatz löschen und Zugehörigen Datensatz löschen), sind standardmäßig deaktiviert.

Wenn Sie beim Erstellen des Datenspeichers keine Aktionen zum Erstellen, Aktualisieren oder Löschen aktiviert haben, können Sie sie jederzeit aktivieren. Gehen Sie dazu so vor:

1. Rufen Sie in der Google Cloud Console Ihren Salesforce-Datenspeicher auf.

2. Wählen Sie den Tab Aktionen aus.

3. Wählen Sie die Aktionen aus, die Sie aktivieren möchten (Sobject-Eintrag erstellen, Sobject-Eintrag aktualisieren, Zugehörigen Eintrag aktualisieren, Sobject-Eintrag löschen oder Zugehörigen Eintrag löschen). Wenn der Connector schreibgeschützt bleiben soll, wählen Sie diese Aktionen nicht aus.

4. Klicken Sie auf Aktionen aktivieren.

Eine Liste der Aktionen finden Sie unter Unterstützte Aktionen.

Datenverarbeitung und Abfrageausführung

In diesem Abschnitt wird beschrieben, wie Gemini Enterprise Ihre Abfrage verarbeitet und welche Auswirkungen die Verwendung des föderierten Datenspeichers auf den Datenschutz hat.

Ausführung von Abfragen

Nachdem Sie Salesforce autorisiert und eine Suchanfrage an Gemini Enterprise gesendet haben, passiert Folgendes:

• Gemini Enterprise sendet Ihre Suchanfrage direkt an den Salesforce-MCP-Server.
• Gemini Enterprise kombiniert die Ergebnisse mit denen aus anderen verbundenen Datenquellen und zeigt ein umfassendes Suchergebnis an.

Datenverarbeitung

Wenn Sie eine föderierte Suche von Drittanbietern verwenden, gelten folgende Regeln für die Datenverarbeitung:

• Ihr Abfragestring wird an das Such-Backend des Drittanbieters (Salesforce-MCP-Server) gesendet.
• Diese Drittanbieter können Abfragen mit Ihrer Identität verknüpfen.
• Wenn mehrere Datenquellen für die föderierte Suche aktiviert sind, wird die Abfrage möglicherweise an alle gesendet.
• Sobald die Daten im Drittanbietersystem angekommen sind, unterliegen sie den Nutzungsbedingungen und Datenschutzbestimmungen dieses Systems.

Hinweis: Um die Genauigkeit zu verbessern, kann ein LLM Ihre Anfrage umschreiben, bevor sie an Salesforce gesendet wird. Diese neu formulierte Abfrage kann Informationen aus dem Abfrageverlauf Ihrer Sitzung enthalten. Daher können Teile Ihres Suchanfragenverlaufs auch in die Abfrage aufgenommen werden, die an den Salesforce-MCP-Server gesendet wird.

Nächste Schritte

• Wenn Sie eine Benutzeroberfläche für das Abfragen Ihrer Salesforce-Daten bereitstellen möchten, erstellen Sie eine App und verbinden Sie sie mit dem Salesforce-Datenspeicher.
• Informationen zur Anzeige einer Vorschau der Suchergebnisse nach dem Einrichten der Anwendung finden Sie unter Suchergebnisse abrufen.
• Informationen zum Aktivieren von Benachrichtigungen für den Datenspeicher finden Sie unter Benachrichtigungen für Drittanbieter-Datenspeicher konfigurieren.