Salesforce-Setup für den Agentforce & Flows-Connector

In diesem Leitfaden wird das wesentliche Salesforce-Setup beschrieben, das für die Verwendung des Integration Service Salesforce Agentforce- und Flow-Connectors erforderlich ist.

Voraussetzungen

Bevor Sie beginnen, stellen Sie Folgendes sicher:

• Sie haben einen Systemadministrator-Profilzugriff mit aktivierter API.

• Ihre Salesforce Edition ist Enterprise, Unlimited oder Developer Edition.

Sie können Ihre aktuelle Salesforce-Organisation verwenden oder eine neue Agentforce Developer Edition gemäß den Installationsanweisungen auf der Seite mit den Salesforce Agentforce-Entwicklertools einrichten.

Installieren und Konfigurieren des verwalteten Salesforce Flow Agents-Pakets

Hinweis:

Dieser Schritt ist für die Integration mit Salesforce-Flows erforderlich. Überspringen Sie bei der Integration mit Salesforce Agentforce diesen Schritt vollständig und fahren Sie direkt mit Konfigurieren einer verbundenen App in Salesforce.

Zugreifen auf und Installieren der AppExchange-Auflistung

Führen Sie die folgenden Schritte aus, um das verwaltete Paket UiPath-SF-Flow-Agents-Integration zu installieren:

1. Greifen Sie in einem Webbrowser auf die folgende Webseite zu: Salesforce AppExchange.

   Wichtig:

   Verwenden Sie für die aktuelle Vorschauversion des Salesforce Agentforce & Flows-Connectors die folgende URL, um auf das Paket zuzugreifen: https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0=04tPa000000bkIPIAY, wobei Sie <yourSalesforceDomain> durch Ihre Organisationsdomäne ersetzen.

2. Geben Sie in der Suchleiste Folgendes ein: UiPath- SF-Flow-Agents-Integration.

3. Wählen Sie die App-Auflistung und dann Jetzt abrufen aus .

4. Melden Sie sich mit Ihren Salesforce-Anmeldeinformationen an, um die Installation fortzusetzen.

5. Wählen Sie Ihre Installationsumgebung aus:

   1. Produktion: Für Live-Salesforce-Umgebungen.
   2. Sandbox: Zum Testen vor der Produktionsnutzung. Hinweis: Während sich der UiPath Connector in der Vorschau befindet, ist die Umgebungsauswahl nicht verfügbar.

6. Wählen Sie Nur für Administratoren installieren aus. Diese Auswahl gewährt nur Systemadministratoren Zugriff auf das Paket. Alternativ können Sie das verwaltete Paket einem bestimmten Benutzer mit entsprechenden Berechtigungen zur Verfügung stellen.

7. Aktivieren Sie das Kontrollkästchen zum Bestätigen der Installation einer Nicht-Salesforce-Anwendung.

8. Wählen Sie Installieren aus.

9. Wählen Sie nach einer erfolgreichen Installation Fertig aus .

10. Überprüfen Sie die Installation, indem Sie in der Liste der installierten Pakete „UiPath- SF-flow-agents-integration“ überprüfen.

    Abbildung 1. Das Fenster Installierte Pakete in Salesforce

    

Zuweisen von Berechtigungssätzen

So gewähren Sie Benutzern mit Zugriff auf das verwaltete Paket die erforderlichen Berechtigungen:

1. Navigieren Sie zu Einrichtung > Benutzer > Berechtigungssatz.
2. Suchen Sie den Agentforce-Standardadministrator.
3. Wählen Sie Zuweisungen verwalten aus.
4. Wählen Sie Zuweisungen hinzufügen aus.
5. Wählen Sie die erforderlichen Benutzer aus.
6. Wählen Sie Weiter und dann Zuweisen aus.

Konfigurieren einer verbundenen App in Salesforce

Eine verbundene App wird erstellt

