Integration von Systemen und Daten

Verwalten von Dateien mit Data Fabric

In UiPath Maestro™, werden Dateien über Data Fabric (früher als Datendienst bezeichnet) verwaltet. Jedes Mal, wenn eine Datei von einer Quelle (z.B. ein E-Mail-Anhang oder ein Cloud-Speicheranbieter) heruntergeladen wird, wird die Datei an eine Entität in Data Fabric hochgeladen, die die Dateispeicherung unterstützt.

Die Datei wird dann mithilfe einer Data Fabric-Referenz referenziert, einer Dreiergruppe, die Folgendes enthält:

• Entitätsname
• Datensatz-ID
• Feldname

Durch diesen Verweis kann die Datei überall in Ihrem agentischen Prozess verwendet werden.

Voraussetzungen

Bevor Sie Dateien in Maestro verwenden, stellen Sie sicher, dass:

• für Ihre Organisation oder Ihren Mandanten Data Fabric aktiviert ist.
• eine Entität mit einem dateiunterstützenden Feld konfiguriert wurde.

Keine zusätzlichen Felder sind erforderlich, abgesehen von denen, die automatisch von Data Fabric ausgefüllt werden, wenn ein Datensatz erstellt wird.

Beispiel für einen Anwendungsfall

Dieses Beispiel zeigt, wie man eine Datei von Box herunterlädt und sie als E-Mail-Anhang versendet.

1. Datei herunterladen
   • Konfigurieren Sie eine Senden-Aufgabe, um eine Datei-Download-Aktivität vom Box-Connector auszuführen.
   • Wählen Sie die Datei aus, die Sie herunterladen möchten.
   • Legen Sie die Dateiressourcenausgabe mit dem Data Fabric-Editor fest.Wählen Sie die Entität und das Feld aus, die Dateien unterstützen.
   
   
   
   
   
   Wenn ausgeführt, gibt die Aktivität eine Data Fabric-Referenz (EntityName, RecordId, FieldName) zurück, zurück, die auf den neuen Datei-Datensatz im Data Fabric verweist.
2. Die Datei per E-Mail versenden.
   • Konfigurieren Sie eine weitere Send-Aufgabe mit der Aktivität. E-Mail versendenim Outlook Connector.
   • Hängen Sie die Datei an, indem Sie die Datensatz-ID aus dem vorherigen Schritt im Data Fabric-Editor referenzieren.

Nach dem Testen finden Sie die Datensatz-Id in den Workflow-Variablen verfügbar.

Sie können auch überprüfen, ob die Datei in der Data Fabric-Anwendung existiert, indem Sie nach der Datensatz-Id suchen.

Wichtig:

• In Maestro werden Dateien ausschließlich über Data Fabric unterstützt.
• Wenn eine Datei bereits in Data Fabric vorhanden ist, können Sie sie wiederverwenden, indem Sie ihre Data-Fabric-Referenz hinzufügen.

Verwenden von Agents in Maestro

So funktionieren Agents in Maestro

Agents werden in BPMN-Workflows von Maestro als Serviceaufgaben dargestellt. Wenn Ihr Prozess eine Serviceaufgabe aufruft, ruft Maestro den entsprechenden Agenten mit den erforderlichen Eingabeparametern für die spezifische Prozessinstanz auf.

Agents geben Ausgabedaten an Maestro zurück, die zur Bestimmung der nächsten Schritte im Workflow verwendet werden. Sie können Agents so konfigurieren, dass sie die verwendeten Tools, getroffenen Entscheidungen und Protokolldaten melden, um Debugging und Transparenz zu unterstützen.

Agents können:

• Direkt in der UiPath-Plattform erstellt werden (Low-Code oder programmiert)
• Über externe APIs oder den Integration Service verbunden werden
• Durch Ereignisse oder Signale basierend auf der Workflowlogik ausgelöst werden

Sehen Sie sich ein Beispiel aus der Praxis an: UiPath Maestro: Die treibende Kraft hinter der nahtlosen und transparenten Automatisierung der Bearbeitung von Krediten.

Verbinden von Agents über Integration Service

