UIP-Ablaufverfolgungen

uip traces ruft LLM-Beobachtungsspannen für UiPath-Aufträge ab – die OpenTelemetry-Stil-Ablaufverfolgungen, die von codierten Agents und anderen KI-gestützten Workflows ausgegeben werden. Verwenden Sie diese Option, um eine vollständige Ablaufverfolgung für einen Orchestrator-Auftrag abzurufen, damit Sie Prompts, Toolaufrufe und Antwortzeiten von der Shell oder einer CI-Pipeline überprüfen können.

Unter Tools (Plugins) finden Sie weitere Informationen zur Integration dieses Tools in die CLI.

Zusammenfassung

uip traces spans get [<trace-id>] [--job-key <guid>]
                     [-t <tenant>]
                     [--folder-path <path>] [--folder-key <guid>]

Alle Unterbefehle berücksichtigen die globalen Optionen und Exitcodes.

UIP-Ablaufverfolgungen Spannen abrufen

Alle Spannen für eine Ablaufverfolgung zurückgeben. Sie können die Ablaufverfolgung direkt über ihre ID oder indirekt über den Orchestrator-Auftragsschlüssel beheben – das Tool löst die Trace-ID des Auftrags für Sie auf.

Argumente

• [trace-id] (optional) – Trace-ID im 32-Zeichen- oder GUID-Format.

Optionen

• --job-key <guid> – Der Orchestrator-Auftragsschlüssel. Alternative zu <trace-id>; Das Tool ruft die Metadaten des Auftrags ab und extrahiert seine Trace-ID.
• -t, --tenant <name> – Mandant. Standardmäßig der von uip login ausgewählte Mandant.
• --folder-path <path> – Orchestrator-Ordnerpfad (wird beim Auflösen des Auftrags verwendet).
• --folder-key <guid> – Orchestrator-Ordnerschlüssel (wird beim Auflösen des Auftrags verwendet).

Es muss genau eine von <trace-id> oder --job-key angegeben werden. Das Auslassen von beiden schlägt mit Failure: "Missing required argument" fehl.

Beispiele

# By trace ID
uip traces spans get 4bf92f3577b34da6a3ce929d0e0e4736

# By job key — the tool resolves the trace ID first
uip traces spans get --job-key a1b2c3d4-0000-0000-0000-000000000001

# By job key within a specific folder
uip traces spans get --job-key a1b2c3d4-0000-0000-0000-000000000001 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Datenform (--output json)

{
  "Code": "TraceSpans",
  "Data": [
    {
      "spanId": "00f067aa0ba902b7",
      "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
      "name": "llm.completion",
      "startTime": "2025-04-15T10:30:00.123Z",
      "endTime": "2025-04-15T10:30:01.456Z"
    }
  ]
}

Das Data -Array enthält ein Objekt pro Spanne in der Reihenfolge, in der das Backend sie zurückgibt. Die genauen Spannenfelder (Attribute, Ereignisse, übergeordnete/untergeordnete Links) hängen davon ab, was die ausgebende Laufzeit erfasst hat – die CLI normalisiert sie nicht.

Fehlerverhalten

• weder <trace-id> noch --job-key angegeben: Failure mit Instructions: "Provide either a trace-id argument or --job-key option", 1 beenden.
• --job-key zeigt auf einen unbekannten oder ablaufverfolgungsfreien Auftrag: Failure: "Error retrieving trace ID for job" mit der Backend-Fehlermeldung in Instructions.
• Ablaufverfolgung ist vorhanden, aber Spannen können nicht abgerufen werden: Failure: "Error retrieving spans for trace".

Zugehörig

• Tools (Plugins) – Installieren, Aktualisieren und Deinstallieren des Pakets traces-tool .
• uip login – Sitzung, die sowohl für die Auftragssuche als auch für den Spannenabruf verwendet wird.
• uip insights – Metriken zur Auftragsausführung; Agenten zu Ablaufverfolgungsdaten.