UiPath Documentation
agents
latest
false
Benutzerhandbuch zu Agents
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Erstellen Sie Low-Code-Agents mit Coding Agents

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.

AreaWas der Agent tun kannBeispiel:
GerüstErstellen 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 SchemasBearbeiten 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 ToolsFü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 validierenFü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 HerunterladenLaden 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.“
AuswertenErstellen 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 bereitstellenVerpacken 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

  1. Gerüst – Erstellen Sie die Lösung mit uip solution init und erstellen Sie dann mit uip agent init ein Gerüst für den Agent.

  2. Konfigurieren – Legen Sie die Prompts, Schemas und Modelleinstellungen in agent.json fest.

  3. Ressourcen hinzufügen – Erstellen Sie unter resource.json eine Datei resources/<tool-name>/ für jedes Tool, das der Agent benötigt.

  4. Aktualisieren – Schreiben Sie Artefakte und synchronisieren Sie Einstiegspunktschemas mit uip agent refresh.

  5. Validieren – Überprüfen Sie die JSON-Struktur mit uip agent validate (schreibgeschützt).

  6. Beheben – Korrigieren Sie alle Validierungsfehler und kehren Sie dann zu Aktualisieren zurück. Mehrere Zyklen sind erwartet und normal.

  7. Hochladen – Sobald das Projekt sauber ist, laden Sie es mit uip solution upload in 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.

Tooltypresource.json TypWird während der Runtime des Agents ausgeführt
Integration Service-ConnectorintegrationJa
Orchestrator-Prozess (RPA)processJa (nicht interaktiv)
UnteragentagentJa
API-WorkflowapiNur Registrierung
Maestro-FlowprocessOrchestrationNur Registrierung
IXP (Dokumentverarbeitung)ixpNur 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 sollWas 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:

  1. Erstellen und konfigurieren Sie den Agent lokal.
  2. In Studio Web hochladen (uip solution upload) – Auswertungen werden gegen die Runtime des Agents ausgeführt und erfordern, dass das Projekt zuerst hochgeladen wird.
  3. Führen Sie einen Auswertungssatz aus und warten Sie auf Ergebnisse.
  4. Überprüfen Sie die Punktzahlen pro Testfall, die Ausführungsablaufverfolgungen und die Fehlermeldungen.
  5. Passen Sie Prompts oder die Konfiguration basierend auf Fehlern an.
  6. Laden Sie den aktualisierten Agent (uip solution upload) hoch.
  7. 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:

AuswerterWas gemessen wird
Semantische ÄhnlichkeitVergleicht die erwartete Ausgabe semantisch mit der tatsächlichen Ausgabe
VerlaufÜberprüft, ob der Agent die erwartete Toolnutzung und Argumentationsschritte befolgt hat
KontextgenauigkeitBewertet die Relevanz des abgerufenen Kontexts für die Abfrage
GenauigkeitBewertet, ob Agent-Antworten auf dem bereitgestellten Kontext basieren

Siehe auch

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben