Agentforce Agent Script

Cycle de vie complet de l'agent Salesforce Agentforce : conception, Agent Script, validation, déploiement, publication.

par SalesforceAIResearch · SalesforceAIResearch/agentforce-adlc

Testé · Fonctionne ★ 9.2/10

Agentforce Agent Script — Cycle de vie complet de l'agent Salesforce Agentforce : conception, Agent Script, validation, déploiement, publication.

Ce que fait

Gère le cycle de vie complet du développement d'agents Agentforce — conception de la spécification d'agent, écriture de fichiers .agent en Agent Script, validation/prévisualisation/déploiement/publication/activation via sf CLI, et débogage comportemental via des traces de session — à travers 18 fichiers de référence détaillés. Se déclenche sur le travail de fichiers .agent, les métadonnées aiAuthoringBundle, la conception de sous-agents/actions, et les commandes sf agent CLI ; exclut explicitement le travail sur Apex, Flow et Experience Cloud.

Rapport de test

Installé avec une commande depuis un HOME propre sans ~/.claude — SKILL.md était en place ; toutes les ~30 références à references/ et assets/ dans le corps étaient résolues, aucun script ou appel réseau dans la compétence (Stage 0 propre). Depuis le dernier test, l'auteur a ajouté un tout nouveau domaine 'Optimize an Agent' (v0.8 → v0.9) avec quatre patterns et a inclus 'optimize/improve/refactor' dans la description — l'ancienne découverte concernant la Règle 8 (interdiction du else-if) est toujours là et intacte. Exécuté le nouveau domaine sur mon fichier .agent avec quatre défauts injectés : sans la compétence, j'ai inventé une syntaxe non existante `@actions.fetch_case.outputs.caseRecord` (le langage de base stipule explicitement : `@outputs` ne vit que dans `set`/`if` immédiatement après une action), laissé `@variables.customerName` sans `{!...}` et toute la logique conditionnelle en prose ; avec la compétence — relais correct via une variable mutable, 4 liaisons `set @variables.X = @outputs.Y`, injections `{!...}`, et instructions `if` plates selon la Règle 8. Moins : les nouveaux fichiers de pattern et le modèle de rapport dans SKILL.md nécessitent `orderRecord: mutable object` et `roomAvailable: boolean` sans valeurs par défaut, ce qui contredit la référence du langage de base de la compétence (section 6 et Anti-Pattern 12 : les variables mutables DOIVENT avoir une valeur par défaut) — pour cela, des points ont été déduits de la sortie et de la documentation. N'a pas pu vérifier l'étape 'sf agent validate' : CLI `sf` et une organisation Salesforce n'étaient pas dans l'environnement, la compilation n'a pas été mesurée — seulement vérifié par rapport aux règles documentées de la compétence.

Testé le: 2026-07-13 · Claude Code 2.x (agent harness)

Installation

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

Commandes et exemples de prompts

/agentforce-generateCycle de vie complet de l'agent Salesforce Agentforce : conception, Agent Script, validation, déploiement, publication.

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →