用途:该技能用于通过命令行对 Cargo 平台执行运行时编排操作,例如触发工作流、批量处理记录、与 AI 智能体对话、查询数据仓库、抓取实时分群数据以及查看模型表结构。
主要能力:支持运行单个记录(run create)、批量处理(batch create)、向智能体发送消息(message create)、对数据仓库执行 SQL(system-of-record client query)、抓取分群记录(segment fetch)、查看模型 DDL(storage model get-ddl),并可列出 play、tool、workflow、template、agent、model、dataset、segment、system of record、connector 等资源。
使用方式:先安装并登录:npm install -g @cargo-ai/cli;cargo-ai login --token <your-api-token>,可用 --workspace-uuid 指定工作区,cargo-ai whoami 验证。所有命令输出 JSON,失败时以非零退出并返回 {"errorMessage":"..."}。未全局安装时可用 npx @cargo-ai/cli 前缀。多数命令需要 UUID,应先用 list 类命令发现资源。run 仅适用于 tool 工作流;batch 的允许数据类型随工作流类型不同:play 为 segment、change、filter、recordIds,tool 为 file、records。异步操作可通过 get 轮询,或对 run create、batch create 加 --wait-until-finished 阻塞等待。
限制:run create 不支持 play 工作流(返回 playNotCompatible);segment fetch 需使用 --model-uuid 而非 --segment-uuid,过滤 JSON 字段为 conjonction;查询前应先获取 DDL,不要猜测表名。更完整说明见 references 下的响应结构、过滤语法、轮询、排错、节点、模板、play、tool、agent、query、segment 等文档。