后端与接口
在 Salesforce Data Cloud 中创建…
当需要在 Data Cloud 中管理受众细分(segment)和计算洞察(calculated insight),包括创建、发布、查看成员数量或排查受众 SQL 时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在 Salesforce Data Cl特定
解决思路
- 先收集或推断必要上下文:目标 org 别名、统一 DMO 或基础实体名称、用户意图(创建/发布/检查/排查)、资产类型(segment 或 calculated insight)、预期成功指标(成员数、聚合值或发布状态)。
- 将 Data Cloud segment SQL 视为与 CRM SOQL 不同的语言,不要混用。
- 在变更受众资产前运行就绪分类器:`node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json`。
- 优先使用可复用的 JSON 定义来重复创建 segment 和 calculated insight。
- 当 segment 创建行为在新默认版本上不稳定时,使用 `--api-version 64.0`。
- 发布或运行后通过计数或 SQL 验证,而不是假设成功。
- 需要可读的成员详情时,使用 SQL join 而不是 `segment members`。
- 分类就绪状态:`node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase segment --json`。
- 检查当前状态:`sf data360 segment list -o <org> 2>/dev/null` 和 `sf data360 calculated-insight list -o <org> 2>/dev/null`。
- 使用可复用 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`。
- 显式发布或运行:`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`。
- 用计数或 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`。
- 注意 segment 创建可能需要 `--api-version 64.0`。
- 注意 `segment members` 返回不透明 ID;需要人类可读的成员详情时使用 SQL join。
- 注意 segment SQL 不是 SOQL。
- 注意 calculated insight 资产和 segment SQL 有不同的限制。
- 注意发布/运行步骤即使命令快速返回,也可能启动异步工作。
- 注意空的 segment 或 calculated-insight 列表通常意味着模块可达但未配置,而不是不可用。
- 按输出格式汇报:Segment task、Action、Target org、Artifacts、Verification、Next step。
适用边界 · 注意事项
- 当任务仍在构建 DMO、映射或身份解析时,应使用 sf-datacloud-harmonize。
- 当任务是将 segment 下游激活时,应使用 sf-datacloud-act。
- 当任务是编写只读 SQL 或搜索索引查询时,应使用 sf-datacloud-retrieve;当任务是 STDM/会话追踪时,应使用 sf-ai-agentforce-observability。