salesforce

ปลั๊กอิน salesforce ผสานรวม Salesforce CLI กับ Claude Code โดยมีการยืนยันตัวตนองค์กรและตัวแทน CLI อเนกประสงค์ที่สามารถ รันคำสั่ง sf ใดๆ ก็ได้รวมถึงการสืบค้น SOQL รองรับสภาพแวดล้อมคอนเทนเนอร์แบบ headless ด้วยการยืนยันตัวตนแบบ JWT, access-token และ SFDX URL คู่มือการใช้งานด้านล่างนี้แสดงวิธีใช้ภาษาธรรมชาติเพื่อสืบค้นบัญชี โอกาส เคส และผู้ติดต่อ ผ่านตัวแทน CLI

v1.0.0 Development

การติดตั้ง

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

ข้อกำหนดเบื้องต้น

Salesforce CLI (@salesforce/cli)
Salesforce org ที่มีสิทธิ์เข้าถึง API
บัญชีผู้ใช้ที่มีสิทธิ์สืบค้นออบเจ็กต์ (Cases, Opportunities, Accounts, Contacts)

ติดตั้ง Salesforce CLI บนเวิร์กสเตชันของคุณ:

brew install sf

ตรวจสอบการติดตั้ง:

sf --version

คุณควรเห็นผลลัพธ์เช่น @salesforce/cli/2.x.x

การตั้งค่าการยืนยันตัวตน

ขั้นตอนที่ 1: ค้นหาโดเมน Salesforce ของคุณ

ดู URL ของ Salesforce ในเบราว์เซอร์ หากคุณเข้าถึง Salesforce ที่ https://acme.lightning.force.com โดเมนสำหรับล็อกอินของคุณคือ 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 พร้อมชื่อผู้ใช้ และ instance URL ของคุณ

ขั้นตอนที่ 4: การยืนยันตัวตนแบบพกพาสำหรับคอนเทนเนอร์ (ไม่บังคับ)

หากคุณต้องการยืนยันตัวตนในสภาพแวดล้อมแบบ headless (CI/CD, คอนเทนเนอร์, เซสชันระยะไกล) ให้ส่งออก SFDX auth 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

ข้อมูลอ้างอิงวิธีการยืนยันตัวตน

วิธีการ	เหมาะสำหรับ	ต้องการ
Web Login	เวิร์กสเตชันที่มีเบราว์เซอร์	เบราว์เซอร์ + SSO
SFDX URL	คอนเทนเนอร์, CI/CD, การยืนยันตัวตนแบบพกพา	Auth URL จากเซสชันที่ยืนยันตัวตนแล้ว
JWT Bearer	ไปป์ไลน์อัตโนมัติ	Connected App + private key + consumer key
Access Token	การยืนยันตัวตนด้วยตัวแปรสภาพแวดล้อม	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

หมายเหตุ: Device flow (sf org login device) ถูกบล็อกตั้งแต่เดือนสิงหาคม 2025 และไม่รองรับการใช้งาน

ตัวแปรสภาพแวดล้อม

ตัวแปร	วัตถุประสงค์
`SF_ACCESS_TOKEN`	Bearer token สำหรับการยืนยันตัวตนแบบ access-token
`SFDX_AUTH_URL`	Force auth URL สำหรับการยืนยันตัวตนแบบ SFDX URL
`SF_ORG_INSTANCE_URL`	Org instance URL
`SF_JWT_KEY_FILE`	เส้นทางไปยัง JWT private key
`SF_CLIENT_ID`	Connected App consumer key
`SF_USERNAME`	ชื่อผู้ใช้ Salesforce สำหรับ JWT

คำสั่ง

/salesforce:sf-status

ตรวจสอบสถานะการเชื่อมต่อ Salesforce org เวอร์ชัน CLI และ org ที่ยืนยันตัวตนแล้ว

/salesforce:sf-status

สิ่งที่คาดว่าจะได้รับ: ตารางแสดงเวอร์ชัน sf CLI ของคุณ, alias ของ org ที่ยืนยันตัวตน, ชื่อผู้ใช้, instance URL, สถานะการเชื่อมต่อ และเวอร์ชัน API

/salesforce:sf-login

ยืนยันตัวตนกับ Salesforce org โดยเลือกระบุ alias ได้

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

สิ่งที่คาดว่าจะได้รับ: หาก org ที่มี alias นั้นยืนยันตัวตนแล้ว จะรายงานรายละเอียดการเชื่อมต่อ หากยังไม่มี จะตรวจสอบข้อมูลรับรองที่มีอยู่ (ตัวแปรสภาพแวดล้อม) และยืนยันตัวตนโดยใช้วิธีแรกที่มีข้อมูลครบถ้วน

ทักษะ

salesforce-index

เราเตอร์ intent ระดับบนสุด เปิดใช้งานโดยอัตโนมัติเมื่อคุณกล่าวถึง Salesforce, การจัดการ org หรือการสืบค้นข้อมูลในภาษาธรรมชาติ

