mcpField
D
data360-segment

data360-segment

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

关于 data360-segment

data360-segment 是面向 Salesforce Data Cloud 受众工作的技能，涵盖细分和计算洞察的创建与验证。它也用于发布流程、成员计数和细分 SQL 故障排查。

主要功能

  1. 01创建和检查细分
  2. 02发布细分并查看成员数
  3. 03创建并运行计算洞察
  4. 04排查细分 SQL 问题
  5. 05用计数或 SQL 验证结果

适用场景

  1. 01创建并发布受众细分
  2. 02检查细分包含的成员数
  3. 03运行并验证计算洞察
  4. 04诊断细分 SQL 问题

安装

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill data360-segment

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

附带文件README.md

详细介绍

data360-segment：Data Cloud 细分阶段

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

此技能负责的任务

以下工作请使用 data360-segment：

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

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

首先收集必要的上下文

请询问或推断：

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

核心操作规则

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

推荐工作流

1. 评估细分工作的就绪状态
node ../data360-orchestrate/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