SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场sf-datacloud-segment

sf-datacloud-segment

数据与分析

查看项目

更新于 10-13 21:08

技能介绍

用途

sf-datacloud-segment 用于 Salesforce Data Cloud（数据云）中的受众与洞察阶段工作。当用户需要处理细分（segment）、计算洞察（calculated insight）、发布流程、成员计数，或排查 Data Cloud 细分 SQL 时使用本技能。

本技能负责的任务范围包括：

  • sf data360 segment *
  • sf data360 calculated-insight *
  • 细分发布工作流
  • 成员计数与细分排查
  • 计算洞察的执行与验证

当用户仍在构建 DMO、映射或身份解析时，应改用 sf-datacloud-harmonize；当需要对细分进行下游激活时，应改用 sf-datacloud-act；当需要编写只读 SQL 或搜索索引查询时，应改用 sf-datacloud-retrieve。

需要先收集的上下文

需要询问或推断以下信息：

  • 目标 org 别名
  • 统一 DMO 或基础实体名称
  • 用户想要的是创建、发布、检查还是排查
  • 资产是细分还是计算洞察
  • 期望的成功指标：成员计数、聚合值或发布状态

核心操作规则

  • 将 Data Cloud 细分 SQL 视为与 CRM SOQL 不同。
  • 在变更受众资产前，运行共享的就绪状态分类器：node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json。
  • 优先使用可复用的 JSON 定义，以便重复创建细分和 CI。
  • 当细分创建行为在较新的默认版本上不稳定时，使用 --api-version 64.0。
  • 在发布/运行步骤之后，用计数或 SQL 验证，而不是假设成功。
  • 当需要可读的成员详情时，使用 SQL join 而不是 segment members。

推荐工作流

  1. 分类细分工作的就绪状态：
node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json
  1. 检查当前状态：
sf data360 segment list -o <org> 2>/dev/null
sf data360 calculated-insight list -o <org> 2>/dev/null
  1. 使用可复用 JSON 定义创建：
sf data360 segment create -o <org> -f segment.json --api-version 64.0 2>/dev/null
sf data360 calculated-insight create -o <org> -f ci.json 2>/dev/null
  1. 显式发布或运行：
sf data360 segment publish -o <org> --name My_Segment 2>/dev/null
sf data360 calculated-insight run -o <org> --name Lifetime_Value 2>/dev/null
  1. 用计数或 SQL 验证：
sf data360 segment count -o <org> --name My_Segment 2>/dev/null
sf data360 query sql -o <org> --sql 'SELECT COUNT(*) FROM "UnifiedssotIndividualMain__dlm"' 2>/dev/null

需要特别注意的常见陷阱

  • 创建细分可能需要 --api-version 64.0。
  • segment members 返回的是不透明 ID；当需要人类可读的成员详情时，应使用 SQL join。
  • 细分 SQL 不是 SOQL。
  • 计算洞察资产和细分 SQL 有不同的限制。
  • 即使命令很快返回，发布/运行步骤也可能触发异步工作。
  • 细分或计算洞察列表为空通常意味着模块可达但尚未配置，而不是不可用。

输出格式

Segment task: <segment / calculated-insight>
Action: <create / publish / inspect / troubleshoot>
Target org: <alias>
Artifacts: <definition files / commands>
Verification: <member count / query result / publish state>
Next step: <act / retrieve / follow-up>

参考

  • README.md
  • ../sf-datacloud/assets/definitions/calculated-insight.template.json
  • ../sf-datacloud/assets/definitions/segment.template.json
  • ../sf-datacloud/references/feature-readiness.md
  • ../sf-datacloud/UPSTREAM.md