คุณพูดว่า	เส้นทางไปยัง
”login to salesforce”, “authenticate org”	ทักษะ `salesforce-auth`
”check org status”, “list orgs”	ตัวแทน `cli-operator`
”show me opportunities”, “look up case”	ตัวแทน `cli-operator` (SOQL query)
“generate Apex class”, “create Flow”	ทักษะการพัฒนา afv-library

salesforce-auth

ทักษะการยืนยันตัวตนที่ปรับให้เหมาะกับคอนเทนเนอร์ รองรับสี่วิธีการยืนยันตัวตนและ ตรวจจับข้อมูลรับรองที่มีอยู่โดยอัตโนมัติ ลำดับความสำคัญ: access-token, จากนั้น JWT, จากนั้น SFDX URL, จากนั้น web login

ตัวแทน

cli-operator

ตัวแทน Salesforce CLI แบบอิสระที่รันคำสั่ง sf พร้อมมาตรการป้องกันความปลอดภัย การดำเนินการ Salesforce ทั้งหมดจะมอบหมายให้ตัวแทนนี้เพื่อ ให้บริบทของเซสชันหลักกระชับ

กฎความปลอดภัย:

อ่านอย่างเดียวโดยค่าเริ่มต้น — การเขียนต้องได้รับการอนุมัติอย่างชัดเจน
ไม่ดีพลอยโดยไม่มีขั้นตอนการแสดงตัวอย่างและการยืนยัน
ไม่แสดง access token, auth URL หรือข้อมูลรับรองในผลลัพธ์
ทำความสะอาดค่าทั้งหมดที่ผู้ใช้ให้มา (ปฏิเสธอักขระพิเศษของ shell)
ใช้ผลลัพธ์ --json สำหรับผลลัพธ์ที่มีโครงสร้างและแยกวิเคราะห์ได้

รูปแบบการตอบกลับ:

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

คู่มือการใช้งาน: การจัดการบัญชี

พรอมต์ด้านล่างไม่ใช่ฟีเจอร์ที่ฮาร์ดโค้ดไว้ในปลั๊กอิน พรอมต์เหล่านี้ทำงานได้ เพราะตัวแทน cli-operator สามารถรันคำสั่ง sf CLI ใดๆ ก็ได้ รวมถึง การสืบค้น SOQL แบบอิสระ ผลลัพธ์ขึ้นอยู่กับโมเดลข้อมูลของ org ของคุณและ สิทธิ์ผู้ใช้ของคุณ พรอมต์ที่นี่ได้รับการทดสอบและยืนยันแล้วว่าทำงานได้กับออบเจ็กต์ Salesforce มาตรฐาน (Account, Contact, Case, Opportunity, AccountTeamMember, OpportunityTeamMember)

พรอมต์เหล่านี้ทำงานได้กับ Salesforce org ใดก็ได้ แทนที่ค่าตัวแทน ด้วยข้อมูลของคุณเอง แต่ละพรอมต์จะให้ผลลัพธ์เฉพาะสำหรับ บทบาท บัญชี และพื้นที่การขายของคุณ

เริ่มต้นใช้งาน

หลังจากยืนยันตัวตนแล้ว ตรวจสอบว่าทุกอย่างทำงานได้:

/salesforce:sf-status

จากนั้นลองสืบค้นด้วยภาษาธรรมชาติ:

list my authenticated salesforce orgs

สิ่งที่คาดว่าจะได้รับ: ตารางแสดง org ที่เชื่อมต่อทั้งหมดพร้อม alias, ชื่อผู้ใช้, instance 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'

ทักษะการพัฒนา

ทักษะการพัฒนา Salesforce 30 รายการจาก forcedotcom/afv-library จะเปิดใช้งานโดยอัตโนมัติสำหรับ Apex, Flow, LWC, SOQL, metadata, Agentforce และงานการดีพลอย ติดตั้งแยกต่างหาก:

npx skills add forcedotcom/afv-library

หัวข้อ	ทักษะ
คลาสและบริการ Apex	`generating-apex`
การทดสอบ Apex	`generating-apex-test`
Flows	`generating-flow`
LWC และ UI bundles	`building-ui-bundle-app`
ออบเจ็กต์แบบกำหนดเอง	`generating-custom-object`
ฟิลด์แบบกำหนดเอง	`generating-custom-field`
กฎการตรวจสอบ	`generating-validation-rule`
Permission sets	`generating-permission-set`
FlexiPages	`generating-flexipage`
Agentforce agents	`developing-agentforce`
การทดสอบ Agentforce	`testing-agentforce`
การดีพลอย	`deploying-ui-bundle`
การย้าย SLDS2	`uplifting-components-to-slds2`
การปรับโครงสร้าง Trigger	`trigger-refactor-pipeline`