1. Öffnen Sie den App-Manager, klicken Sie auf das Zahnradsymbol in der oberen rechten Ecke des Fensters und wählen Sie Einrichtung.

2. Geben Sie im Feld Schnellsuche in der linken Seitenleiste App-Manager ein und wählen Sie ihn aus. Die Liste der Apps, die bereits in Ihrer Salesforce-Organisation verfügbar sind, wird angezeigt.

3. Wählen Sie die Taste Neue verbundene App in der oberen rechten Ecke des Fensters.

   Abbildung 2. Erstellen einer neuen verbundenen App

   

4. Wählen Sie Verbundene App erstellen und dann Weiter.

   Abbildung 3. Das Fenster Verbundene App erstellen

   

5. Füllen Sie den Abschnitt Grundlegende Informationen für die neue verbundene App aus:

   1. Geben Sie einen Namen an. Zum Beispiel UiPath Salesforce Agentforce Flows Connector.
   2. API-Name: Dieses Feld wird basierend auf dem angegebenen App-Namen automatisch ausgefüllt.
   3. Kontakt-E-Mail angeben: Geben Sie Ihre E-Mail-Adresse für jegliche Supportkommunikation ein.

6. Um OAuth-Einstellungen für die neue App zu aktivieren, scrollen Sie zum Abschnitt API (OAuth-Einstellungen aktivieren) .

   1. Aktivieren Sie das Kontrollkästchen OAuth-Einstellungen aktivieren .
   2. Geben Sie die Rückruf-URL an, indem Sie die Rückruf-URL des Connectors angeben: https://cloud.uipath.com/provisioning\\_/callback.
   3. Fügen Sie die erforderlichen OAuth-Scopes hinzu:
      • Für Salesforce-Flows:
        • Vollständiger Zugriff (full)
        • Anforderungen jederzeit ausführen (refresh_token, offline_access)
      • Für Salesforce Agentforce:
        • Auf Chatbot-Dienste zugreifen (chatbot_api)
        • Auf die Salesforce API-Plattform zugreifen (sfap_api)
        • Vollständiger Zugriff (full)
        • Benutzerdaten über APIs verwalten (api)
        • Anforderungen jederzeit ausführen (refresh_token, offline_access)

7. Verwalten Sie die Sicherheitseinstellungen für die verbundene App:

   1. Aktivieren Sie die folgenden Kontrollkästchen:
      1. Client-Anmeldeinformationen: Wenn diese Option aktiviert ist, wählen Sie im folgenden Popup-Fenster OK aus, um zu bestätigen, dass jeder mit dem Verbraucherschlüssel und dem Verbrauchergeheimnis im Namen des ausgewählten Benutzers auf Ihre Organisation zugreifen kann.
      2. Ausstellen von JSON Web Token (JWT)-basierten Zugriffstoken für benannte Benutzer – Wenn Sie den OAuth 2.0-Autorisierungscode für die Authentifizierung mit dem Integration Service-Connector verwenden möchten, aktivieren Sie dieses Kontrollkästchen nicht.
   2. Deaktivieren Sie die folgenden Kontrollkästchen:

      1. Für unterstützte Autorisierungsabläufe ist die Erweiterung „Proof Key for Code Exchange“ (PKCE) erforderlich

      2. Geheimer Schlüssel für Webserver-Flow erforderlich

      3. Geheimer Schlüssel für den Aktualisierungstokenflow erforderlich

         Abbildung 4. API-Einstellungen für verbundene Apps

         

8. Wählen Sie Speichern aus, um die App zu speichern. Die folgende Meldung wird angezeigt: „Änderungen können bis zu 10 Minuten dauern, bis sie wirksam werden. Wenn Sie eine übergeordnete Organisation löschen, werden auch alle verbundenen Apps mit aktivierten OAuth-Einstellungen gelöscht.“

Abrufen der Client-ID und des geheimen Clientschlüssels

1. Gehen Sie zurück zu App-Manager.

