sf-integration

sf-integration：Salesforce 集成模式专家

当用户需要集成架构和运行时管道时使用此技能：命名凭据、外部凭据、外部服务、REST/SOAP 调用模式、平台事件、CDC 和事件驱动集成设计。

此技能负责的任务

当工作涉及以下内容时，使用 sf-integration：

• .namedCredential-meta.xml 或外部凭据元数据
• 出站 REST/SOAP 调用
• 从 OpenAPI 规范注册外部服务
• 平台事件、CDC 和事件驱动架构
• 选择同步与异步集成模式

当用户处于以下情况时，请委托给其他技能：

• 配置 OAuth 应用本身 → sf-connected-apps
• 编写仅 Apex 业务逻辑 → sf-apex
• 部署元数据 → sf-deploy
• 导入/导出数据 → sf-data

---

首先需要收集的必需上下文

询问或推断：

• 集成风格：出站调用、入站事件、外部服务、CDC、平台事件
• 认证方法
• 同步与异步需求
• 系统端点/规范详细信息
• 速率限制、重试预期和故障容忍度
• 这是全新设计还是现有集成的修复

---

推荐工作流程

1. 选择集成模式

需求	默认模式
经过身份验证的出站 API 调用	命名凭据 / 外部凭据 + Apex 或 Flow
规范驱动的 API 客户端	外部服务
触发器发起的调用	异步调用模式
解耦事件发布	平台事件
变更流消费	CDC

2. 选择认证模型

优先选择安全的运行时管理认证：

• 命名凭据 / 外部凭据
• 通过正确的凭据模型使用 OAuth 或 JWT
• 代码中不硬编码密钥

3. 从正确的模板生成

使用提供的资产，位于：

• assets/named-credentials/
• assets/external-credentials/
• assets/external-services/
• assets/callouts/
• assets/platform-events/
• assets/cdc/
• assets/soap/

4. 验证操作安全性

检查：

• 超时和重试处理
• 触发器发起工作的异步策略
• 日志记录/可观测性
• 事件保留和订阅者影响

5. 移交部署或实施细节

使用：

• sf-deploy 进行部署
• sf-apex 进行更深入的服务/重试代码
• sf-flow 进行声明式 HTTP 调用编排

---

高信号规则

• 切勿硬编码凭据
• 不要从触发器进行同步调用
• 明确定义超时行为
• 为瞬时故障规划重试
• 当出站量高时，使用中间件/事件驱动模式
• 在支持的情况下，新开发优先使用外部凭据架构

常见反模式：

• 同步触发器调用
• 没有重试或死信策略
• 没有请求/响应日志记录
• 将认证设置职责与运行时集成设计混为一谈

---

输出格式

完成后，按以下顺序报告：

1. 选择的集成模式
2. 选择的认证模型
3. 创建或更新的文件
4. 操作保障措施
5. 部署/测试下一步

建议格式：

集成：<摘要>
模式：<命名凭据 / 外部服务 / 事件 / CDC / 调用>
文件：<路径>
安全性：<超时、重试、异步、日志记录>
下一步：<部署、注册、测试或实施>

---

跨技能集成

需求	委托给	原因
OAuth 应用设置	sf-connected-apps	消费者密钥/证书/应用配置
高级调用服务代码	sf-apex	Apex 实现
声明式 HTTP 调用 / Flow 包装器	sf-flow	Flow 编排
部署集成元数据	sf-deploy	验证和发布
从 Agentforce 使用集成	sf-ai-agentscript	代理操作组合

---

参考地图

从这里开始

• references/named-credentials-guide.md
• references/external-services-guide.md
• references/callout-patterns.md
• references/security-best-practices.md

事件驱动/平台模式

• references/event-patterns.md
• references/platform-events-guide.md
• references/cdc-guide.md
• references/event-driven-architecture-guide.md
• references/messaging-api-v2.md

CLI / 自动化 / 评分

• references/cli-reference.md
• references/named-credentials-automation.md
• references/scoring-rubric.md
• assets/

---

评分指南

分数	含义
108+	强大的生产就绪集成设计
90–107	良好设计，但仍有加固空间
72–89	可行，但需要架构审查
< 72	不安全/不完整，无法部署