Configuration de la transmission de contexte pour Agentforce
Aidez vos agents à travailler plus vite et avec plus de précision en analysant les données contextuelles dans l'application mobile Consumer Goods Cloud. Vous pouvez définir comment l'application élabore et envoie ce contexte en configurant des contrats de processus et de logique métier dans votre projet de personnalisation.
Éditions requises
| Disponible avec : Éditions Enterprise et Unlimited dans lesquelles Consumer Goods Cloud est activé |
| Autorisations utilisateur requises | |
|---|---|
| Pour configurer la transmission de contexte pour Agentforce | Développeur, Personnaliseur |
Remarque La transmission de contexte fonctionne lorsque vous utilisez Agentforce dans l'application mobile Consumer Goods Cloud sur un appareil mobile physique. Elle ne fonctionne pas dans l'application simulateur Modeler.
Par exemple, pour transmettre l'ID de visite depuis le cockpit du magasin, procédez comme suit :
- Ouvrez votre projet de personnalisation dans Visual Studio Code based Modeler.
-
Si nécessaire, définissez une logique de
Actiondans un contrat de processus.- Ouvrez le contrat de processus approprié.
-
Implémentez une logique pour transmettre des données à des
Actionou récupérer des données à partir d'un objet déjà disponible. Dans cet exemple, créez uneActionlogique qui utilise le nom de l'objet et l'ID d'enregistrement comme paramètres d'entrée pour appeler la logique métier personnalisée.<Action actionType="LOGIC" name="LaunchAgentforce" call="ProcessContext::CardController.launchAgentforce"> <Parameters> <Input name="objectName" type="Literal" value="Visit" /> <Input name="recordId" type="Binding" value="ProcessContext::mainBO.PKey" /> </Parameters> </Action> -
Ajoutez l'événement externe
agentforceLaunchEventet liez-le à l'action.<ExternalEvent name="agentforceLaunchEvent" action="LaunchAgentforce" />
Voici un exemple de configuration de contrat de processus :
<!-- Define the Action to call the Business Logic function --> <Action actionType="LOGIC" name="LaunchAgentforce" call="ProcessContext::CardController.launchAgentforce"> <Parameters> <!-- Pass the Object API Name --> <Input name="objectName" type="Literal" value="Visit" /> <!-- Pass the Record ID dynamically from the current Business Object --> <Input name="recordId" type="Binding" value="ProcessContext::mainBO.PKey" /> </Parameters> </Action> <!-- Define the External Event to intercept the header button click --> <ExternalEvent name="agentforceLaunchEvent" action="LaunchAgentforce" /> -
Implémentez la logique pour construire la charge utile et appeler la façade native.
- Ouvrez le contrat de logique métier référencé dans votre action de processus.
-
Implémentez la fonction correspondant au nom défini dans votre appel
Action. -
Construisez la charge de travail JSON contenant les
objectApiNameet les attributs. -
Invoquez la fonction
Facade.launchAgentForce().
Voici un exemple d'implémentation d'une logique métier :
function launchAgentforce(objectName, recordId){ var me = this; ////////////////////////////////////////////////////////////////////////////// // Add your customizing javaScript code below. // ////////////////////////////////////////////////////////////////////////////// var promise; let payload = { "objectAPIName": objectName, "attributes": { "recordId": recordId } }; Facade.launchAgentForce(payload); promise = Promise.resolve(); ////////////////////////////////////////////////////////////////////////////// // Add your customizing javaScript code above. // ////////////////////////////////////////////////////////////////////////////// return promise; }
Exemple de structure de charge utile pour un enregistrement de visite spécifique marqué comme urgent.
{
"objectApiName": "Visit",
"attributes": {
"recordId": "a00xx0000012345AAA",
"pageType": "standard_recordPage",
"actionName": "view"
},
"additionalAttributes": [
{
"name": "customStatus",
"value": "urgent",
"type": "String"
}
]
}Détails du paramètre :
objectApiName: (Chaîne) Obligatoire. Le nom d'API du contexte de l'objet Salesforce.attributes: (Objet) Obligatoire. Un conteneur d'identifiants d'enregistrement, plus précisément recordId.additionalAttributes: (Tableau) Facultatif. Paires clé-valeur pour plus de contexte.
Cet article a-t-il résolu votre problème ?
Dites-nous ce que nous pouvons améliorer !

