用途:面向 Cargo 平台的测量与导出技能,回答“发生了什么”和“把数据给我”,包括运行指标、成功/错误计数、下载与导出。涉及原因分析(为什么失败、为什么输出为空或昂贵)时应改用 cargo-diagnostics。
主要能力:workflow 级聚合指标与运行计数;对整个工作区运行 orchestration query execute 执行只读 SQL 做跨 workflow 分析、按节点失败统计与时间序列;run download 导出每次运行一行、每节点一列的 gzip CSV;run download-outputs 按运行导出输入与所选节点输出(CSV/JSON);download batch 结果;segmentation segment download 导出分段数据。
使用方式:需先安装并登录,npm install -g @cargo-ai/cli;cargo-ai login --email you@company.com;cargo-ai whoami 确认工作区。多数命令需 UUID,先用 orchestration play list、workflow list、ai agent list、storage model list 等发现资源。命令输出 JSON,创建运行或批次的命令为异步,可加 --wait-until-finished 或轮询。示例:cargo-ai orchestration run get-metrics --workflow-uuid <uuid>;cargo-ai orchestration run download-outputs --workflow-uuid <uuid> --format json --limit 20;cargo-ai segmentation segment download --model-uuid <uuid> --filter '{"conjonction":"and","groups":[]}'。分段导出需 --model-uuid 而非 --segment-uuid。
限制:orchestration query 只读,30 秒执行时间、10000 结果行、1000 万扫描行上限,需用时间谓词收窄。run download 的节点列只是标题摘要,不是节点输出。完整 runContext 无法一次批量获取,只能逐次用 orchestration run get。run download-outputs 可用 --limit/--offset 分页。批状态 success 仍可能含个别运行失败,需检查 failedRunsCount 并单独统计与下载 error 运行。筛选 JSON 字段拼写为 conjonction。费用、订阅与用量指标请用 cargo-billing 技能;缺失信息暂未提供。