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 einrichten, indem Sie die Installationsanweisungen auf der Seite Salesforce Agentforce-Entwicklertools befolgen.

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 fort.

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, und ersetzen Sie <yourSalesforceDomain> durch Ihre Organisationsdomäne.
2. Geben Sie in die Suchleiste UiPath-SF-Flow-Agents-Integration ein.
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 Verwendung in der Produktion.

      Hinweis: Während sich der UiPath Connector in der Vorschau befindet, ist eine 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 den 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 der erfolgreichen Installation Fertig aus.
10. Überprüfen Sie die Installation, indem Sie die Liste der installierten Pakete auf „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 Setup > 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, wählen Sie das Zahnradsymbol in der oberen rechten Ecke des Fensters und dann Einrichtung aus.
2. Geben Sie im Feld für die Schnellsuche in der linken Seitenleiste App-Manager ein und wählen Sie es aus.

   Die Liste der Apps, die bereits in Ihrer Salesforce-Organisation verfügbar sind, wird angezeigt.

3. Wählen Sie die Schaltfläche Neue verbundene App in der oberen rechten Ecke des Fensters aus.
   Abbildung 2. Erstellen einer neuen verbundenen App
   

   

   
   
4. Wählen Sie Verbundene App erstellen aus 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 die 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 Connector-Rückruf-URL 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. Flow für Client-Anmeldeinformationen: Wählen Sie nach der Aktivierung im folgenden Popup-Fenster OK aus, um zu bestätigen, dass jeder mit dem Verbraucherschlüssel und dem geheimen Verbraucherschlüssel im Namen des ausgewählten Benutzers auf Ihre Organisation zugreifen kann.
      2. Issue JSON Web Token (JWT)-basierte 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 die verbundene App
         

         

         
         
8. Wählen Sie Speichern aus, um die App zu speichern. Die folgende Meldung wird angezeigt: „Es kann bis zu 10 Minuten dauern, bis Änderungen wirksam werden. Beim Löschen einer übergeordneten Organisation 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 zum App-Manager.
2. Suchen Sie Ihre App (UiPath Salesforce Agentforce Flows Connector), wählen Sie den Dropdown-Pfeil auf der rechten Seite aus und wählen Sie Anzeigen aus.
   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.
   • Verbrauchergeheimschlüssel – Stellt den geheimen Clientschlüssel 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 für Client-Anmeldeinformationen das Feld Als Benutzer ausführen . Der Connector nimmt die Identität dieses Benutzers an, um die APIs für Flows und Agenten 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-basierten Zugriffstoken-Einstellungen für Named Users:
      • Aktivieren Sie das Kontrollkästchen JSON Web-Token (JWT)-basierte Zugriffstoken ausgeben .
      • Legen Sie das Token-Timeout auf einen Wert von 30 Minuten fest.
        Abbildung 6. JWT-basierte Zugriffstokeneinstellungen für Named Users
        

        

        
        
4. Wählen Sie Speichern.

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

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

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

1. Gehen Sie zum Setup und suchen Sie nach „Agent“.
2. Wählen Sie Agentforce-Agenten aus.
3. Wählen Sie im Abschnitt Benutzern Zugriff auf den Agentforce (Standard)-Agent gewähren den Namen Ihres benutzerdefinierten Agenten aus (z. B. Mein Agentforce Dienst-Agent).
   Abbildung 7. Gewähren des Zugriffs auf den Agentforce-Agenten
   

   

   
   
4. Wählen Sie die Registerkarte Verbindungen und dann Hinzufügen aus.
   Abbildung 8. Konfigurieren von Verbindungen für Ihren benutzerdefinierten Agentforce-Agenten
   

   

   
   
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 dann Einrichtung aus.
2. Geben Sie im Feld für die Schnellsuche 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.
   • Remote-Standort-URL: 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.

Konfigurieren Sie als Nächstes den Salesforce AgentForce- und Flows-Connector im Integration Service. Wechseln Sie zu Salesforce Agentforce und Flows-Authentifizierung, 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 linken oberen 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 zur 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 der Flow-Ausführung