- Erste Schritte
- UiPath Agents in Studio Web
- Über UiPath Agents
- Lizenzierung
- Ausführung von Agents
- Agents und Workflows
- Bewährte Verfahren zum Erstellen von Agents
- Auswahl des besten Modells für Ihren Agenten
- Best Practices für das Veröffentlichen und Bereitstellen von Agents
- Bewährte Verfahren für Kontext-Engineering
- Best Practices für DeepRAG und Batch-Transformation: JIT vs. indexbasierte Strategien
- Arbeiten mit Dateien
- Kontexte
- Eskalationen
- Bewertungen
- Spuren von Agents
- Agent-Punktzahl
- Verwaltung von UiPath Agents
- Codierte UiPath Agents
- Erstellen Sie mit Codierungs-Agents
- Überblick
- Erstellen Sie Low-Code-Agents mit Coding Agents
- Erstellen Sie codierte Agents mit Coding Agents
- Beispiel: Social Sentiment
Erstellen, Konfigurieren, Bewerten und Veröffentlichen von UiPath Low-Code-Agents vollständig über einen Codierungs-Agent und ein Terminal, ohne Browser nach der ersten Anmeldung.
Ein Codierungsagent mit installierten UiPath-Fähigkeiten kann UiPath Low-Code-Agents vollständig über Ihr Terminal erstellen, konfigurieren, validieren und veröffentlichen – nach der ersten Anmeldung ist kein Browser erforderlich. Sie beschreiben den Agent, den Sie erstellen möchten, der Codierungs-Agent erstellt und iteriert die Projektdateien und lädt das Ergebnis in Studio Web hoch.
Informationen zum Setup (Installieren des Agents, Anmelden, Installieren von Fähigkeiten) finden Sie unter Installieren und Einrichten.
Voraussetzungen
- Die für Ihren Codierungs-Agent installierte Fähigkeit
uipath-agents. Siehe Installieren und Einrichten. - Eine angemeldete Sitzung (
uip login).
Was der Agent tun kann
Jede Zeile deckt eine Phase des Agent-Lebenszyklus ab. Der Codierungsagent wählt die richtigen uip agent -Befehle aus der installierten Fähigkeit aus – Sie geben das Ergebnis an, nicht den Befehl.
| Area | Was der Agent tun kann | Beispiel: |
|---|---|---|
| Gerüst | Erstellen Sie ein neues Agent-Projekt mit der vollständigen Verzeichnisstruktur, einschließlich der agent.json /Ausgabeschemata und Standardauswertungssätze | „Erstellen Sie einen neuen Agenten zur Stimmungsanalyse für eingehende Kommentare auf sozialen Medien.“ |
| Konfigurieren Sie Prompts und Schemas | Bearbeiten Sie den Systemprompt, die Benutzernachrichtenvorlage, die Eingabe-/Ausgabeschemata und die LLM-Modelleinstellungen unter agent.json | „Aktualisieren Sie den System-Prompt, um Rechnungsdaten zu verarbeiten, und fügen Sie dem Ausgabeschema ein Konfidenzfeld hinzu.“ |
| Hinzufügen und verwalten von Tools | Fügen Sie RPA-Prozesse, andere Agents, API-Workflows, Maestro-Flows, Integration Service-Connector-Tools, Kontextgrundlage und Eskalations-Apps hinzu | „Fügen Sie ein SharePoint-Suchtool und einen RPA-Prozess für die Dokumentvalidierung hinzu.“ |
| Aktualisieren und validieren | Führen Sie uip agent refresh aus, um Artefakte zu schreiben und Einstiegspunktschemas zu synchronisieren, und uip agent validate zum Überprüfen der JSON-Struktur (schreibgeschützt); Fehler automatisch beheben | „Validieren Sie den Agent und beheben Sie alle Fehler.“ |
| Hochladen und Herunterladen | Laden Sie das lokale Projekt in Studio Web hoch (uip solution upload) oder laden Sie eine vorhandene Studio Web-Lösung herunter, um sie lokal zu bearbeiten (uip solution download) | „Laden Sie den Agent in Studio Web hoch, damit ich ihn überprüfen kann.“ |
| Auswerten | Erstellen Sie Evaluierungssätze und Testfälle, führen Sie sie für die Agent Runtime aus und überprüfen Sie die Punktzahlen und Ausführungsablaufverfolgungen | „Führen Sie den Regressionsevaluierungssatz aus und zeigen Sie mir, welche Testfälle unter 0,7 liegen.“ |
| Packen und bereitstellen | Verpacken und veröffentlichen Sie die Lösung über uip solution pack und uip solution publish, stellen Sie sie als Prozess bereit und starten Sie einen Auftrag | „Den Rechnungs-Agent für den Produktionsordner bereitstellen.“ |
Die Build-Schleife
Der Codierungsagent folgt bei der Erstellung oder Iteration eines Low-Code-Agents diesem Zyklus:
Gerüst > Konfigurieren > Ressourcen hinzufügen > Aktualisieren > Validieren > Korrektur > Hochladen
-
Gerüst – Erstellen Sie die Lösung mit
uip solution initund erstellen Sie dann mituip agent initein Gerüst für den Agent. -
Konfigurieren – Legen Sie die Prompts, Schemas und Modelleinstellungen in
agent.jsonfest. -
Ressourcen hinzufügen – Erstellen Sie unter
resource.jsoneine Dateiresources/<tool-name>/für jedes Tool, das der Agent benötigt. -
Aktualisieren – Schreiben Sie Artefakte und synchronisieren Sie Einstiegspunktschemas mit
uip agent refresh. -
Validieren – Überprüfen Sie die JSON-Struktur mit
uip agent validate(schreibgeschützt). -
Beheben – Korrigieren Sie alle Validierungsfehler und kehren Sie dann zu Aktualisieren zurück. Mehrere Zyklen sind erwartet und normal.
-
Hochladen – Sobald das Projekt sauber ist, laden Sie es mit
uip solution uploadin Studio Web hoch.
Ergebnis: Das Agent-Projekt ist jetzt in Studio Web sichtbar und zur Überprüfung, Bewertung oder Bereitstellung verfügbar.
Agent-Projektstruktur
Wenn der Codierungsagent uip solution init und uip agent init ausführt, wird die folgende Struktur erstellt:
<AgentName>/
├── agent.json # System prompt, user message template, LLM settings, input/output schemas
├── project.json # Project metadata
├── entry-points.json # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json # Resource binding references
├── SolutionStorage.json # Written after push — captures the Studio Web solution ID
│
├── resources/ # One directory per tool
│ └── <tool-name>/
│ └── resource.json # Tool config: type, connector key, schema, connection ID
│
├── connections/ # Connection references for bound Integration Service tools
│
├── evals/ # Evaluation configuration
│ ├── evaluators/ # Evaluator definitions (semantic similarity, trajectory by default)
│ └── eval-sets/ # Test case collections
│
└── userProfile/
└── debug_overwrites.json # Local connection overrides for debugging
<AgentName>/
├── agent.json # System prompt, user message template, LLM settings, input/output schemas
├── project.json # Project metadata
├── entry-points.json # Entry point definitions, kept in sync with agent.json schemas
├── bindings_v2.json # Resource binding references
├── SolutionStorage.json # Written after push — captures the Studio Web solution ID
│
├── resources/ # One directory per tool
│ └── <tool-name>/
│ └── resource.json # Tool config: type, connector key, schema, connection ID
│
├── connections/ # Connection references for bound Integration Service tools
│
├── evals/ # Evaluation configuration
│ ├── evaluators/ # Evaluator definitions (semantic similarity, trajectory by default)
│ └── eval-sets/ # Test case collections
│
└── userProfile/
└── debug_overwrites.json # Local connection overrides for debugging
Tooltypen
Der Codierungs-Agent registriert Tooltypen, indem er resource.json -Dateien direkt unter resources/<tool-name>/ erstellt. Das Feld type in jeder Datei bestimmt den Tooltyp. Die Unterstützung für die Runtime-Ausführung ist unterschiedlich – einige Typen können für die Studio Web-Kompatibilität registriert werden, werden aber noch nicht auf der Runtime des Agents ausgeführt.
| Tooltyp | resource.json Typ | Wird während der Runtime des Agents ausgeführt |
|---|---|---|
| Integration Service-Connector | integration | Ja |
| Orchestrator-Prozess (RPA) | process | Ja (nicht interaktiv) |
| Unteragent | agent | Ja |
| API-Workflow | api | Nur Registrierung |
| Maestro-Flow | processOrchestration | Nur Registrierung |
| IXP (Dokumentverarbeitung) | ixp | Nur Registrierung |
Kontextgrundlage, Eskalations-Apps und MCP-Server werden als separate Lösungsressourcen anstelle von resource.json -Dateien vom Tooltyp hinzugefügt. Der Codierungs-Agent erstellt sie und synchronisiert sie mit dem Projekt mit uip solution resources refresh.
Beispiel-Builds
Öffnen Sie Ihren Codierungs-Agent und beschreiben Sie den gewünschten Agent. Der Agent lädt die Fähigkeit von UiPath Agents und übernimmt den Rest.
| Was gefragt werden soll | Was erstellt wird |
|---|---|
| „Erstellen Sie einen neuen Agenten zur Stimmungsanalyse für eingehende Kommentare auf sozialen Medien.“ | Eigenständiger Agent mit einem benutzerdefinierten Systemprompt und strukturierten Eingabe-/Ausgabeschemata |
| „Fügen Sie einen Social Media Manager-Agent hinzu, der an den Stimmungsanalyse-Agent delegiert wird, um eine Reihe eingehender Kommentare zu bearbeiten.“ | Multi-Agent-Lösung mit einem Manager-Agenten, der den Agenten zur Stimmungsanalyse als Tool verwendet |
| „Erstellen Sie für mich einen Flow mit einem KI-Agenten zum Verfassen professioneller E-Mails.“ | Flow-Projekt mit einem Inline-Agentknoten, der mit Start- und Endknoten verbunden ist |
Evaluierung Ihres Agents
Der Codierungs-Agent kann eine vollständige Erstellung-Bewertung-Verbesserung-Schleife steuern:
- Erstellen und konfigurieren Sie den Agent lokal.
- In Studio Web hochladen (
uip solution upload) – Auswertungen werden gegen die Runtime des Agents ausgeführt und erfordern, dass das Projekt zuerst hochgeladen wird. - Führen Sie einen Auswertungssatz aus und warten Sie auf Ergebnisse.
- Überprüfen Sie die Punktzahlen pro Testfall, die Ausführungsablaufverfolgungen und die Fehlermeldungen.
- Passen Sie Prompts oder die Konfiguration basierend auf Fehlern an.
- Laden Sie den aktualisierten Agent (
uip solution upload) hoch. - Führen Sie den Auswertungssatz erneut aus.
Ergebnis: Die Bewertungsläufe werden erfolgreich abgeschlossen, wobei die Punktzahlen für jeden Testfall sichtbar sind und es klar angegeben ist, welche Fälle erfolgreich waren oder fehlgeschlagen sind.
Beispiel für folgende Frage:
- „Erstellen Sie einen Auswertungssatz namens regression-tests mit fünf Testfällen, der die wichtigsten Rechnungseingabeszenarien abdeckt.“
- „Führen Sie den Regression-Tests-Auswertungssatz aus und zeigen Sie die Ergebnisse an.“
- „Der dritte Testfall ist mit einer niedrigen Trajektorie-Punktzahl fehlgeschlagen – aktualisieren Sie den System-Prompt, um die Toolauswahl expliziter zu machen, und führen Sie sie erneut aus.“
Folgende Evaluierertypen sind verfügbar:
| Auswerter | Was gemessen wird |
|---|---|
| Semantische Ähnlichkeit | Vergleicht die erwartete Ausgabe semantisch mit der tatsächlichen Ausgabe |
| Verlauf | Überprüft, ob der Agent die erwartete Toolnutzung und Argumentationsschritte befolgt hat |
| Kontextgenauigkeit | Bewertet die Relevanz des abgerufenen Kontexts für die Abfrage |
| Genauigkeit | Bewertet, ob Agent-Antworten auf dem bereitgestellten Kontext basieren |
Siehe auch
- Getting started with UiPath agents — hands-on lab for building and deploying a low-code agent from the CLI.
- Installieren und einrichten – Installation des Agents und Fähigkeiten.
- Erstellen Sie codierte Agents mit Coding Agents – Python-basierte codierte Agents aus einem Terminal für einen Codierungsagenten.
- Übersicht über die Fähigkeiten – das Fähigkeitsmodell, das dieses Verhalten steuert.
- uip agent-Referenz – vollständige Befehlsreferenz für den Agent-Lebenszyklus, Tools, Evaluierungen, Push, Pull und Bereitstellung.