integration-connectivity-generate

integration-connectivity-generate：Salesforce 集成模式专家

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

此技能适用的任务

在工作涉及以下内容时，使用 integration-connectivity-generate：

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

以下情况请委派给其他技能：

• 配置 OAuth 应用本身 → integration-connectivity-connected-app-configure
• 仅编写 Apex 业务逻辑 → platform-apex-generate 技能
• 部署元数据 → platform-metadata-deploy 技能
• 导入/导出数据 → platform-data-manage 技能

---

首先收集必要的上下文

询问或推断：

• 集成方式：出站调用、入站事件、外部服务、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. 交接部署或实现细节

使用：

• platform-metadata-deploy 技能进行部署
• platform-apex-generate 技能编写更深入的服务／重试代码
• automation-flow-generate 技能编排声明式 HTTP 调用

---

关键规则

• 切勿硬编码凭据
• 不要从触发器发起同步调用
• 明确设置超时行为
• 为瞬时故障规划重试机制
• 出站流量较大时，使用中间件／事件驱动模式
• 在受支持的情况下，新开发优先采用外部凭据架构

常见反模式：

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

---

输出格式

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

1. 所选集成模式
2. 所选认证模型
3. 创建或更新的文件
4. 运行安全措施
5. 部署／测试后续步骤

建议格式：

Integration: <summary>
Pattern: <named credential / external service / event / cdc / callout>
Files: <paths>
Safety: <timeouts, retries, async, logging>
Next step: <deploy, register, test, or implement>

---

跨技能集成

需求	委派给	原因
OAuth 应用设置	integration-connectivity-connected-app-configure	consumer key / 证书 / 应用配置
高级 callout 服务代码	platform-apex-generate 技能	Apex 实现
声明式 HTTP callout / Flow 封装	automation-flow-generate 技能	Flow 编排
部署集成元数据	platform-metadata-deploy 技能	验证和发布
在 Agentforce 中使用集成	agentforce-generate 技能	Agent 操作组合

---

参考索引

从这里开始

• references/named-credentials-guide.md
• references/external-services-guide.md
• references/callout-patterns.md
• references/rest-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
• scripts/README.md — 自动化脚本概述（configure-named-credential.sh、set-api-credential.sh）

资源模板

• assets/named-credentials/ — Named Credential XML 模板（OAuth、JWT、证书、自定义身份验证）
• assets/external-credentials/ — External Credential XML 模板（OAuth、JWT）
• assets/external-services/ — External Service 注册模板和操作指南
• assets/callouts/ — REST 同步、Queueable、重试处理程序和 HTTP 响应处理程序 Apex 模板
• assets/platform-events/ — Platform Event 定义、发布者和订阅者模板
• assets/cdc/ — CDC 处理程序和订阅者触发器模板
• assets/soap/ — SOAP callout 服务模板和 wsdl2apex 指南
• assets/endpoint-security/ — Remote Site Setting 和 CSP Trusted Site XML 模板

自动化钩子

• scripts/suggest_credential_setup.py — 检测到集成文件时自动建议凭据配置步骤
• scripts/validate_integration.py — 在 Agent 响应前验证集成模式

---

输出要求

此技能完成集成任务后，会生成：

1. 凭据元数据 — 一个或多个 assets/named-credentials/ 或 assets/external-credentials/ 中填入组织专属值的文件
2. Callout Apex 类 — 使用 Named Credential 模式的 .cls 文件，并根据上下文选择异步 / 同步模式
3. 事件 / CDC 构件 — Platform Event .object-meta.xml、订阅者触发器或 CDC 配置（选择事件驱动模式时）
4. 端点安全元数据 — Remote Site Setting 和/或 CSP Trusted Site XML 文件
5. 评分报告 — 涵盖 6 个类别（安全性、错误处理、批量化、架构、最佳实践、文档）的 120 分制评分
6. 后续步骤 — 针对生成构件的部署或测试说明

---

评分指南

分数	含义
108+	生产就绪的强健集成设计
90–107	设计良好，但仍需进行一些加固
72–89	可用，但需要架构审查
< 72	不安全 / 不完整，不适合部署

---

交付前检查清单

• 绝不硬编码凭据 — 所有机密信息均存储在 Named Credentials 或 External Credentials 中