2. Suchen Sie Ihre App (UiPath Salesforce Agentforce Flows Connector), wählen Sie den Dropdown-Pfeil auf der rechten Seite und wählen Sie Anzeigen.

   Abbildung 5. Anzeigen der App-Details

   

3. Wählen Sie Verbraucherdetails verwalten aus.

4. Schließen Sie die Schritte zur Sicherheitsüberprüfung ab, wenn Sie dazu aufgefordert werden. Salesforce kann einen Verifizierungscode anfordern, der an Ihre registrierte E-Mail-Adresse gesendet wird. Geben Sie den Code ein, wenn Sie aufgefordert werden, fortzufahren.

5. Die folgenden Anmeldeinformationen werden angezeigt:

   • Verbraucherschlüssel – Stellt die Client-ID dar.
   • Verbrauchergeheimnis – Stellt das Clientgeheimnis dar. Wichtig: Kopieren und speichern Sie beide Werte sicher. Diese Anmeldeinformationen sind zum Konfigurieren des Integration Service-Connectors erforderlich.

Konfigurieren der verbundenen App für JWT und Flow für Client-Anmeldeinformationen

1. Gehen Sie zu Einrichtung > Verbundene Apps verwalten.
2. Suchen Sie Ihre verbundene App (UiPath Salesforce Agentforce Flows Connector) und wählen Sie sie aus.
3. Wählen Sie Richtlinien bearbeiten aus:
   1. Konfigurieren Sie unter Flow der Client-Anmeldeinformationen das Feld Als Benutzer ausführen . Der Connector gibt die Identität dieses Benutzers an, um die APIs für Flows und Agents aufzurufen. Hinweis: Dies ist das Dienstkonto für den Connector. Stellen Sie sicher, dass Sie einen Benutzer auswählen, der über die erforderlichen Berechtigungen verfügt (nur API-Zugriff oder API aktiviert).
   2. Unter JWT-basierte Zugriffstokeneinstellungen für benannte Benutzer:

      • Aktivieren Sie das Kontrollkästchen JSON-Webtoken (JWT)-basierte Zugriffstoken ausstellen .

      • Legen Sie das Token-Timeout auf einen Wert von 30 Minuten fest.

        Abbildung 6. JWT-basierte Zugriffstokeneinstellungen für Named User

        

4. Wählen Sie Speichern.

Aktivieren des UiPath-Connector-Zugriffs auf Ihre benutzerdefinierten Agentforce-Agenten

Hinweis:

Dieser Schritt ist für den Agent AgentForce (Standard) nicht erforderlich.

Führen Sie für jeden benutzerdefinierten Agenten die folgenden Schritte aus:

1. Gehen Sie zu Einrichtung und suchen Sie nach „Agent“.

2. Wählen Sie Agentforce-Agents.

3. Wählen Sie im Abschnitt Benutzern Zugriff auf den Agentforce-Agenten (Standard) gewähren den Namen Ihres benutzerdefinierten Agenten aus (z. B. Mein Agentforce Dienst-Agent).

   Abbildung 7. Benutzern Zugriff auf den Agentforce-Agenten gewähren

   

4. Wählen Sie die Registerkarte Verbindungen und dann Hinzufügen.

   Abbildung 8. Konfigurieren von Verbindungen für Ihren benutzerdefinierten Agentforce-Agent

   

5. Im Fenster Verbindung hinzufügen :

   1. Legen Sie das Feld Verbindung auf API fest.

   2. Geben Sie einen Integrationsnamen an, z. B. UiPath Connector.

   3. Wählen Sie unter Verbundene App die verbundene App aus, die Sie zuvor erstellt haben (UiPath Salesforce AgentForce Flows Connector).

      Abbildung 9. UiPath Salesforce AgentForce Flows-Connector

      

   4. Speichern Sie die Verbindung.

Konfigurieren der Einstellungen für den Remote-Standort

