Invoke an Einstein Prediction Builder model score from Apex using the ConnectApi.EinsteinAI methods to enrich a lead record at save time

In-depth guide

Steps

1. Ensure the Einstein Prediction Builder model is active and a prediction definition has been created for the target object (e.g. Lead) and field
2. In an Apex trigger or invocable method, call ConnectApi.EinsteinAI.getPredictions() passing the prediction definition API name and a list of record IDs
3. Parse the ConnectApi.EinsteinAIPredictionResult list returned, extracting the 'predictionField' value and confidence score for each record
4. Write the score and confidence back to a custom field on the Lead record using a DML update inside an async context (future or queueable) to avoid mixed DML errors
5. Add error handling for cases where the prediction model is unavailable or returns a 'NO_PREDICTION' outcome