salesforce

salesforce 外掛程式將 Salesforce CLI 與 Claude Code 整合，提供組織驗證及通用 CLI 代理程式，可執行任何 sf 命令，包括 SOQL 查詢。它支援使用 JWT、存取令牌及 SFDX URL 驗證流程的無頭容器環境。以下使用指南示範如何透過 CLI 代理程式以自然語言查詢帳戶、商機、案例及聯絡人。

v1.0.0 Development

安裝

/plugin install salesforce@f5-sales-demo-marketplace

先決條件

Salesforce CLI (@salesforce/cli)
Salesforce 組織，需具備 API 存取權限
具備查詢物件（案例、商機、帳戶、聯絡人）權限的使用者帳戶

在您的工作站上安裝 Salesforce CLI：

brew install sf

驗證安裝：

sf --version

您應會看到類似 @salesforce/cli/2.x.x 的輸出。

驗證設定

步驟 1：找到您的 Salesforce 網域

請查看瀏覽器中的 Salesforce 網址。若您透過 https://acme.lightning.force.com 存取 Salesforce，則登入網域為 https://acme.my.salesforce.com。

步驟 2：透過瀏覽器進行驗證

sf org login web --alias my-org --set-default --instance-url https://YOUR-DOMAIN.my.salesforce.com

請將 YOUR-DOMAIN 替換為步驟 1 中取得的公司網域。瀏覽器會開啟 — 完成 SSO 或登入流程並授權應用程式。您應會看到：

Successfully authorized your-email@company.com with org ID 00DXXXXXXXXXXXXXXX

步驟 3：驗證連線

sf org display --target-org my-org

確認輸出顯示 Connected Status: Connected，以及您的使用者名稱和執行個體 URL。

步驟 4：容器的可攜式驗證（選用）

若需要在無頭環境（CI/CD、容器、遠端工作階段）中進行驗證，請從工作站匯出 SFDX 驗證 URL：

sf org display --verbose --target-org my-org

複製 Sfdx Auth Url 值（以 force:// 開頭）。在容器中執行：

export SFDX_AUTH_URL="force://PlatformCLI::YOUR_AUTH_TOKEN@your-domain.my.salesforce.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

驗證方法參考

方法	最適用場景	需求
網頁登入	具備瀏覽器的工作站	瀏覽器 + SSO
SFDX URL	容器、CI/CD、可攜式驗證	來自已驗證工作階段的驗證 URL
JWT Bearer	自動化管道	已連線應用程式 + 私密金鑰 + 消費者金鑰
存取令牌	環境變數驗證	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

注意： 裝置流程（sf org login device）自 2025 年 8 月起已封鎖，不再受支援。

環境變數

變數	用途
`SF_ACCESS_TOKEN`	存取令牌驗證的 Bearer 令牌
`SFDX_AUTH_URL`	SFDX URL 驗證的強制驗證 URL
`SF_ORG_INSTANCE_URL`	組織執行個體 URL
`SF_JWT_KEY_FILE`	JWT 私密金鑰的路徑
`SF_CLIENT_ID`	已連線應用程式的消費者金鑰
`SF_USERNAME`	JWT 使用的 Salesforce 使用者名稱

命令

/salesforce:sf-status

檢查您的 Salesforce 組織連線狀態、CLI 版本及已驗證的組織。

/salesforce:sf-status

預期結果： 顯示 sf CLI 版本、已驗證組織別名、使用者名稱、執行個體 URL、連線狀態及 API 版本的表格。

/salesforce:sf-login

驗證至 Salesforce 組織。可選擇性提供別名。

/salesforce:sf-login
/salesforce:sf-login my-org

預期結果： 若具有該別名的組織已完成驗證，則回報連線詳細資訊。若未驗證，則檢查可用憑證（環境變數），並使用第一個完全滿足條件的方法進行驗證。

技能

salesforce-index

頂層意圖路由器。當您在自然語言中提及 Salesforce、組織管理或資料查詢時自動啟動。

您說的內容	路由至
「登入 salesforce」、「驗證組織」	`salesforce-auth` 技能
「檢查組織狀態」、「列出組織」	`cli-operator` 代理程式
「顯示我的商機」、「查詢案例」	`cli-operator` 代理程式（SOQL 查詢）
「產生 Apex 類別」、「建立 Flow」	afv-library 開發技能

salesforce-auth

容器適配驗證技能。支援四種驗證方法並自動偵測可用憑證。優先順序為：存取令牌、JWT、SFDX URL，最後為網頁登入。

代理程式

cli-operator

自主式 Salesforce CLI 代理程式，具備安全防護機制可執行 sf 命令。所有 Salesforce 操作皆委派給此代理程式，以保持主要工作階段的精簡。

安全規則：

預設為唯讀 — 寫入操作需要明確核准
在未進行預覽和確認步驟前絕不部署
絕不在輸出中顯示存取令牌、驗證 URL 或憑證
對所有使用者提供的值進行清理（拒絕 shell 特殊字元）
使用 --json 輸出以取得結構化、可解析的結果

回應格式：