UiPath Integration Service stellt vorgefertigte und benutzerdefinierte Connectors zur Integration externer Systeme in Ihren Automatisierungen bereit:

• Vorgefertigte Connectors für Dienste wie Salesforce, Microsoft 365 und Google Workspace
• Benutzerdefinierter Connector-Builder zur Bereitstellung einer REST-API für die UiPath-Plattform
• Einheitliche Verwaltung von Zugangsdaten und Verbindungen

Mithilfe des Integration Service können Sie Maestro das Senden und Empfangen von Daten von Agents oder Systemen erlauben, die nicht nativ in UiPath gehostet werden. Weitere Informationen zu Integration Service.

Mithilfe externer Agents

Maestro ist herstellerneutral. Sie können die Arbeit über Ihre bevorzugten externen KI-Agents hinweg orchestrieren – ohne Ihre Prozesse neu zu erstellen –, indem Sie UiPath Integration Service-Connectors verwenden.

Sie können Folgendes orchestrieren:

• Proprietäre KI-Dienste
• Externe Entscheidungsengines
• Microservices oder Bots, die auf anderen Plattformen gehostet werden

Maestro ruft diese Agents auf, indem es REST-Endpunkte aufruft und eine Antwortnutzlast mit strukturierten Daten erwartet.

Verbinden von externen Agents über Integration Service

Fügen Sie in der Entwurfsphase eine Serviceaufgabe hinzu, wählen Sie Starten und auf externen Agent warten aus und konfigurieren Sie die Agentaktivität über den ausgewählten Connector. Zur Runtime sendet Maestro den Prompt und den Kontext an den Agent und wartet auf die Antwort. Sie ordnen diese Antwort Variablen zu, um Gateways, Zuweisungen und nachfolgende Aktionen zu steuern.

Die folgenden Links zeigen, wie Sie eine Verbindung mit einem externen Agent herstellen, ihn über einen Maestro-Prozess ausführen und seine Ausgabe für Routing und Entscheidungen erfassen:

• Snowflake Cortex-Agents
• Databricks-Agents
• Azure AI Foundry-Agents
• Starten des CrewAI-Agents (Vorschau)
• Google Vertex-Agent ausführen

Schnellstart: API-Workflow-Integrationen

Verwenden Sie nach Möglichkeit Integration Service-Connectors, wenn diese vorhanden sind. Verwenden Sie API-Workflows, wenn Sie eine Verbindung auf API-Ebene benötigen (frühe APIs, sich ändernde Schemas oder Streaming-Antworten). Definieren Sie Anforderungen und Ausgaben deklarativ, parsen Sie JSON ohne benutzerdefinierten Code und übergeben Sie die Ergebnisse an Ihren Maestro-Prozess.

Wann was verwendet werden sollte:

• Connector: Unterstütztes System, stabiles Schema, verwaltete Authentifizierung, langfristig die beste Wahl.
• API-Workflow: Neue oder nicht unterstützte API, sich ändernde Antwortstrukturen oder nur Streaming-Unterstützung.

Schritt-für-Schritt-Anleitungen

• Snowflake Cortex – API-Workflow: Verarbeiten Sie die Streaming-Ausgabe des Cortex-Agents, fassen Sie sie zu einer verwendbaren Antwort zusammen und geben Sie strukturiertes JSON für die nachgelagerte Automatisierung zurück.
• Databricks Genie – API-Workflow: Starten Sie eine Unterhaltung, prüfen Sie den Nachrichtenstatus, bis er Abgeschlossen ist, extrahieren Sie das generierte SQL (attachment_id), führen Sie es aus und geben Sie die Antwort zurück.

Konfiguration von Agenteneigenschaften

In Maestro werden Agents wie Teilnehmer an einem Geschäftsprozess behandelt. In einem BPMN-Workflow werden Agents als Serviceaufgaben dargestellt, die sowohl von UiPath gehostete als auch externe Agents aufrufen können. Jede Agentenaufgabe ist mit bestimmten Eingabe- und Ausgabeparametern konfigurierbar, sodass Maestro kontextbezogene Daten an den Agent weiterleiten und im Gegenzug strukturierte Ergebnisse erhalten kann.

