UIP-Agent

Erstellen, Validieren, Aktualisieren, Überprüfen und Verwalten von Low-Code-Agents mithilfe des Tools „uip agent“.

uip agent ist das Agent-Tool: Es erstellt ein Gerüst, validiert, migriert und überprüft Low-Code-Agents – die agent.json-gesteuerten Projekte, die in Agent Builder/Studio Web erstellt wurden. Installieren Sie es mit uip tools install agent oder rufen Sie uip agent … auf und lassen Sie die automatische Installation ausführen. Das Installationsmodell finden Sie unter Tools (Plugins) und unter UIP-Tools finden Sie den Befehl, der die Toolinstallation verwaltet.

Dieses Tool unterscheidet sich vom codierten Agent- Tool (uip codedagent), das auf Python-Agents abzielt, die mit LangGraph/LlamaIndex/OpenAI Agents erstellt wurden. uip agent funktioniert nur bei Low-Code-Agent-Projekten: einem Verzeichnis, das agent.json, entry-points.json, project.uiproj, einer evals/ -Struktur und features/ / resources/ -Ordnern enthält – oder für einen Agent, der in einem Maestro Flow, einem UUID-benannten Unterverzeichnis innerhalb des Flow-Projekts (--inline-in-flow).

uip agent hat kein pack, publish, deploy, push, pull, run, list, share, file, config, context, escalation Befehl , input oder output – das Verpacken und Versenden eines Agent-Projekts erfolgt stattdessen über uip solution (das Agent-Projekt ist ein Projekt innerhalb einer Lösung). Die Ressourcenerstellung (Tools, Kontexte, Eskalationen, I/O-Schema) erfolgt durch manuelle Bearbeitung von agent.json, nicht über ein dediziertes CLI-Verb.

Was ein UiPath-Agent ist

Ein Low-Code-Agent wird deklarativ durch eine einzelne agent.json -Datei beschrieben – Modell, Prompts, Eingabe-/Ausgabeschemata, Tools, Kontexte, Eskalationen und Einstellungen. Unterstützende Dateien beschreiben die Einstiegspunkte, die Studio Web zum Aufrufen des Agents, des Standardauswertungssatzes und etwaiger RAG/HITL-Ressourcen verwendet.

Der echte Lebenszyklus, der von uip agent abgedeckt wird, ist:

1. Erstellen Sie ein Gerüst für ein Projekt auf der Festplatte mit uip agent init (eigenständig oder --inline-in-flow innerhalb eines Maestro Flow-Projekts). Standardmäßig wird das Projekt automatisch im .uipx einer umgebenden Lösung registriert oder es wird automatisch ein neues <Name>Solution erstellt, wenn keine vorhanden ist.
2. Autor durch manuelle Bearbeitung agent.json (und der Dateien unter resources/, evals/).
3. Aktualisieren Sie das Projekt (uip agent refresh) nach jeder Bearbeitung – wendet ausstehende Schemamigrationen an und generiert entry-points.json / bindings_v2.json neu. Dies ist der einzige Befehl, der abgeleitete Dateien schreibt.
4. Das Projekt validieren (uip agent validate) – strikt, schreibgeschützt: antwortet „Wurde Studio Web dieses Verzeichnis so akzeptieren, wie es ist?“ ohne etwas zu schreiben.
5. Überprüfen Sie das Projekt anhand eines deterministischen Regelsatzes (uip agent review), um eine bewertete Qualitätsbewertung zu erhalten, und zeichnen Sie optional die Bewertung im Laufe der Zeit auf (uip agent review-history add).
6. Konfigurieren Sie LLM-Modelle (uip agent model list), Gedächtnisbereiche (uip agent memory), Leitplanken (uip agent guardrails) und Tools (uip agent tool list) nach Bedarf.
7. Debuggen Sie den Agent mit Studio Web (uip agent debug), um ihn vor der Auslieferung von Anfang bis Ende mit Beispieleingaben auszuführen.
8. Versenden mit uip solution pack / publish / upload / deploy – uip agent hat kein eigenes Verpackungs- oder Bereitstellungsverb.
9. Evaluieren Sie den Agent anhand eines Auswertungssatzes (uip agent eval run start) – funktioniert gegen eine in der Cloud gepushte Lösung (--solution-id oder automatisch von SolutionStorage.json erkannt) oder, wenn keines von beiden verfügbar ist, mit einem impliziten Auswertungspfad des lokalen Arbeitsbereichs.

