- Erste Schritte
- UiPath Konversations-Agents
- UiPath Agents in Studio Web
- Über UiPath Agents
- Lizenzierung
- Erweiterte Agents (Vorschau)
- 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-Überprüfung
- Codierte UiPath Agents
- Mit Coding Agents erstellen
- Überblick
- Low-Code-Agents mit Coding Agents erstellen
- Codierte Agents mit Coding Agents erstellen
- Beispiel: Social Sentiment Agent
Low-Code-Agents mit Coding Agents erstellen
Erstellen, konfigurieren, bewerten und veröffentlichen Sie Low-Code-Agents von UiPath vollständig von einem Coding Agent aus über ein Terminal, ohne Browser nach der ersten Anmeldung.
Ein Coding Agent mit installierten UiPath-Fähigkeiten kann Low-Code-Agents von UiPath 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 Coding Agent erstellt und iteriert die Projektdateien und lädt das Ergebnis in Studio Web hoch.
Informationen zur Einrichtung (Installieren des Agent, Anmelden, Installieren von Fähigkeiten) finden Sie unter „Installieren und einrichten“.
Voraussetzungen
- Die für Ihren Coding Agent installierte
uipath-agents-Fähigkeit. Siehe Installieren und Einrichten. - Eine angemeldete Sitzung (
uip login).
Was der Agent tun kann
Jede Zeile deckt eine Phase des Lebenszyklus des Agent ab. Der Coding Agent wählt die richtigen uip agent-Befehle aus der installierten Fähigkeit – Sie geben das Ergebnis an, nicht den Befehl.
| Area | Was der Agent tun kann | Beispiel: |
|---|---|---|
| Gerüst erstellen | Erstellen Sie ein neues Agent-Projekt mit der vollständigen Verzeichnisstruktur, einschließlich agent.json, Eingabe-/Ausgabeschemas und Standard-Auswertungssätzen. | „Erstellen Sie einen neuen Agent zur Stimmungsanalyse für eingehende Kommentare aus sozialen Medien.“ |
| Prompts und Schemas konfigurieren | Bearbeiten Sie den System-Prompt, die Vorlage für Benutzernachrichten, die Eingabe-/Ausgabeschemas und die LLM-Modelleinstellungen in agent.json | „Aktualisieren Sie den System-Prompt, um Rechnungsdaten zu verarbeiten, und fügen Sie dem Ausgabeschema ein Vertrauensfeld hinzu.“ |
| Tools hinzufügen und verwalten | Fügen Sie RPA-Processes, 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 | uip agent refresh ausführen, um Artefakte zu schreiben und Einstiegspunktschemas zu synchronisieren, und anschließend, uip agent validate ausführen, um die JSON-Struktur zu überprüfen (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 (uip solution upload) hoch, 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 Auswertungssätze und Testfälle, führen Sie sie gegen die Agent-Runtime aus, und überprüfen Sie die Punktzahlen und Ausführungsabläufe | „Führen Sie den Regressionstestsatz aus und zeigen Sie mir, welche Testfälle unter 0,7 liegen.“ |
| Packen und Bereitstellen | Paketieren 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. | „Stellen Sie den Agent im Produktionsordner bereit.“ |
Die Erstellungsschleife
Der Coding Agent folgt diesem Zyklus, wenn er einen Low-Code-Agent erstellt oder daran iteriert:
Gerüst erstellen > Konfigurieren > Ressourcen hinzufügen > Aktualisieren > Validieren > Beheben > Hochladen
-
Gerüst erstellen – erstellen Sie die Lösung mit
uip solution init, erstellen Sie dann den Agenten mituip agent init. -
Konfigurieren – legen Sie die Prompts, Schemas und Modelleinstellungen in
agent.jsonfest. -
Ressourcen hinzufügen – erstellen Sie eine
resource.json-Datei unterresources/<tool-name>/für jedes Tool, das der Agent benötigt. -
Aktualisieren – schreiben Sie Artefakte und synchronisieren Sie Einstiegspunktschemas mit
uip agent refresh. -
Validieren – prüfen Sie die JSON-Struktur mit
uip agent validate(schreibgeschützt). -
Beheben – korrigieren Sie alle Validierungsfehler und fahren Sie anschließend zurück zu „Aktualisieren“. Mehrere Zyklen sind zu erwarten und sind 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, Auswertung oder Bereitstellung verfügbar.
Agent-Projektstruktur
Wenn der Coding Agent läuft uip solution init und uip agent init, erstellt er die folgende Struktur:
<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 Coding 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 der Runtime-Ausführung variiert – einige Typen können für die Studio Web-Kompatibilität registriert werden, werden aber noch nicht in der Agent-Runtime ausgeführt.
| Tooltyp | resource.json Typ | Wird in der Agent-Runtime ausgeführt |
|---|---|---|
| Integration Service-Connector | integration | Ja |
| Orchestrator-Prozess (RPA) | process | Ja (nicht interaktiv) |
| Unter-Agent | agent | Ja |
| API-Workflow | api | Nur Registrierung |
| Maestro-Flow | processOrchestration | Nur Registrierung |
| Intelligente Datenextraktion und Verarbeitung (IXP) | ixp | Nur Registrierung |
Kontextgrundlage, Eskalations-Apps und MCP-Server werden als separate Lösungsressourcen und nicht als resource.json Tool-Dateien hinzugefügt. Der Coding Agent erstellt sie und synchronisiert sie mit dem Projekt uip solution resources refresh.
Beispiel-Builds
Öffnen Sie Ihren Coding Agent und beschreiben Sie den gewünschten Agent. Der Agent lädt die UiPath Agents-Fähigkeit und übernimmt den Rest.
| Was Sie fragen sollten | Was erstellt wird |
|---|---|
| „Erstellen Sie einen neuen Agent zur Stimmungsanalyse für eingehende Kommentare aus sozialen Medien.“ | Eigenständiger Agent mit einem benutzerdefinierten System-Prompt und strukturierten Eingabe-/Ausgabeschemas |
| „Fügen Sie einen Social Media Manager-Agent hinzu, der die Verarbeitung eines Satzes eingehender Kommentare an den Agenten für die Stimmungsanalyse delegiert.“ | Multi-Agent-Lösung mit einem Manager-Agent, der den Stimmungsanalyse-Agent als Tool verwendet |
| „Erstellen Sie für mich einen Flow mit einem KI-Agent zum Erstellen professioneller E-Mails.“ | Flow-Projekt mit einem Inline-Agent-Knoten, der mit Start- und Endknoten verbunden ist |
Auswerten Ihres Agenten
Der Coding Agent kann eine vollständige Schleife zum Erstellen, Auswerten und Verbessern durchführen:
- Erstellen und konfigurieren Sie den Agent lokal.
- Laden Sie ihn in Studio Web hoch (
uip solution upload) – Auswertungen werden gegen die Agent-Runtime 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ührungsabläufe und Fehlermeldungen.
- Passen Sie Prompts oder Konfiguration basierend auf Fehlern an.
- Laden Sie den aktualisierten Agent hoch (
uip solution upload). - Führen Sie den Auswertungssatz erneut aus.
Ergebnis: Die Auswertungsausführung wird erfolgreich abgeschlossen, wobei für jeden Testfall sichtbare Punktzahlen angezeigt werden und klar erkennbar ist, welche Fälle bestanden oder fehlgeschlagen sind.
Beispiel fordert:
- „Erstellen Sie einen Auswertungssatz mit dem Namen Regressionstests mit fünf Testfällen, die die wichtigsten Rechnungseingabeszenarien abdecken.“
- „Führen Sie den Auswertungssatz der Regressionstests aus und zeigen Sie die Ergebnisse an.“
- „Der dritte Testfall ist mit einer niedrigen Punktzahl fehlgeschlagen – aktualisieren Sie den System-Prompt, um die Toolauswahl expliziter zu gestalten, und führen Sie ihn erneut aus.“
Die folgenden Auswertertypen 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 den erwarteten Schritten zur Toolnutzung und zur Argumentation gefolgt ist |
| Kontextgenauigkeit | Bewertet die Relevanz des abgerufenen Kontexts für die Abfrage |
| Genauigkeit | Bewertet, ob Agent-Antworten auf dem bereitgestellten Kontext basieren. |
Siehe auch
- Erste Schritte mit UiPath-Agents – praktisches Labor zum Erstellen und Bereitstellen eines Low-Code-Agent aus der CLI.
- Installieren und einrichten – Agent-Einrichtung und Installation der Fähigkeiten.
- Erstellen Sie codierte Agents mit Coding Agents – Python-basierte codierte Agents aus einem Coding Agent-Terminal.
- Übersicht über die Fähigkeiten – das Fähigkeitsmodell, das dieses Verhalten steuert.
- uip-Agent-Referenz – vollständige Befehlsreferenz für Agent-Lebenszyklus, Tools, Auswertungen, Push, Pull und Bereitstellung.