用途:Cargo CLI 的编排模块(Runtime operations),用于在 Cargo 平台上实际运行操作或预览将要运行的内容,涵盖单动作执行、批量动作、工作流链路、分段自动化与智能体对话。
主要能力:通过 cargo-ai orchestration action list <keywords> 免费搜索连接器、原生动作、工作区工具与智能体;用 action execute 执行单动作、action execute-batch 跨多记录批量执行;用 run create --nodes 或 run create --workflow-uuid 运行工作流,batch create 批量触发;play 由分段数据变化驱动,tool 为按需工作流(手动、API 或 cron 触发);ai message create 发起智能体对话;query execute 在 ClickHouse 上查询 runs/batches/spans/records。node execute 仅用于调试工作流中单个节点,需同时提供 --workflow-uuid、--release-uuid、--node、--computed-config、--context 五项参数。node diagram 可绘制节点图。
使用方式:先 npm install -g @cargo-ai/cli,再 cargo-ai login --email you@company.com(也支持 --oauth 或 --token),用 cargo-ai whoami 确认工作区。多数命令需先发现 UUID:action list、play list、tool list、workflow list、template list、agent list、model list、segment list、connector list。异步操作可用 --wait-until-finished 或轮询 run get、batch get、message get。
限制与计费:每个节点执行耗 0.01 credits,即每 100 次 1 credit,成本为(提供方成本×记录数)+(节点数×记录数÷100);批量执行按记录计费,建议先跑 10–20 条样本并报告成本与成功率、经批准后再全量。放错位置的输入会被静默丢弃。动作输出模式可通过 action get-output-schema 免费解析;无输出模式时返回 404 错误,需回退检查真实运行的 runContext。完整 CLI 版本要求与令牌范围未在本资料展开。