data-cloud-2025

关键准则

Windows 文件路径要求

强制要求：在 Windows 上始终使用反斜杠表示文件路径

在 Windows 上使用 Edit 或 Write 工具时，文件路径必须使用反斜杠（\），不得使用正斜杠（/）。

示例：

• 错误：D:/repos/project/file.tsx
• 正确：D:\repos\project\file.tsx

适用于：

• Edit 工具的 file_path 参数
• Write 工具的 file_path 参数
• Windows 系统上的所有文件操作

文档编写准则

除非用户明确要求，否则绝不创建新的文档文件。

• 优先级：更新现有的 README.md 文件，而不是创建新文档
• 保持仓库整洁：保持仓库根目录整洁——除非用户另有要求，否则只保留 README.md
• 风格：文档应简洁、直接且专业——避免 AI 生成的语气
• 用户偏好：只有用户明确要求编写文档时，才创建其他 .md 文件

---

Salesforce Data Cloud 集成模式（2025）

什么是 Salesforce Data Cloud？

Salesforce Data Cloud 是一个实时客户数据平台（CDP），可整合来自任何来源的数据，从而全面、可执行地了解每位客户。它为整个 Customer 360 平台提供 AI、自动化和分析能力。

主要功能：

• 数据摄取 — 连接 200 多个数据源（Salesforce、外部系统、数据湖）
• 数据协调 — 将不同的数据映射到统一的数据模型
• 身份解析 — 匹配并合并来自不同数据源的客户记录
• 实时激活 — 根据流式数据触发操作
• 零复制架构 — 无需移动数据，即可在原处查询
• 支持 AI/ML — 为 Einstein、Agentforce 和预测模型提供支持
• 向量数据库（2025 年 3 月正式发布）— 存储并查询非结构化数据，支持语义搜索
• 混合搜索（2025 年试点）— 结合语义搜索和关键词搜索，提高准确性

参考资料索引

详细资料位于 references/。仅加载当前任务所需的内容。

主题	文件	加载时机
数据摄取（CDC 流式处理、批处理 API、Snowflake/Databricks 零复制）	references/ingestion-patterns.md	配置数据源、导入 CSV/SFTP/S3 数据，或设置到数据仓库的零复制连接时
身份解析与身份验证	references/identity-resolution.md	定义匹配规则、协调规则、自定义匹配或 JWT Bearer 身份验证时
实时激活（Flow、Agentforce、Reverse ETL、计算型洞察、细分、Data Cloud SQL）	references/activation-patterns.md	触发下游操作、细分、Agentforce 知识植入或 SQL 查询时
向量数据库与语义/混合搜索	references/vector-database.md	为非结构化数据建立索引、进行语义搜索、使用 Einstein Copilot Search 或进行多语言搜索时

Data Cloud 架构

┌──────────────────────────────────────────────────────────┐
│                    Data Sources                          │
│  Salesforce CRM │ External Apps │ Data Warehouses │ APIs │
└────────┬─────────────────┬──────────────┬───────────┬────┘
         │                 │              │           │
    ┌────▼─────────────────▼──────────────▼───────────▼────┐
    │         Data Cloud Connectors & Ingestion            │
    │  ├─ Real-time Streaming (Change Data Capture)        │
    │  ├─ Batch Import (scheduled/on-demand)               │
    │  └─ Zero Copy (Snowflake, Databricks, BigQuery)      │
    └────────────────────────┬─────────────────────────────┘
                             │
    ┌────────────────────────▼─────────────────────────────┐
    │            Data Model & Harmonization                │
    │  ├─ Map to Common Data Model (DMO objects)           │
    │  ├─ Identity Resolution (match & merge)              │
    │  └─ Data Transformation (calculated insights)        │
    └────────────────────────┬─────────────────────────────┘
                             │
    ┌────────────────────────▼─────────────────────────────┐
    │         Unified Customer Profile (360° View)         │
    │  ├─ Demographics, Transactions, Behavior, Events     │
    │  └─ Real-time Profile API for instant access         │
    └────────────────────────┬─────────────────────────────┘
                             │
    ┌────────────────────────▼─────────────────────────────┐
    │              Activation & Actions                    │
    │  ├─ Salesforce Flow (real-time automation)           │
    │  ├─ Marketing Cloud (segmentation/journeys)          │
    │  ├─ Agentforce (AI agents)                           │
    │  ├─ Einstein AI (predictions/recommendations)        │
    │  └─ External Systems (reverse ETL)                   │
    └──────────────────────────────────────────────────────┘

核心工作流

1. 确定用例 — 是数据摄取、身份解析、细分、激活，还是非结构化数据/AI 搜索？选择相应的参考资料。
2. 映射数据源 — CRM CDC（实时）、外部批处理（S3/SFTP）或数据仓库零复制。
3. 定义 DMO 和匹配规则 — 将源字段映射到数据模型对象；配置身份解析匹配规则和协调规则。
4. 构建洞察/细分 — 使用计算型洞察分析 KPI（LTV、流失风险）；创建用于激活目标的细分。
5. 激活 — 使用 Flow / Platform Events / Agentforce 操作 / Reverse ETL 数据操作。
6. 验证 — 使用 Data Cloud SQL 工作台，检查同步日志，并监控身份解析指标。

最佳实践

性能

• 对大型数据集（>10M 条记录）使用零复制
• 在非工作时间执行批量导入
• 为 Data Cloud 中经常查询的字段建立索引
• 将实时触发器限制在关键事件
• 尽可能缓存统一档案

安全性

• 字段级安全性适用于来自 Salesforce 的 Data Cloud 查询
• 对非生产环境中的 PII 进行数据脱敏
• 静态加密和传输加密（TLS 1.2+）
• 对所有数据访问进行审计日志记录
• 为 Data Cloud 用户实施基于角色的访问控制（RBAC）

数据质量

• 在数据摄取前进行数据验证
• 在数据源和 Data Cloud 中设置去重规则
• 数据沿袭跟踪（了解每个字段的来源）
• 为统一档案提供质量评分
• 定期进行数据审计和清理

资源

• Data Cloud 文档： https://developer.salesforce.com/docs/data/data-cloud-int/guide
• 零拷贝合作伙伴网络： https://www.salesforce.com/data/zero-copy/
• Data Cloud 定价： 属于 Customer 360 平台的一部分，按使用量计费
• Trailhead：“Data Cloud Basics”和“Data Cloud for Developers”