Newer Version Available
AIInsightValue
An Einstein insight is created every time an Einstein feature, such as Prediction Builder, makes a prediction. An insight is represented by a root AIRecordInsight and the following child objects: AIInsightAction, AIInsightFeedback, AIInsightReason, and AIInsightValue.
AIInsightValue is a one-to-many child of AIRecordInsight. AIInsightValue represents a predicted value of a predicted insight.
Supported Calls
describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()
Special Access Rules
Available when Einstein features such as Prediction Builder or Case Classification are enabled. To access an AIInsightValue record, you must have access to the related AIRecordInsight record. To grant a user the right to create an AIInsightValue record, you can use the AICreateInsightObjects or the CreateAIInsights permission.
Fields
| Field | Details |
|---|---|
| AiInsightActionId |
|
| AiRecordInsightId |
|
| Confidence |
|
| Field |
|
| FieldValueLowerBound |
|
| FieldValueUpperBound |
|
| Name |
|
| SobjectLookupValueId |
|
| SobjectType |
|
| Value |
|
| ValueType |
|
Usage
When an Einstein feature makes a prediction and saves the results, the following events happen in a single atomic operation:
- An AIRecordInsight record is created and populated with information about the prediction insight. AIInsightAction, AIInsightReason, and AIInsightValue records are also created and made children of the AIRecordInsight record.
- If the Einstein feature uses AI prediction fields, prediction result values are written to the target AI prediction field.
- An AIPredictionEvent platform event is created, and any subscriber to AIPredictionEvent is notified.
When Einstein writes prediction results back to AI prediction fields, record save custom logic, such as Apex triggers, workflow rules, and assignment rules, aren’t run. To add custom logic based on Einstein prediction results, use a platform event subscriber, such as Process Builder, to get notifications for AIPredictionEvents that contain references to Einstein insight objects.
Custom fields can’t be added to Einstein insight objects.
Einstein insights contain information about target fields and predicted value. Your org may have created Einstein predictions that are associated with target fields with field-level security restrictions. To control how users access Einstein insights records, use Salesforce data access features such as user profiles and permission sets.