Über codierte Agents

UiPath®-codierte Agents sind Agents, die durch direkte Codeentwicklung in der bevorzugten integrierten Entwicklungsumgebung (IDE) eines Entwicklers erstellt werden. Sie bieten Entwicklern die vollständige Kontrolle über die Agentenlogik, das Verhalten und die Integration mit externen Systemen.

Mit einem UiPath-SDK können Sie diesen Code als .nupkg-Standardpaket in einem Paketfeed Ihrer Wahl verpacken und im Orchestrator bereitstellen. Von dort aus kann er zur Erstellung von Prozessen innerhalb eines oder mehrerer Ordner verwendet werden.

Der codierte Agent wird als UiPath-Prozess innerhalb von Orchestrator-Ordnern bereitgestellt. Einmal in die Plattform integriert, hält es sich an dieselben Governance-Prinzipien wie Standardprozesse. Dadurch wird eine organisierte Bereitstellung innerhalb von Ordnern möglich, was bedeutet, dass Sie die Ausführung von Agents planen, auslösen und überwachen können, während Sie sie in umfassendere Automatisierungsworkflows integrieren.

Folgende Abbildung skizziert den Prozess der Erstellung, Bereitstellung und Ausführung eines codierten Agent innerhalb der UiPath-Plattform.

Abbildung 1. Zu dem Prozess gehören: 1) Definieren der Agentenlogik in einer IDE, 2) Aufbau einer sicheren Verbindung zu UiPath, 3) Bereitstellung des Agents im Orchestrator und 4) Ausführung des Agents innerhalb des UiPath-Ökosystems.

Unterstützte SDK-Sprachen und -Frameworks

Die UiPath-SDK-Bibliothek sowie die von ihr unterstützten Sprachen und Frameworks werden kontinuierlich erweitert. Wir unterstützen derzeit:

Sprache/Framework	Repository	Funktion
Python	uipath-python	Python-SDK mit einer CLI für die Erstellung, Verpackung und Bereitstellung von Agents auf der UiPath Cloud-Plattform. Damit ist auch die programmatische Interaktion mit UiPath-Plattform-Ressourcen wie Prozessen, Assets, Buckets, Kontextgrundlage, Datendiensten, Aufträgen und mehr möglich.
Python mit LangGraph	uipath-python-Erweiterung: uipath-langchain-python	Python-SDK, mit dem Entwickler LangGraph-Agents erstellen und auf der UiPath Cloud-Plattform bereitstellen können. Dieses Paket bietet eine programmatische Interaktion mit UiPath-Plattformdiensten und Human-in-the-Loop über das Action Center.
LLamaIndex	uipath-llamaindex-python	Python-SDK, mit dem Entwickler LlamaIndex-Agents erstellen und auf der UiPath-Plattform bereitstellen können. Dieses Paket bietet eine programmatische Interaktion mit den Diensten der UiPath-Cloud-Plattform und Human-in-the-Loop (HITL)-Semantik über die Integration im Action Center.

Die neuesten Informationen zu UiPath-SDK-Updates finden Sie in der Veröffentlichungsrichtlinie.

Fähigkeiten von codierten Agents

Integration von UiPath-Ressourcen über SDK

UiPath SDKs stellt Entwicklern die erforderliche Logik zum Aufrufen und Interagieren mit anderen UiPath-Ressourcen direkt innerhalb ihres Codes bereit, wodurch eine nahtlose Integration in vorhandenen UiPath-Funktionalitäten ermöglicht wird. Zum Beispiel können Entwickler UiPath-Assets zur sicheren Speicherung und Verwaltung von sensiblen Daten nutzen, auf in UiPath-Speicherbuckets gespeicherte Daten zugreifen und diese manipulieren sowie Verbindungen mit verschiedenen Systemen und Diensten verwalten. Darüber hinaus können Entwickler aus dem codierten Agent heraus andere UiPath-Prozesse auslösen und mit diesen interagieren.

Weitere Einzelheiten zu den UiPath-Ressourcen, die Sie für Ihren codierten Agent nutzen können, finden Sie in der Dokumentation zu SDK.

Weitere Beispiele und Implementierungsmuster finden Sie in den Beispielprojekten in unserem GitHub-Repository (Python, LlamaIndex).

Human-in-the-Loop für codierte Agents

Sie können Unterbrechungspunkte innerhalb Ihres Agents definieren, um menschliche Eingaben anzufordern. Wenn eine Unterbrechung ausgelöst wird, wird die Ausführung des Agents pausiert, und der zugewiesene Benutzer wird um Eingabe gebeten. Nach menschlicher Eingabe wird die Ausführung fortgesetzt.

Wie Sie Unterbrechungspunkte definieren, hängt von der Agentensprache ab:

• Einige Frameworks, wie LangGraph, bieten native Unterbrechungsmuster, die menschliches Eingreifen in die Ausführung des Agents ermöglichen.

• Mit den UiPath-SDKs können Sie eine UiPath-Aufgabe als Unterbrechungslogik einführen. Wenn eine Unterbrechung ausgelöst wird, pausiert die Ausführung und eine Aufgabe wird im Action Center erstellt.
  • Benutzer können den Fortschritt des Agents überprüfen, Feedback geben oder Entscheidungen treffen und die generierte Aufgabe über eine Aktions-App bearbeiten.
  • Nach Abschluss der menschlichen Interaktion setzt der Agent seine Ausführung vom Unterbrechungspunkt aus fort.

Konfiguration von Umgebungsvariablen für codierte Agents

Mithilfe von geheimen Assets können Sie ohne direkte Änderungen am Code Ihr Projekt mit Umgebungsvariablen konfigurieren.

Unter Nutzung der Unterstützung der Integration in externen Speichern von Zugangsdaten wie CyberArk für Zugangsdaten durch Orchestrator können Sie eine Verknüpfung mit Ihrem CyberArk-Speicher herstellen und eine Umgebungsvariable für Ihren Agent zur Nutzung des geheimen Assets konfigurieren. Zur Runtime ruft Orchestrator sicher den Schlüssel von CyberArk über das Asset und stellt diesen Ihren Agent als Umgebungsvariable bereit.

Gehen Sie zum Prozess Ihres Agent im Orchestrator, um API-Schlüssel, Runtime-Parameter und andere Konfigurationswerte zu definieren und zu verwalten, die für den Code Ihres Agents erforderlich sind. Weitere Einzelheiten dazu finden Sie unter Starten eines Agentenauftrags.

Aktivieren von Ablaufverfolgung und Debugging mit LangSmith

Konfigurieren Sie die standardmäßigen LangSmith-Umgebungsvariablen (wie LANGCHAIN_TRACING_V2, LANGCHAIN_API_KEY, LANGCHAIN_PROJECT), um eine detaillierte Ablaufverfolgung der Ausführung Ihres Agents innerhalb von LangSmith zu aktivieren.

Diese Integration stelltfür jeden Lauf eines UiPath Agents umfassende Ablaufverfolgungen in Ihrem LangSmith-Konto bereit. Dadurch können Sie die Argumentation und den Ausführungspfad des Agents analysieren und Bereiche zum Debuggen und zur Leistungsoptimierung identifizieren.