UIP 追踪

uip traces获取 UiPath 作业的LLM 可观察性跨度，即由编码智能体和其他 AI 支持的工作流发出的 OpenTelemetry 样式追踪记录。使用它来拉取 Orchestrator 作业的完整追踪记录，以便您可以在 Shell 或 CI 管道中检查提示、工具调用以及响应时间。

请参阅工具（插件） ，了解此工具如何与 CLI 集成。

大纲

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

所有子命令都遵循全局选项和退出代码。

UIP 追踪跨度获取

返回追踪的所有跨度。您可以直接通过 ID 直接对追踪进行定位，也可以通过 Orchestrator 作业密钥间接对追踪进行定位——该工具会为您解析作业的追踪 ID。

参数

• [trace-id] （可选） — 32 个字符的十六进制文件的追踪 ID 或 GUID 格式。

选项

• --job-key <guid> — Orchestrator 作业密钥。<trace-id>的替代方案；该工具会获取作业的元数据，并提取其追踪 ID。
• -t, --tenant <name> — 租户。默认为uip login选择的租户。
• --folder-path <path> — Orchestrator 文件夹路径（解析作业时使用）。
• --folder-key <guid> — Orchestrator 文件夹密钥（在解析作业时使用）。

必须正好提供<trace-id>或--job-key之一。若同时省略两者，则会失败，并显示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

Data shape (--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数组中的每个跨度包含一个对象，排列顺序为后端返回这些对象的顺序。确切的跨度字段（属性、事件、父/子链接）取决于发送 Runtime 捕获的内容 — CLI 不会将其标准化。

错误行为

• <trace-id>和--job-key均未提供：使用Failure提供Instructions: "Provide either a trace-id argument or --job-key option" ，退出 1。
• --job-key指向未知或无追踪作业： Failure: "Error retrieving trace ID for job"中包含后端错误消息。 Instructions
• 追踪存在，但无法获取跨度： Failure: "Error retrieving spans for trace" 。

相关内容

• 工具（插件） — 安装、更新、卸载traces-tool包。
• uip login — 用于作业查找和跨度获取的会话。
• uip insights — 作业执行指标；与追踪数据垂直。