Einen Überblick über Serviceaufgaben in Maestro finden Sie unter Aufgaben in der BPMN-Modellierung.

Ausführungsmodi von Agents

Das Verhalten von Agents wird im Eigenschaftenbereich einer Serviceaufgabe definiert. Sie können die Aufgabe je nach Anforderung so konfigurieren, dass sie einen UiPath-Agent oder einen externen Agent aufruft.

Starten und auf Agent warten

Über diese Option können Sie einen in Ihrem UiPath-Mandanten bereitgestellten Agent aufrufen. Dazu gehören:

• Low-Code-Agents, die mit Tools wie Agent Builder erstellt wurden.
• Codierte Agents, die mit Python oder anderen Sprachen entwickelt und in Orchestrator bereitgestellt wurden.

Während der Runtime sendet Maestro Eingabeparameter im JSON-Format an den Agent. Wenn der Agent die Ausführung abschließt, gibt er eine Antwort mit den vom Prozess erwarteten Ausgabewerten zurück.

Starten und auf externen Agenten warten

Über diese Option könne Sie eine Verbindung zu externen Anbietern oder Systemen herstellen. Sie müssen Folgendes angeben:

• Connector: Das Integrationsziel (z. B. CrewAI, Salesforce oder ein anderer Dienst)
• Verbindung: Eine konfigurierte Instanz des Connectors, die entweder einen bestimmten Agent oder kontextspezifische Zugangsdaten darstellt.
  Hinweis: Sie können denselben Agent mit unterschiedlichen Berechtigungen oder Verhaltensweisen verwenden, indem Sie mehrere Verbindungen definieren.

Eingaben und Ausgaben

Eingaben und Ausgaben für Agents werden auf die gleiche Weise konfiguriert wie andere Maestro-Aufgabentypen.

• Eingaben: Variablen oder Ausdrücke, die zur Runtime an den Agent übergeben werden.
• Ausgaben: Variablen, die anhand der JSON-Antwort des Agents ausgefüllt werden.

Maestro sendet Eingabeparameter als JSON-Payload im Format:

{
  "key1": "value1",
  "key2": "value2"
}

Der Agent muss eine JSON-Antwort mit den von Maestro erwarteten Parameternamen zurückgeben. Diese Werte werden über den Abschnitt Ausgabe > Antwort im Eigenschaftenbereich der Aufgabe den Verarbeitungsvariablen zugeordnet.

Beispiele für Eingaben und Ausgaben

Beispiele für Eingaben (von Maestro an den Agent):

Parameter	Beschreibung
role	Rolle oder Kontext für die Aufgabe (z. B. Validierung vs. Zusammenfassung)
prompt	Anweisung, die dem Agent bereitgestellt wurde, häufig mit prozessspezifischen Daten.
tools	Liste der Tools, die der Agent zur Aufgabenbearbeitung nutzen darf.
user_id	Eindeutige Kennung, die zwischen dem Prozess und dem Agentenkontext geteilt wird

Beispiel für einen Prompt: „Schließe die Kreditprüfung für {loan_application_number} ab. Antworte im JSON-Format mithilfe des Parameters „loan_application_status.“

Beispiele für Ausgaben (vom Agent an Maestro)

Parameter	Beschreibung
conversation_id	Verweis auf die Dialog- oder Interaktionssitzung
loan_application_status	Vom Agent zurückgegebenes Statusergebnis
tokens_used	Metadaten zur Ressourcennutzung

Wichtig: Um Ausgaben des Agents in Ihrem Workflow zu verwenden, müssen Sie jeden Ausgabeparameter einer Prozessvariablen in der Konfiguration Ausgabe > Antwort der Aufgabe zuweisen.

Geschäftsregeln (Vorschau)

Mithilfe von Geschäftsregeln können RPA-Entwickler DMN-Dateien (Decision Model and Notation) als Teil eines Workflows oder Prozessdiagramms speichern und verwalten.

Geschäftsregeln im Orchestrator

