uip traces

「uip traces」の構文とオプション - シェルまたは CI パイプラインから UiPath のジョブの LLM 監視可能性の範囲を取得します。

uip traces UiPath のジョブの LLM の監視 範囲 (コード化されたエージェントやその他の AI が支援するワークフローによって出力される OpenTelemetry スタイルのトレース) を取得します。このツールチップを使用して Orchestrator のジョブの完全なトレースをプルし、シェルまたは CI パイプラインからプロンプト、ツール呼び出し、応答時間を検査できるようにします。

また、このツールは、トレースまたはスパンにアタッチされた LLM のオブザーバビリティのフィードバックを管理するためのfeedbackコマンド グループ (create、 get、 list、 list detailed、 update、 delete) も登録します (uip traces feedbackをご覧ください。

このツールがCLIとどのように連携するかについては、「 ツール(プラグイン)」 を参照してください。

概要

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

すべてのサブコマンドは、 グローバルオプション と 終了コードを尊重します。

uip traces spans get

トレースのすべてのスパンを返します。トレースのアドレスは、ID で直接指定することも、Orchestrator のジョブ キーで間接的にアドレス指定することもできます。ジョブのトレース ID は自動的にツールによって解決されます。

引数

• [trace-id] (オプション) — 32 文字の 16 進数または GUID 形式のトレース ID。

オプション

• --job-key <guid> — Orchestrator のジョブ キー。<trace-id>の代替。ツールはジョブのメタデータを取得し、そのトレース ID を抽出します。
• --folder-path <path> — Orchestrator フォルダーのパス (ジョブの解決時に使用)。
• --folder-key <guid> — Orchestrator のフォルダー キー (ジョブの解決時に使用)。

<trace-id>または--job-keyのうちの1つだけを指定する必要があります。両方を省略すると、 Failure: "Missing required argument"で失敗します。

例

# 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

データシェイプ (--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"
    }
  ]
}

Data 配列には、バックエンドが返す順序で、スパンごとに 1 つのオブジェクトが含まれます。正確なスパンフィールド(属性、イベント、親/子リンク)は、出力ランタイムがキャプチャした内容によって異なりますが、CLIはそれらを正規化しません。

エラー動作

• <trace-id>も--job-keyも提供されていません:Instructions: "Provide either a trace-id argument or --job-key option"のあるFailure、出口1。
• --job-key 、不明またはトレースのないジョブを指します。 Failure: "Error retrieving trace ID for job" 、 Instructionsにバックエンド エラー メッセージが表示されます。
• トレースは存在するがスパンを取得できない: Failure: "Error retrieving spans for trace"

関連

• uip traces feedback — トレースまたはスパンに関する LLM のオブザーバビリティに関するフィードバックを作成、読み取り、管理します。
• ツール (プラグイン) — traces-tool パッケージをインストール、更新、アンインストールします。
• uip login — ジョブの検索とスパン取得の両方に使用されるセッション。
• uip insights — ジョブ実行のメトリックトレース データと直交します。