An Agentforce wants to include data from the response of an external service invocation (REST API callout) into a prompt template. The goal is to incorporate dynamic data retrieved from an external API into the AI-generated content.
Solution:
Use External Service Record Merge Fields
External Service Integration:
Definition: External Services in Salesforce allow the integration of external REST APIs into Salesforce without custom code.
Registration: The external service must be registered in Salesforce, defining the API's schema and methods.
External Service Record Merge Fields:
Purpose: Enables the inclusion of data from external service responses directly into prompt templates using merge fields.
Functionality:
Dynamic Data Inclusion: Allows prompt templates to access and use data returned from REST API callouts.
Merge Fields Syntax: Use merge fields in the prompt template to reference specific data points from the API response.
Implementation Steps:
Register the External Service:
Use External Services to register the REST API in Salesforce.
Define the API's schema, including methods and data structures.
Create a Named Credential:
Configure authentication and endpoint details for the external API.
Use External Service in Flow:
Build a Flow that invokes the external service and captures the response.
Ensure the flow outputs the necessary data for use in the prompt template.
Configure the Prompt Template:
Use External Service Record merge fields in the prompt template to reference data from the flow's output.
Syntax Example: {{flowOutputVariable.fieldName}}