Configurar el paso de contexto para Agentforce
Ayude sus agentes a trabajar con mayor rapidez y precisión analizando datos contextuales en la aplicación móvil Consumer Goods Cloud. Puede definir cómo crea y envía la aplicación este contexto configurando contratos de proceso y lógica comercial en su proyecto de personalización.
Ediciones necesarias
| Disponible en: Ediciones Enterprise y Unlimited que tienen Consumer Goods Cloud activado |
| Permisos de usuario necesarios | |
|---|---|
| Para configurar el paso de contexto para Agentforce | Desarrollador, Personalizador |
Nota El paso de contexto funciona cuando utiliza Agentforce en la aplicación móvil Consumer Goods Cloud en un dispositivo móvil físico. No funciona en la aplicación del simulador de Modeler.
Por ejemplo, para pasar el Id. de visita desde el puesto de mando del establecimiento, realice estos pasos:
- Abra su proyecto de personalización en Modeler basado en Visual Studio Code.
-
Si es necesario, defina una lógica de
Actionen un contrato de proceso.- Abra el contrato de proceso relevante.
-
Implemente una lógica para pasar datos a
Actiono obtener datos de un objeto ya disponible. En este ejemplo, cree unaActionde lógica que utilice el nombre del objeto y el Id. del registro como parámetros de entrada para llamar a la lógica comercial personalizada.<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> -
Agregue el evento externo
agentforceLaunchEventy vincúlelo a la acción.<ExternalEvent name="agentforceLaunchEvent" action="LaunchAgentforce" />
A continuación se incluye una muestra de la configuración del contrato de proceso:
<!-- 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" /> -
Implemente la lógica para construir la carga y llamar a la fachada nativa.
- Abra el contrato de lógica comercial al que se hace referencia en su acción de proceso.
-
Implemente la función que coincida con el nombre definido en su llamada de
Action. -
Construya la carga JSON que contiene los
objectApiNamey atributos. -
Invoque la función
Facade.launchAgentForce().
A continuación se incluye una muestra de la implementación de la lógica comercial:
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; }
Estructura de carga de muestra para un registro de visita específico marcado como urgente.
{
"objectApiName": "Visit",
"attributes": {
"recordId": "a00xx0000012345AAA",
"pageType": "standard_recordPage",
"actionName": "view"
},
"additionalAttributes": [
{
"name": "customStatus",
"value": "urgent",
"type": "String"
}
]
}Detalles de parámetro:
objectApiName: (Cadena) Obligatorio. El nombre de API del contexto de objeto de Salesforce.attributes: (Objeto) Obligatorio. Un contenedor para identificadores de registro, específicamente recordId.additionalAttributes: (Matricial) Opcional. Pares clave-valor para contexto adicional.
¿Resolvió este artículo su problema?
¡Háganos saber cómo podemos mejorar!

