Agentforce Agent Script

Ciclo di vita end-to-end dell'agente Salesforce Agentforce: design, Agent Script, validazione, deployment, pubblicazione.

di SalesforceAIResearch · SalesforceAIResearch/agentforce-adlc

Promosso ★ 9.2/10

Agentforce Agent Script — Ciclo di vita end-to-end dell'agente Salesforce Agentforce: design, Agent Script, validazione, deployment, pubblicazione.

Cosa fa

Gestisce l'intero ciclo di vita di sviluppo dell'agente Agentforce — design di Agent Spec, scrittura di file .agent in Agent Script, sf CLI validate/preview/deploy/publish/activate e debugging comportamentale tramite tracce di sessione — attraverso 18 file di riferimento dettagliati. Si attiva su lavoro con file .agent, metadati aiAuthoringBundle, design di subagenti/azioni e comandi CLI sf agent; esclude esplicitamente lavori su Apex, Flow ed Experience Cloud.

Rapporto di test

Installato con un comando da una HOME pulita senza ~/.claude — SKILL.md era a posto; tutti i circa 30 riferimenti a references/ e assets/ nel corpo sono stati risolti, nessun script o chiamata di rete nella skill (Fase 0 pulita). Dall'ultimo test, l'autore ha aggiunto un dominio completamente nuovo 'Optimize an Agent' (v0.8 → v0.9) con quattro pattern e ha incluso 'optimize/improve/refactor' nella descrizione — il vecchio riscontro sulla Regola 8 (proibizione else-if) è ancora lì e intatto. Eseguito il nuovo dominio sul mio file .agent con quattro difetti iniettati: senza la skill, ho inventato una sintassi inesistente `@actions.fetch_case.outputs.caseRecord` (il linguaggio core afferma esplicitamente: `@outputs` vive solo in `set`/`if` immediatamente dopo un'azione), ho lasciato `@variables.customerName` senza `{!...}` e tutta la logica condizionale in prosa; con la skill — relay corretto tramite una variabile mutabile, 4 binding `set @variables.X = @outputs.Y`, iniezioni `{!...}` e istruzioni `if` piatte secondo la Regola 8. Contro: i nuovi file di pattern e il template di report in SKILL.md richiedono `orderRecord: mutable object` e `roomAvailable: boolean` senza valori predefiniti, il che contraddice il riferimento al linguaggio core della skill (sezione 6 e Anti-Pattern 12: le variabili mutabili DEVONO avere un valore predefinito) — per questo, sono stati detratti punti dall'output e dalla documentazione. Non è stato possibile controllare il passaggio 'sf agent validate': la CLI `sf` e un'organizzazione Salesforce non erano nell'ambiente, la compilazione non è stata misurata — è stata controllata solo rispetto alle regole documentate della skill.

Testato il: 2026-07-13 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/SalesforceAIResearch/agentforce-adlc
cd agentforce-adlc
mkdir -p ~/.claude/skills
cp -r skills/agentforce-generate ~/.claude/skills/agentforce-generate

Comandi e prompt di esempio

  • /agentforce-generateCiclo di vita end-to-end dell'agente Salesforce Agentforce: design, Agent Script, validazione, deployment, pubblicazione.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Add a billing subagent to our Agentforce agent for unpaid invoices
  • Write an Agent Spec and design the subagent graph for a support agent
  • My sf agent validate is failing, help debug this .agent file