Context doorgeven instellen voor Agentforce
Help uw agenten sneller en nauwkeuriger te werken door contextuele gegevens te analyseren in de mobiele app Consumer Goods Cloud. U kunt definiëren hoe de app deze context samenstelt en verzendt door proces- en bedrijfslogicacontracten in te stellen in uw aanpassingsproject.
Vereiste editions
| Beschikbaar in: Enterprise en Unlimited Edition waarvoor Consumer Goods Cloud is ingeschakeld |
| Benodigde gebruikersmachtigingen | |
|---|---|
| Context doorgeven configureren voor Agentforce | Ontwikkelaar, Aanpasser |
Opmerking Context doorgeven werkt wanneer u Agentforce gebruikt in de mobiele app Consumer Goods Cloud op een fysiek mobiel apparaat. Het werkt niet in de Modeler-simulatorapp.
Voer bijvoorbeeld voor het doorgeven van de bezoek-ID vanuit de storecockpit deze stappen uit:
- Open uw aanpassingsproject in Visual Studio Code based Modeler.
-
Definieer indien nodig een
Actionin een procescontract.- Open het relevante procescontract.
-
Implementeer een logica om gegevens door te geven aan
Actionof gegevens op te halen uit een reeds beschikbaar object. In dit voorbeeld maakt u eenActionmet logica die de objectnaam en record-ID gebruikt als invoerparameters om de aangepaste bedrijfslogica aan te roepen.<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> -
Voeg de externe event
agentforceLaunchEventtoe en bind deze aan de actie.<ExternalEvent name="agentforceLaunchEvent" action="LaunchAgentforce" />
Hier is een voorbeeld van de configuratie van het procescontract:
<!-- 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" /> -
Implementeer de logica voor het samenstellen van de payload en roep de oorspronkelijke gevel aan.
- Open het contract voor bedrijfslogica waarnaar wordt verwezen in uw procesactie.
-
Implementeer de functie die overeenkomt met de naam die is gedefinieerd in uw
Action. -
Stel de JSON-payload samen die de
objectApiNameen kenmerken bevat. -
Roep de
Facade.launchAgentForce()aan.
Hier is een voorbeeld van de implementatie van bedrijfslogica:
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; }
Voorbeeld van payloadstructuur voor een specifieke bezoekrecord die als urgent is gemarkeerd.
{
"objectApiName": "Visit",
"attributes": {
"recordId": "a00xx0000012345AAA",
"pageType": "standard_recordPage",
"actionName": "view"
},
"additionalAttributes": [
{
"name": "customStatus",
"value": "urgent",
"type": "String"
}
]
}Parameter Details:
objectApiName: (Tekenreeks) Verplicht. De API-naam van de Salesforce-objectcontext.attributes: (Object) Verplicht. Een container voor record-ID's, met name recordId.additionalAttributes: (Array) Optioneel. Sleutel-waardeparen voor extra context.
Heeft dit artikel uw probleem opgelost?
Laat ons weten wat we kunnen doen om te verbeteren!