Mit Geschäftsregeln im Orchestrator können Sie auf Entscheidungsmodell- und notationsbasierte (DMN) Regeln zugreifen und diese verwalten.Sie können diese Regeln innerhalb eines beliebigen agentischen Prozesses mithilfe einer dedizierten Aktivität auswerten.Darüber hinaus können Sie die Regeln ändern, ohne die Prozesse, die sie verwenden, neu bereitstellen zu müssen.Dies vereinfacht Aktualisierungen und die Aufrechterhaltung Ihrer Geschäftslogik.

Im Orchestrator verwenden wir diese Möglichkeiten zur Speicherung und Verwaltung:

• DMN-Dateien mit rollenbasiertem Zugang für sowohl Benutzer als auch Roboter speichern.
• Versionierung
• Geschäftsregeln über Ordner hinweg verknüpfen
• Kennzeichnung

Um Geschäftsregeln auszuführen, enthält Maestro eine neue Geschäftsregelaufgabe, die DMN v1.3 unterstützt.

Zugriff auf Geschäftsregelversionen

Um Ihre Geschäftsregeln im Blick zu behalten, verwenden Sie das Feld Version. Nachdem Sie die Geschäftsregel mit der hochgeladenen DMN-Datei gespeichert haben, können Sie deren Version nicht mehr ändern.

Sie können die Version einer Geschäftsregel auf der Seite Geschäftsregeln einsehen.Um die Version zu überprüfen, wählen Sie eine Geschäftsregel und bearbeiten Sie diese dann entweder oder gehen Sie direkt zu Weitere Aktionen und wählen Sie Versionen anzeigen.

Falls erforderlich, können Sie die Version einer Geschäftsregel auch über eine der folgenden Methoden herunterladen:

• Sobald Sie die DMN-Datei während der Erstellung der Geschäftsregel hochgeladen haben, wählen Sie das Download-Symbol neben der Datei aus.
• Wählen Sie auf der Seite Geschäftsregeln für die gewünschte Geschäftsregel Weitere Aktionen und dann Version herunterladen. Alternativ können Sie unter Weitere Aktionen die Option Versionen anzeigen wählen. Es öffnet sich eine Seitenleiste, in der Sie das Downloadsymbol neben der Version anklicken können, die Sie herunterladen möchten.

Geschäfstregeln-Links

Um Geschäftsregeln von anderen Ordnern zu verknüpfen:

1. Wählen Sie auf der Seite Geschäftsregeln die Option Geschäftsregel hinzufügen und dann Verknüpfung aus anderen Ordnern.
2. Als nächstes wird auf der Seite Geschäftsregel importieren eine Liste aller Geschäftsregeln aus anderen Ordnern angezeigt.
3. Wählen Sie eine oder mehrere Geschäftsregeln, um sie dem aktuellen Ordner hinzuzufügen, dann Weiter und anschließend Verknüpfen.

Geschäftsregel-Links verwalten:

1. Wählen Sie auf der Seite Geschäftsregeln eine Geschäftsregel, gehen Sie zu Weitere Aktionen und wählen Sie Verknüpfungen verwalten..
2. Wählen Sie im nächsten Fenster einen oder mehrere Ordner, denen Sie eine Geschäftsregel hinzufügen möchten, oder wählen Sie Ordner ab, um eine Geschäftsregel zu entfernen.
3. Wählen Sie Aktualisieren aus.

Eine Geschäftsregel ausführen

Hinweis:

Bevor Sie eine Geschäftsregel ausführen, stellen Sie bitte sicher, dass:

• eine DMN-Datei mit Hilfe eines DMN-konformen Editors modelliert haben.
• eine neue Geschäftsregel im Orchestrator erstellt haben, indem die DMN-Datei hochgeladen wurde.

1. Öffnen Sie zur Ausführung einer Geschäftsregel einen Maestro-Prozess.
2. Fügen Sie Ihrem Prozess eine Geschäftsregelaufgabe hinzu.
3. Wählen Sie die im Orchestrator gespeicherte DMN-Datei als Geschäftsregel aus.
4. Ordnen Sie Eingabe- und Ausgabeargumente entsprechend der Modellierung der DMN-Datei zu.

Eine Geschäftsregel bearbeiten

Um eine Geschäftsregel zu bearbeiten, müssen Sie über die Berechtigung zum Bearbeiten von Geschäftsregeln verfügen.

