Traçages UIP

Syntaxe et options pour `uip traces`, qui récupère les étendues d'observabilité LLM pour les tâches UiPath à partir du shell ou du pipeline CI.

uip traces extrait les étendues d'observabilité LLM pour les tâches UiPath — les traces de style OpenTelemetry émises par les agents codés et d'autres workflows basés sur l'IA. Utilisez-le pour extraire une trace complète d'une tâche Orchestrator afin de pouvoir inspecter les invites, les appels d'outils et les temps de réponse à partir du shell ou d'un pipeline CI.

Cet outil enregistre également un groupe de commandes feedback (create, get, list, list detailed, update, delete) pour gérer les commentaires d’observabilité LLM associés à un traçage ou à une étendue - voir uip traces feedback.

Voir Outils pour découvrir comment cet outil s'intègre à la CLI.

Synthèse

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

Toutes les sous-commandes respectent les options globales et les codes de sortie.

Obtenir les étendues de traçages uip

Renvoyez toutes les étendues d'un traçage. Vous pouvez adresser le traçage directement par son ID, ou indirectement par la clé de tâche Orchestrator — l'outil résout l'ID de traçage de la tâche pour vous.

Arguments

• [trace-id] (facultatif) : ID de traçage au format hexadécimal ou GUID de 32 caractères.

Options

• --job-key <guid> — Clé de tâche Orchestrator. Alternative à <trace-id>; l'outil récupère les métadonnées de la tâche et extrait son ID de traçage.
• --folder-path <path> : chemin du dossier Orchestrator (utilisé lors de la résolution de la tâche).
• --folder-key <guid> — Clé de dossier Orchestrator (utilisée lors de la résolution de la tâche).

L’un des identifiants <trace-id> ou --job-key doit être fourni. L'absence des deux échoue avec Failure: "Missing required argument".

Exemples

# 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

Format des données (--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"
    }
  ]
}

Le tableau Data contient un objet par étendue, dans l'ordre dans lequel le backend les renvoie. Les champs de l'étendue exacte (attributs, événements, liens parent/enfant) dépendent de ce que le runtime d'émission a capturé - la CLI ne les normalise pas.

Comportement des erreurs

• Aucun <trace-id> ni --job-key fourni: Failure avec Instructions: "Provide either a trace-id argument or --job-key option", sortie 1.
• --job-key pointe vers une tâche inconnue ou sans traçage: Failure: "Error retrieving trace ID for job" avec le message d'erreur principal dans Instructions.
• Le traçage existe mais les étendues ne peuvent pas être extraites: Failure: "Error retrieving spans for trace"

Associé

• uip traces feedback — créer, lire et gérer les commentaires Observabilité LLM sur une trace ou une étendue.
• Outils (extensions) : installez, mettez à jour, désinstallez le package traces-tool .
• uip login — session utilisée à la fois pour la recherche de la tâche et la récupération de l'étendue.
• uip insights — métriques d'exécution de tâche; Orchestrator pour les données de traçage.