SuperAPI AI 工具集

sf-datacloud-act

数据与分析

查看项目

更新于 10-13 20:08

技能介绍

sf-datacloud-act 是 jaganpro/sf-skills 中面向 Salesforce Data Cloud Act 阶段的技能,专注下游交付工作:激活、激活目标、数据动作,以及把 Data Cloud 输出推送到其它系统。

用途 当工作涉及 sf data360 activation *、sf data360 activation-target *、sf data360 data-action *、sf data360 data-action-target *,或需要验证下游交付配置时,使用本技能。若用户仍在构建受众或洞察,应交给 sf-datacloud-segment;若在探索查询/搜索或搜索索引,应交给 sf-datacloud-retrieve;若在设置基础连接或数据摄取,应交给 sf-datacloud-connect、sf-datacloud-prepare。

使用前需收集的上下文 目标组织别名;目标平台或下游系统;受众是否已存在并发布;用户需要创建、检查、更新还是删除;任务是面向激活还是面向数据动作。

核心操作规则 在创建下游交付资产前,先验证上游受众或洞察是否健康。在变更激活资产前,运行共享的就绪度分类器:node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json。在变更激活设置前,先检查可用平台与目标。尽可能保持目标定义确定且可复用。将下游凭据与平台限制视为独立的验证事项。当目标状态不清晰时,优先使用只读检查。

推荐工作流

  1. 对 Act 工作分类就绪度:node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase act --json
  2. 先检查目标:sf data360 activation platforms -o <org> 2>/dev/null;sf data360 activation-target list -o <org> 2>/dev/null;sf data360 data-action-target list -o <org> 2>/dev/null
  3. 先创建目标再创建激活:sf data360 activation-target create -o <org> -f target.json 2>/dev/null;sf data360 data-action-target create -o <org> -f target.json 2>/dev/null
  4. 创建激活或数据动作:sf data360 activation create -o <org> -f activation.json 2>/dev/null;sf data360 data-action create -o <org> -f action.json 2>/dev/null
  5. 验证下游就绪度:sf data360 activation list -o <org> 2>/dev/null;sf data360 activation data -o <org> --name <activation> 2>/dev/null

需要注意的要点 激活设计依赖已发布且健康的上游受众。目标配置通常先于激活创建。下游凭据与平台限制可能不只在 Data Cloud CLI 中。当目标设置不清晰时,只读检查是最安全的做法。若出现 CdpActivationTarget 或 CdpActivationExternalPlatform,表示激活面受当前组织/用户限制;应引导用户处理激活设置、权限和目标配置,而不是盲目重试。

输出格式 Act 任务:<activation / activation-target / data-action / data-action-target>;目标:<平台或目标>;目标组织:<别名>;产物:<定义文件/命令>;验证:<已列出/已创建/受阻>;下一步:<目标验证或下游测试>。

参考 README.md;../sf-datacloud/assets/definitions/activation-target.template.json;../sf-datacloud/assets/definitions/activation.template.json;../sf-datacloud/assets/definitions/data-action-target.template.json;../sf-datacloud/assets/definitions/data-action.template.json;../sf-datacloud/UPSTREAM.md;../sf-datacloud/references/plugin-setup.md;../sf-datacloud/references/feature-readiness.md。

限制 关于收费、价格、平台支持范围与具体使用效果,资料暂未提供。