1. Wählen Sie auf der Seite Geschäftsregeln eine Geschäftsregel, gehen Sie zu Weitere Aktionen und wählen Sie Bearbeiten.
2. Als Nächstes können Sie folgende Felder bearbeiten: Name, Beschreibung, Labels, Eigenschaften und Datei.
   Hinweis:Nachdem Sie die Geschäftsregel mit der hochgeladenen DMN-Datei gespeichert haben, können Sie deren Version nicht mehr ändern.
   Hinweis:Stellen Sie sicher, dass die Namen der Argumente nur aus Buchstaben, Zahlen und dem Unterstrich bestehen. Die Namen müssen mit einem Buchstaben oder dem Unterstrich beginnen.
3. Wählen Sie Aktualisieren aus.

Eine Geschäftsregel entfernen

Um eine Geschäftsregel zu entfernen, müssen Sie über die Berechtigung zum Löschenvon Geschäftsregeln verfügen.

1. Wählen Sie auf der Seite Geschäftsregeln eine Geschäftsregel aus.
2. Gehen Sie als Nächstes zu Weitere Aktionen.
3. Wählen Sie Entfernen aus.

Prozess-Apps (Vorschau)

Überblick

Prozess-Apps bieten Geschäftsanwendern rollenbasierte Dashboards, Formulare und Triage Hubs zur Verwaltung der täglichen Vorgänge. Sie ermöglichen Echtzeiteinblicke in den Prozesszustand und helfen den Benutzern, Verzögerungen, Ineffizienzen und Eskalationen zu erkennen – und das alles über einen einheitlichen Arbeitsbereich für Agents, Roboter und Menschen.

Mit Prozess-Apps können Teams:

• Beheben Sie Verzögerungen und SLA-Verstöße mit Echtzeitkontext und geführten Entscheidungen.
• Treffen Sie intelligentere Ressourcenentscheidungen zur Verbesserung der betrieblichen Effizienz.
• Steigern Sie eine schnellere Problemlösung und bessere Geschäftsergebnisse im gesamten Unternehmen.

Prozess-Apps kombinieren die Prozessorchestrierung von Maestro und die UiPath®-Low-Code-App-Entwicklung und liefern so verwertbare Erkenntnisse für Betriebsteams, ohne zwischen den Systemen wechseln zu müssen.

Voraussetzungen

Um Prozess-Apps zu verwenden, stellen Sie sicher, dass die folgenden Dienste in Ihrem Automation Cloud-Mandanten verfügbar sind:

• UiPath Automation Cloud™
• UiPath Maestro™

Erste Schritte

Sie können Prozess-Apps mithilfe des UiPath TypeScript SDK und von Beispiel-App-Ressourcen erkunden.

Tabelle 1.

Ressource	Beschreibung
SDK-GitHub	UiPath TypeScript SDK-Dokumentation
Beispiel einer React-App	Prozess-App-Beispiel
NPM-Paket	UiPath-TypeScript-SDK

Beispielanwendungsfälle

• Triage-Dashboards: Verfolgen Sie Prozessvorfälle und reagieren Sie auf Eskalationen direkt über eine Betriebskonsole.
• Fall- und SLA-Verwaltung: SLAs überwachen, Verstöße identifizieren und Wiederherstellungsprozesse auslösen.
• Human-in-the-Loop-Vorgänge: Stellen Sie kontextbezogene Formulare für Genehmigungen, Korrekturen oder Ausnahmebehandlungen bereit.

Integration mit Maestro

Prozess-Apps stellen eine Verbindung mit Maestro-Prozess- und Vorfalldaten her, um Echtzeiteinblicke in laufende Ausführungen zu erhalten. Als Geschäftsanwender können Sie Instanzen überwachen, KPIs verfolgen und Aufgaben auf einer einzigen Oberfläche und ohne Entwicklertools bearbeiten.

Beispiel: Eine Finance Operations Prozess-App kann verzögerte Rechnungsgenehmigungen aus Maestro anzeigen und Benutzern ermöglichen, Aufgaben direkt zu genehmigen oder neu zuzuweisen, ohne die App zu verlassen.