用途:在 Cargo 工作区中定义与管理“分段”——即某个模型上命名保存的过滤器,用来回答“我要处理哪些记录”。批量运行、播放触发、CSV 导出和变更流都以分段(或分段形状的过滤器)为输入。
主要能力:过滤条件以 JSON 描述(键为 conjonction、groups、conditions),支持字符串、数值、日期、布尔、数组、关系等类型与运算符。分段保存后带有 uuid、modelUuid、slug、实时 recordsCount 与历史记录;每次同步会产生“变更”(change),统计新增、更新、移除、未变的记录数,这是“进入受众即通知”的基础。tracking columns 定义哪些列变化算作更新记录。
使用方式:先安装并登录 CLI:npm install -g @cargo-ai/cli;cargo-ai login --email you@company.com;cargo-ai whoami。创建前先列举资源:cargo-ai segmentation segment list、cargo-ai storage model list、cargo-ai storage column list --model-uuid <uuid>。创建命令:cargo-ai segmentation segment create --name "<name>" --model-uuid <uuid> --filter '<json>',可加 --column-slugs 与 --tracking-column-slugs。查询用 segment get/fetch/download,变更用 change list --segment-uuid 与 change fetch --uuid <change-uuid> --kinds added。
适用场景:一次性提问可用内联过滤器的 segment fetch 并 --limit 1 先估算受众规模,满意后再保存为正式分段;面向持续运行、排程或跟踪的受众应创建真实分段,因为只有已保存分段才会产生变更。
限制与注意:conjonction 是故意保留的法语拼写,写成 conjunction 不会报错但会静默匹配为空;segment download 需传 --model-uuid 而非 --segment-uuid;change fetch 需传变更 uuid 与 --kinds,传分段 uuid 会返回 400;change list 需 --segment-uuid;--limit 限制的是成员数量而非分页大小(分页用 --fetching-limit)。一个分段只属于一个模型,跨模型受众需用关系加联接列过滤。fromPlay: true 的 GENERATED_PLAY_SEGMENT 由播放拥有,不要手工编辑或删除。大分段不应分页读入对话,先 --limit 3 看形状再下载。其余前提、命令行为与错误处理以官方文档与 skill 包为准。