mcpField
S
segmenting-datacloud

segmenting-datacloud

github.com/forcedotcom数据与数据库1.1k2.5k 次安装1 天前更新
代码仓库

关于 segmenting-datacloud

此技能面向 Salesforce Data Cloud 的受众与洞察任务，协助创建、发布和检查细分及计算洞察，并通过计数或 SQL 验证结果。

主要功能

  1. 01创建并检查细分和计算洞察
  2. 02发布细分并运行计算洞察
  3. 03通过计数或 SQL 验证结果
  4. 04排查细分 SQL 与成员计数

适用场景

  1. 01创建并发布目标受众细分
  2. 02运行计算洞察并检查聚合结果
  3. 03调查空细分或成员计数问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/forcedotcom/sf-skills --skill segmenting-datacloud

安装后在 Claude Code 中输入/segmenting-datacloud确认已加载。

附带文件CREDITS.mdREADME.md

详细介绍

segmenting-datacloud：Data Cloud 细分阶段

当用户需要开展受众与洞察工作时使用此技能：细分、计算洞察、发布工作流、成员数量，或排查 Data Cloud 细分 SQL 问题。

此技能适用的任务

在工作涉及以下内容时使用 segmenting-datacloud：

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

在以下情况下委派给其他技能：

首先需要收集的上下文

询问或推断：

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

核心操作规则

  • 将 Data Cloud 细分 SQL 视为与 CRM SOQL 不同的语言。
  • 修改受众资产前，先运行 orchestrating-datacloud 技能中的共享就绪情况分类器：node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json。
  • 创建可重复使用的细分和 CI 时，优先使用可复用的 JSON 定义。
  • 如果较新的默认版本导致细分创建行为不稳定，请使用 --api-version 64.0。
  • 发布或运行后，通过计数或 SQL 进行验证，不要想当然地认为操作成功。
  • 需要可读的成员详情时，使用 SQL 联接，而不是 segment members。

推荐工作流

1. 对细分工作的就绪情况进行分类
node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json
2. 检查当前状态
sf data360 segment list -o <org> 2>/dev/null
sf data360 calculated-insight list -o <org> 2>/dev/null
3. 使用可复用的 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
4. 显式发布或运行
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
5. 使用计数或 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 联接。
  • 细分 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>

参考资料

评论

支持 Markdown