## Result: [SUCCESS | FAILURE | PARTIAL]
### Command Executed
### Output Summary
### Issues

使用指南：帳戶管理

這些提示適用於任何 Salesforce 組織。請將預留位置值替換為您自己的資訊。每個提示產生的結果特定於您的角色、帳戶及轄區。

入門

驗證後，確認一切正常運作：

/salesforce:sf-status

然後嘗試簡單的自然語言查詢：

list my authenticated salesforce orgs

預期結果： 顯示所有已連線組織的表格，包含別名、使用者名稱、執行個體 URL 及連線狀態。

找到您的帳戶

探索您被指派的帳戶：

what salesforce accounts am I on the account team for? My email is your-email@company.com

預期結果： 依帳戶擁有者分組的帳戶清單，顯示您在每個帳戶上的團隊成員角色。若大多數角色顯示為空白，這是常見的資料品質問題 — 帳戶團隊成員關係存在，但角色未填入。

與同事交叉比對覆蓋範圍

與隊友比較帳戶覆蓋範圍以找出缺口：

In salesforce, find all accounts where Colleague Name is on the account team. Then for each of those accounts, check if your-email@company.com is also on the account team. Show me two lists: accounts where we are BOTH tagged, and accounts where only my colleague is tagged but I am missing.

預期結果： 顯示重疊數量和缺口數量的摘要表格，接著是兩份清單。若您最近變更了角色，可能會發現零重疊 — 這揭示了您需要被新增到哪些帳戶。

轄區管道概覽

查看您帳戶中所有未結商機：

show me all open salesforce opportunities on Colleague Name's account team accounts, sorted by close date, include the stage, amount, and probability

預期結果： 包含商機總數、原始管道及加權管道的摘要。接著是階段分布表格及按金額排列的主要商機清單。輸出會標示資料品質問題，例如逾期的結束日期或空白金額。

商機深入分析

取得特定交易的完整資訊：

show me a detailed view of the OPPORTUNITY NAME opportunity in salesforce - include the opportunity team members, any activities or tasks, and the account contacts

預期結果： 商機概覽（階段、金額、結束日期、機率、預測類別、擁有者）、具備角色的商機團隊成員、標記的聯絡人、近期任務和事件，以及顯示交易金額和結束日期隨時間變化的欄位變更記錄。

轄區支援案例

檢查您帳戶中未結的支援案例：

show me all open salesforce cases across Colleague Name's account team accounts, grouped by account, sorted by most recent first

預期結果： 包含優先順序和狀態細分的未結案例數量，接著是依帳戶分組的案例詳細資訊。無活動數月或數年的舊案例會被標示為品質改善候選項目。

季度管道預測

取得管道的預測就緒視圖：

for Colleague Name's accounts, show me a quarterly pipeline summary - group the open opportunities by close date quarter with count, total amount, and weighted amount for each quarter

預期結果： 每季一列的表格，顯示商機數量、管道總額及加權管道。包含每季的階段組合細分及最佳加權交易的重點顯示。逾期商機會單獨分組。

完整帳戶概覽

深入了解特定客戶：

give me a full account overview for ACCOUNT NAME in salesforce including contacts, open opportunities, and recent cases

預期結果： 公司概況（產業、營收、員工人數、地點）、附有職稱和電子郵件的主要聯絡人、具備階段和金額的未結商機，以及附有狀態的近期支援案例。

案例查詢

依案例編號查詢特定支援案例：

look up salesforce case CASE-NUMBER and show me the case details, the customer account, and who owns it

預期結果： 案例主旨、狀態、優先順序、說明、客戶帳戶概況，以及案例擁有者與聯絡資訊。

使用指南：資料查詢

進階使用者可以使用自然語言要求特定的 SOQL 樣式查詢。外掛程式會將您的請求轉換為適當的 SOQL 並執行。

特定欄位

query salesforce for all Contacts at ACCOUNT NAME - show Name, Title, Email, Phone, and Department

日期篩選

show me all salesforce opportunities that closed won in the last 90 days on ACCOUNT NAME

彙總

count all open salesforce cases grouped by priority and status across my accounts

自訂物件

query the CUSTOM_OBJECT__c object in salesforce for records where Status__c = 'Active'

開發技能

來自 forcedotcom/afv-library 的 30 個 Salesforce 開發技能會針對 Apex、Flow、LWC、SOQL、中繼資料、Agentforce 及部署任務自動啟動。請單獨安裝：

npx skills add forcedotcom/afv-library

主題	技能
Apex 類別與服務	`generating-apex`
Apex 測試	`generating-apex-test`
Flow	`generating-flow`
LWC 與 UI 套件組合	`building-ui-bundle-app`
自訂物件	`generating-custom-object`
自訂欄位	`generating-custom-field`
驗證規則	`generating-validation-rule`
權限集	`generating-permission-set`
FlexiPage	`generating-flexipage`
Agentforce 代理程式	`developing-agentforce`
Agentforce 測試	`testing-agentforce`
部署	`deploying-ui-bundle`
SLDS2 移轉	`uplifting-components-to-slds2`
觸發器重構	`trigger-refactor-pipeline`