Comment créer une Scratch Org compatible avec Agentforce

Avec l’arrivée d’Agentforce dans l’univers Salesforce, de nombreuses entreprises cherchent à tester cette fonctionnalité dans leurs environnements de développement. Ce guide vous explique pas à pas comment créer une scratch org avec Agentforce activé, en utilisant les outils Salesforce CLI et un fichier de définition adapté.

📌 Prérequis

Avant de commencer, assurez-vous d’avoir :

• Salesforce CLI installé (sfdx)
• Une Dev Hub active avec l’accès à Agentforce
• Les dernières versions des plugins Salesforce
• Un projet Salesforce DX configuré

🔧 Étape 1 – Créer un fichier de définition pour la scratch org

Créez (ou modifiez) un fichier nommé par exemple project-scratch-def-agentforce.json avec le contenu suivant :

{
  "orgName": "Agentforce Scratch Org",
  "edition": "Partner Developer",
  "features": ["EnableSetPasswordInApi", "Einstein1AIPlatform"],
  "settings": {
    "lightningExperienceSettings": {
      "enableS1DesktopEnabled": true
    },
    "mobileSettings": {
      "enableS1EncryptedStoragePref2": false
    },
    "einsteinGptSettings" : {
      "enableEinsteinGptPlatform" : true
    }
  }
}
👉 Ce fichier permet d’activer explicitement Agentforce dès la création de la scratch org.
🧪 Étape 2 – Créer la scratch org

sfdx force:org:create -f config/project-scratch-def-agentforce.json -a AgentforceScratch -s -d 7

Explication des options :

• -f : chemin du fichier de définition
• -a : alias local de l’org
• -s : définit cette org comme l’org par défaut
• -d 7 : durée de vie de 7 jours

 

🧼 Étape 3 – Vérifier que Agentforce est bien activé

Une fois l’org créée, ouvrez-la avec :

sfdx force:org:open
Puis allez dans :
Setup > Agentforce Settings

Et vérifiez que Agentforce est bien activé.

Si vous ne voyez pas l’option, vérifiez que votre DevHub est bien éligible (vous devez faire partie d’un programme pilote ou d’un DevHub avec Agentforce activé).

 

🧪 Bonus : Script shell pour automatiser la création
Voici un petit script create-agentforce-scratch-org.sh que vous pouvez adapter :

echo  ### Create a scratch org ###
sf org create scratch -f config/project-scratch-def.json -a AgentScratch -d -w 20
echo  ### Open the scratch org ###
sf org open -o AgentScratch
Pour l'executer : 
sh create-agentforce-scratch-org.sh

🎯 Conclusion

Créer une scratch org compatible avec Agentforce vous permet de tester les fonctionnalités d’IA générative directement dans un environnement isolé et reproductible. C’est une étape essentielle pour expérimenter les actions personnalisées, les topics intelligents, ou tout simplement intégrer Agentforce dans vos projets clients.

Vous souhaitez automatiser des actions Salesforce avec Agentforce ou développer vos propres intégrations ?

👉 Contactez-nous chez Dev First pour aller plus loin !