- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
UIP-Agent-Debugging
Führen Sie einen Low-Code-Agent für Studio Web mit Beispieleingaben aus und streamen Sie das Ergebnis mit „uip agent debug“.
uip agent debug führt einen End-to-End-Low-Code-Agent für Studio Web mit den von Ihnen bereitgestellten Eingaben aus, bis die Ausführung abgeschlossen ist und sich der Status ändert. Anmeldung erforderlich
Das Projekt muss ein project.uiproj -Manifest verwenden – ein Projekt, das sich noch auf dem älteren project.json -Layout befindet, schlägt schnell mit Konvertierungsanweisungen fehl (Paketbefehle wie uip solution pack/publish akzeptieren immer noch project.json; nur Studio-Web-gebundene Befehle wie für dieses ist das neuere Manifest erforderlich).
Zusammenfassung
uip agent debug <project-path> [-i <json>] [--attachment <field=path>]... [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]
uip agent debug <project-path> [-i <json>] [--attachment <field=path>]... [--poll-interval <ms>] [--timeout <seconds>] [--login-validity <minutes>]
Alle Aufrufe berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.
Argumente
<project-path>(erforderlich) – Der Pfad zum Agent-Projektverzeichnis (enthältagent.json).
Optionen
| Markieren | Standard | Zweck |
|---|---|---|
-i, --inputs <json> | {} | Input arguments as a JSON object, e.g. '{"input":"hello"}'. Must parse as a plain object. For a job-attachment field, pass an existing Orchestrator attachment reference, {"ID": "<attachment-id>"}, or use --attachment to upload a local file. |
--attachment <field=path> | – | Upload a local file into a job-attachment input field of agent.json. Repeatable. The field must be declared as {"$ref": "#/definitions/job-attachment"} in inputSchema. Repeat the same field only when its schema is an array of job-attachments. The path resolves from the current working directory, not from the agent project directory. Uploaded attachment IDs are returned in Data.Attachments. |
--poll-interval <ms> | 2000 | Abrufintervall in Millisekunden. |
--timeout <seconds> | 600 Sekunden (10 Minuten) | Maximale Sekunden, die gewartet werden soll, bis die Ausführung abgeschlossen ist. |
--login-validity <minutes> | 10 | Die verbleibenden Minuten vor dem Ablauf des Tokens sind erforderlich, um fortzufahren. |
Beispiele
uip agent debug ./my-agent -i '{"input":"hello"}'
uip agent debug ./my-agent --timeout 120 --poll-interval 5000
# Upload a local PDF into the job-attachment input field fileIn
uip agent debug ./my-agent --attachment fileIn=./invoice.pdf -i '{"question":"What is the total?"}'
uip agent debug ./my-agent -i '{"input":"hello"}'
uip agent debug ./my-agent --timeout 120 --poll-interval 5000
# Upload a local PDF into the job-attachment input field fileIn
uip agent debug ./my-agent --attachment fileIn=./invoice.pdf -i '{"question":"What is the total?"}'
An --attachment value for a field also present in --inputs overrides the --inputs value, and the command logs a warning. A required job-attachment input that has neither an --attachment nor an --inputs value also produces a warning.
Datenform (--output json)
Erfolg (Code: "AgentDebug"):
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "content": "hi there" }
},
"Instructions": "Debug run completed: Successful"
}
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "content": "hi there" }
},
"Instructions": "Debug run completed: Successful"
}
Output ist nur vorhanden, wenn die Ausführung eines erzeugt hat; Info ist nur vorhanden, wenn der Dienst zusätzliche Diagnoseinformationen zurückgegeben hat.
When the run uploads files with --attachment, Data.Attachments lists each upload:
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "answer": "1,234.00 USD" },
"Attachments": [
{
"Field": "fileIn",
"AttachmentId": "c3d4e5f6-0000-0000-0000-000000000002",
"FileName": "invoice.pdf",
"MimeType": "application/pdf",
"Size": 48213
}
]
}
}
{
"Code": "AgentDebug",
"Data": {
"JobKey": "a1b2c3d4-0000-0000-0000-000000000401",
"TraceId": "b2c3d4e5-0000-0000-0000-000000000001",
"State": "Successful",
"Output": { "answer": "1,234.00 USD" },
"Attachments": [
{
"Field": "fileIn",
"AttachmentId": "c3d4e5f6-0000-0000-0000-000000000002",
"FileName": "invoice.pdf",
"MimeType": "application/pdf",
"Size": 48213
}
]
}
}
To reuse an uploaded file in a later run without uploading it again, pass its reference in --inputs, for example '{"fileIn":{"ID":"c3d4e5f6-0000-0000-0000-000000000002"}}'.
Attachment errors — an invalid --attachment value (wrong field=path format, a field that is not a job-attachment input, a missing, empty, or directory path) fails before anything is uploaded or run, with Retry: "RetryWillNotFix". When Orchestrator refuses an upload, no debug job starts.
Nicht erfolgreicher Endstatus – derselbe Code: "AgentDebug", wird aber als Fehler zurückgegeben (Exitcode 1), wobei Message: "Debug run <state>." und Instructions auf uip traces spans get <TraceId> verweisen, um die Ausführung zu überprüfen.
Inkompatibles Projektmanifest:
{
"Result": "Failure",
"ErrorCode": "invalid_argument",
"Message": "...",
"Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}
{
"Result": "Failure",
"ErrorCode": "invalid_argument",
"Message": "...",
"Instructions": "Convert the listed project(s) to a project.uiproj manifest before debugging: scaffold the accepted layout with 'uip api-workflow init <name>' inside the solution and move Workflow.json (plus entry-points.json and bindings_v2.json) into it, then remove the project.json-based entry from the .uipx. Note that 'uip solution pack' and 'uip solution publish' accept project.json — only Studio Web-bound commands require project.uiproj."
}
Zugehörig
uip agent validate– Zuerst ausführen, um zu bestätigen, dass das Projekt gut formatiert ist; vorgeschlagen in Anweisungen zum Hochladen.uip traces spans get– überprüft die Ablaufverfolgung einer Debug-Ausführung nach einem nicht erfolgreichen Status.