segmenting-datacloud

关于 segmenting-datacloud

这是 Salesforce Data Cloud “分段”阶段所使用的技能，负责处理受众与洞察相关的工作：包括创建并发布分段、管理计算型洞察、检查分段的数量或成员情况，以及解决受众相关的 SQL 问题。该技能通过 sf data360 segment 与 sf data360 calculated-insight 命令来实现功能，在需要创建分段、发布工作流、统计成员数量或排查分段问题时会被调用。它将相关联的其他工作明确分配到其他模块：DMO、映射以及身份解析任务由 harmonizing-datacloud 处理，下游激活任务由 activating-datacloud 负责，只读 SQL 与搜索索引查询由 retrieving-datacloud 处理，而标准数据模型或会话追踪则由 observing-agentforce 负责。

在执行操作之前，该技能会收集必要的上下文信息，比如目标组织的别名、统一的 DMO 或基础实体名称、用户是要创建、发布、检查还是排查问题、相关资产是分段还是计算型洞察，以及预期的成功指标（成员数量、聚合值或发布状态）。其运行规则规定：将 Data Cloud 分段相关的 SQL 与 CRM 的 SOQL 区分开来，在修改相关资产之前会先运行 orchestrating-datacloud 技能中的共享就绪性分类器（diagnose-org.mjs，并加上 --phase segment 参数），优先使用可复用的 JSON 定义以实现重复创建时的一致性，当使用默认设置创建分段时出现不稳定情况，则使用 --api-version 64.0 参数，发布或执行操作后要通过计数或 SQL 查询进行验证，不能直接假设操作已成功，而在需要可读取的成员详细信息时，优先使用 SQL 连接而非直接查询分段成员。

推荐的流程为：先对就绪状态进行分类，检查现有的分段与计算型洞察，根据 JSON 定义创建新的分段，明确执行发布或运行操作，最后通过计数或 SQL 查询进行验证。其中需要特别注意的潜在问题包括：创建分段可能需要使用 64.0 版本的 API，分段成员查询返回的是不可识别的 ID，即使命令很快返回结果，发布或运行操作也可能触发异步处理，而出现空列表通常意味着该模块可以访问但未配置，并非不可用。该技能会以规定的格式输出分段任务、操作类型、目标组织、相关结果、验证情况以及下一步操作建议。使用该技能需要外部社区提供的 sf data360 CLI 插件，以及已启用 Data Cloud 功能的组织，并且相关共享的定义模板与参考资料可在 orchestrating-datacloud 技能中找到。

常见问题

该技能负责哪些工作，又会将哪些工作委托给其他模块？

它负责处理分段、计算型洞察、发布工作流、成员数量统计以及分段相关的 SQL 问题排查。而 DMO、映射、身份解析工作由 harmonizing-datacloud 处理，激活相关任务由 activating-datacloud 负责，只读 SQL 与搜索索引查询由 retrieving-datacloud 处理，标准数据模型或会话追踪则由 observing-agentforce 负责。

运行该技能需要什么条件？

需要外部社区提供的 sf data360 CLI 插件，以及已启用 Data Cloud 功能的组织。此外，在修改受众相关资产之前，它还会先运行 orchestrating-datacloud 技能中的共享就绪性分类器（diagnose-org.mjs，并加上 --phase segment 参数）。

为什么创建分段需要指定特定的 API 版本？

由于在默认设置下创建分段的功能可能存在不稳定情况，因此该技能建议在创建分段时使用 --api-version 64.0 参数，以此保证功能的稳定性。

如何获取分段中可读取的成员详细信息？

建议使用 SQL 连接来获取信息，而非直接使用 segment members 命令，因为后者返回的是不可识别的 ID。同时要记住，Data Cloud 分段相关的 SQL 与 CRM 的 SOQL 是不同的。

发布或执行操作后如何确认任务是否成功？

不能直接假设操作已成功，而应该通过统计成员数量或执行 SQL 查询来进行验证，因为即使命令很快返回结果，发布和执行操作也可能会触发异步处理流程。