Verben

Befehl	Zweck
Init	Erstellen Sie ein Gerüst für ein neues Agent-Projekt auf der Festplatte (eigenständig oder inline innerhalb eines Flow-Projekts).
Überprüfen	Strikte schreibgeschützte Prüfung: Wurde Studio Web dieses Projekt so akzeptieren, wie es ist?
refresh	Wenden Sie ausstehende Schemamigrationen an, und generieren Sie entry-points.json / bindings_v2.json neu.
Überprüfen	Bewerten Sie das Projekt anhand eines deterministischen Regelsatzes (Risiko, Punktzahl, Bewertung, Issues).
Überprüfungsverlauf	Zeichnen Sie eine Überprüfungsstufe in der lokalen Datei für den Überprüfungsverlauf des Projekts auf.
Toolliste	Listen Sie die für den Agent konfigurierten Toolressourcen auf.
Arbeitsspeicher	Anhängen, Auflisten und Entfernen von Gedächtnisbereichen und Gedächtniselementen.
Auswertung	Verwalten Sie Auswerter, Auswertungssätze, Testfälle und Auswertungsausführungen.
Leitlinien	Listen Sie Leitplankendefinitionen, BYOM-Leitplanken, LLM-als-Richter-Modelle und den Leitplankenkatalog auf.
model	Listen Sie LLM-Modelle auf, die für den authentifizierten Mandanten verfügbar sind.
Debuggen	Führen Sie den Agent mit Beispieleingaben für Studio Web aus und streamen Sie das Ergebnis.

Zusammenfassung

uip agent <verb> [subverb] [arguments] [options]

Immer uip agent, nie uip agents oder uip a. agent ist der commandPrefix des Tools (siehe uip tools list).

Alle uip agent -Verben berücksichtigen die vier globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem gemeinsamen Vertrag.

End-to-End-Flow

# 1. Scaffold (auto-registers into the surrounding solution, or creates one)
uip agent init ./my-agent --model gpt-5.4

# 2. Refresh after any edit to agent.json (migrates + regenerates derived files)
uip agent refresh ./my-agent

# 3. Validate the project is ready for upload (strict, read-only)
uip agent validate ./my-agent

# 4. Review for quality issues before shipping
uip agent review ./my-agent

# 5. Ship via the solution the project was registered into
uip solution pack . ./dist
uip solution upload .

# 6. Evaluate (against the cloud project once pushed, or the local workspace)
uip agent eval run start --set default --path ./my-agent --wait

# 7. Debug a specific run against Studio Web
uip agent debug ./my-agent -i '{"input":"hello"}'

Authentication

debug, eval run *, guardrails llm-as-judge-models und model list rufen Studio Web/das LLM Gateway auf und erfordern eine aktive CLI-Sitzung. Führen Sie zuerst uip login aus. Siehe Authentifizierung für das Sitzungsmodell.

init, validate, refresh, review, review-history, tool list, memory, guardrails list und guardrails catalog sind nur lokal und erfordern keine Sitzung.

Siehe auch

• Konzepte: Tools (Plugins) – das Plugin-Modell und das Versions- Anheft.
• uip-Lösung – Verpacken, Veröffentlichen und Bereitstellen der Lösung, in der ein Agent-Projekt enthalten ist.
• Authentifizierung – Sitzungen, Mandanten und Ordner.
• Globale Optionen, Exitcodes.