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>] [--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ält agent.json).

Optionen

Markieren	Standard	Zweck
-i, --inputs <json>	{}	Geben Sie Argumente als JSON-Objekt ein, z. B. '{"input":"hello"}'). Muss als einfaches Objekt geparst werden.
--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

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"
}

Output ist nur vorhanden, wenn die Ausführung eines erzeugt hat; Info ist nur vorhanden, wenn der Dienst zusätzliche Diagnoseinformationen zurückgegeben hat.

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."
}

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.

Siehe auch

• Authentifizierung, Globale Optionen, Beendigungscodes.