sf-integration

sf-integration：Salesforce 整合模式專家

當使用者需要整合架構與執行期基礎設施時，請使用此技能：具名憑證、外部憑證、外部服務、REST/SOAP 呼叫模式、平台事件、CDC，以及事件驅動的整合設計。

此技能負責的時機

當工作涉及以下內容時，請使用 sf-integration：

• .namedCredential-meta.xml 或外部憑證中繼資料
• 對外的 REST/SOAP 呼叫
• 從 OpenAPI 規格註冊外部服務
• 平台事件、CDC 與事件驅動架構
• 選擇同步 vs 非同步整合模式

當使用者正在進行以下操作時，請委派給其他技能：

• 設定 OAuth 應用程式本身 → sf-connected-apps
• 撰寫僅 Apex 的商業邏輯 → sf-apex
• 部署中繼資料 → sf-deploy
• 匯入/匯出資料 → sf-data

---

需先收集的必要內容

請詢問或推斷：

• 整合類型：對外呼叫、對內事件、外部服務、CDC、平台事件
• 驗證方法
• 同步 vs 非同步需求
• 系統端點 / 規格細節
• 速率限制、重試預期與失敗容忍度
• 這是全新設計還是既有整合的修復

---

建議工作流程

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	不適合部署 / 不完整