1. Wählen Sie im App-Manager das Zahnradsymbol in der oberen rechten Ecke des Fensters und wählen Sie Einrichtung.
2. Geben Sie im Schnellsuche- Feld in der linken Seitenleiste Remote-Standort-Einstellungen ein .
3. Wählen Sie unter Sicherheit die Option Einstellungen für Remote-Standort aus.
4. Wählen Sie Neue Remote-Site aus, um eine neue Site zu erstellen.
5. Konfigurieren Sie die neue Site, indem Sie die folgenden Informationen angeben:
   • Name des Remote-Standorts: Geben Sie eine alphanumerische Zeichenfolge ohne Leerzeichen ein, z. B. UiPathRemoteSite.
   • URL des Remote-Standorts: Geben Sie die Basis-URL ein, z. B. https://cloud.uipath.com.
   • Beschreibung: Geben Sie eine Beschreibung ein, z. B. „Basis-URL der UiPath-Integration für den Flow-Aufruf“. Dieses Feld ist optional.
   • Aktiv: Stellen Sie sicher, dass das Kontrollkästchen aktiviert ist.
6. Wählen Sie Speichern aus, um diese Einstellungen zu bestätigen und zu aktivieren.

Ihr UiPath-Connector kann jetzt auf Ihren benutzerdefinierten Salesforce-Agenten zugreifen. Stellen Sie sicher, dass der Agent, den Sie aufrufen möchten, aktiviert ist.

Als Nächstes konfigurieren Sie den Salesforce AgentForce & Flows-Connector im Integration Service. Wechseln Sie zu Salesforce Agentforce & Flows , um eine Verbindung zu erstellen.

Häufige Probleme und Fehlerbehebung

Im folgenden Abschnitt sind häufige Probleme aufgeführt, die beim Konfigurieren des verwalteten Pakets Salesforce Flow Agents oder einer verbundenen App auftreten können, und deren Behebung.

Problem: Die Installation des verwalteten Pakets schlägt aufgrund fehlender Abhängigkeiten fehl

1. Stellen Sie sicher, dass alle erforderlichen Salesforce-Funktionen (wie API-Zugriff und Einstein AI) aktiviert sind.
2. Überprüfen Sie die Paketabhängigkeiten in den Installationsprotokollen.

Problem: Benutzer können nicht auf bestimmte Funktionen zugreifen

• Stellen Sie sicher, dass dem Dienstkontobenutzer und den Endbenutzern des Agenten die richtigen Profile und Berechtigungssätze zugewiesen wurden.
• Stellen Sie sicher, dass Sie den Agenten aktiviert haben.

Problem: Externes System kann nicht mit Salesforce verbunden werden

• Überprüfen Sie die API-Einstellungen und stellen Sie sicher, dass die OAuth-Authentifizierung für die verbundene App konfiguriert ist.

Überwachen und Überprüfen des Ausführungsstatus von automatisch gestarteten Flows, die über den UiPath Connector ausgelöst werden

Führen Sie die folgenden Schritte aus, um auf das benutzerdefinierte Flow Execution-Protokollobjekt in Salesforce zuzugreifen:

1. Navigieren Sie zum App Launcher (das Rastersymbol in der oberen linken Ecke).

2. Suchen Sie in der Suchleiste nach Flow-Ausführung .

3. Wählen Sie die Registerkarte Flowausführung oder den Objektnamen aus, der in den Suchergebnissen angezeigt wird. Diese Aktion öffnet die Listenansicht der Flow-Ausführungsdatensätze. Für jeden Flow, der über den UiPath Connector ausgelöst wird, wird ein neuer Datensatz erstellt.

   Abbildung 10. Datensätze der Flow-Ausführung

   

4. Wählen Sie einen bestimmten Namen einer Flow-Ausführung aus, um die Details dieser Ausführung anzuzeigen.

   Abbildung 11. Details zur Flow-Ausführung