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.

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.

AreaWas der Agent tun kannBeispiel:
Gerüst erstellenErstellen 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 konfigurierenBearbeiten 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 verwaltenFü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 Validierenuip 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 HerunterladenLaden 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.“
AuswertenErstellen 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 BereitstellenPaketieren 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

  1. Gerüst erstellen – erstellen Sie die Lösung mit uip solution init, erstellen Sie dann den Agenten mit uip agent init.

  2. Konfigurieren – legen Sie die Prompts, Schemas und Modelleinstellungen in agent.jsonfest.

  3. Ressourcen hinzufügen – erstellen Sie eine resource.json-Datei unter 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 – prüfen Sie die JSON-Struktur mit uip agent validate (schreibgeschützt).

  6. Beheben – korrigieren Sie alle Validierungsfehler und fahren Sie anschließend zurück zu „Aktualisieren“. Mehrere Zyklen sind zu erwarten und sind 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, 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.

Tooltypresource.json TypWird in der Agent-Runtime ausgeführt
Integration Service-ConnectorintegrationJa
Orchestrator-Prozess (RPA)processJa (nicht interaktiv)
Unter-AgentagentJa
API-WorkflowapiNur Registrierung
Maestro-FlowprocessOrchestrationNur Registrierung
Intelligente Datenextraktion und Verarbeitung (IXP)ixpNur 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 solltenWas 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:

  1. Erstellen und konfigurieren Sie den Agent lokal.
  2. 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.
  3. Führen Sie einen Auswertungssatz aus und warten Sie auf Ergebnisse.
  4. Überprüfen Sie die Punktzahlen pro Testfall, die Ausführungsabläufe und Fehlermeldungen.
  5. Passen Sie Prompts oder Konfiguration basierend auf Fehlern an.
  6. Laden Sie den aktualisierten Agent hoch (uip solution upload).
  7. 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:

AuswerterWas gemessen wird
Semantische ÄhnlichkeitVergleicht 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
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