Loading
Upcoming Mandatory Changes to Public Key Infrastructure (PKI)Read More
Salesforce Enforces New Security Requirements in Summer 2026Read More
Agentforce and Einstein Generative AI
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Data Model for Knowledge/RAG Quality Data and Metrics

            You are here:

            1. Salesforce Help
            2. Docs
            3. Quickstart Your Einstein Generative AI Solution

            Data Model for Knowledge/RAG Quality Data and Metrics

            Use the data in these DLOs/DMOs to build reports, dashboards, and queries that provide insights into knowledge retrieval events.

            Required Editions

            Available in: Lightning Experience
            Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type.

            About the Knowledge/RAG Quality Data and Metrics Data Model

            The data model for Knowledge/RAG Quality Data and Metrics is a collection of DLOs (Data Lake Objects) and DMOs (Data Model Objects) that contain quality data and metrics.

            Knowledge/RAG Quality Data and Metrics ERD

            An entity relationship diagram showing the entities and relationships of the Knowledge/RAG Quality Data and Metrics Data Model.
            DLO/DMO Description
            AIRetrieverRequest Represents a request to the retriever.
            AIRetrieverResponse Represents a response from the retriever.
            AIRetrieverQualityMetric Represents the quality scores derived by comparing the request and response.

            Data is streamed to DLOs in Data 360 and then mapped to the applicable DMOs.

            AIRetrieverRequest DLO

            A Data 360 DLO that captures retriever request details. The AIRetrieverRequest object has these attributes.

            Field Label Field API Name Data Type Description
            AI Retriever Request Id Id Text Primary key. Unique identifier of the AI retriever request.
            Created By CreatedById Text - Reference - Id (lookup) User who created thise record.
            Created Date CreatedDate Date - Time Timestamp (date/time) when this record was created.
            External Record Id ExternalRecordId Text Corresponding record Id from an external data source system.
            External Source Id ExternalSourceId Text Id of an external data source system.
            Feature FeatureText Text Label of the feature involved in the event origin. Identifies, in the logs, which capability or functionality triggered the retriever call or is being tracked. Examples: DocumentRetrieval, KnowledgeSearch
            Last Modified By LastModifiedById Text - Reference - Id (lookup) User who most recently changed this record.
            Last Modified Date LastModifiedDate Date - Time Timestamp (date/time) when a user most recently changed this record.
            Query QueryText Text User query sent to the retriever.
            Request Information RequestInfoText Text Additional information in the request (key-value pairs in JSON format).
            Request Timestamp RequestTimestamp Date - Time Timestamp (date/time) when the retriever request occurred.
            Retriever API Name RetrieverApiName Text API name of the retriever associated with this request
            Retriever ReferenceId RequestReferenceId Text Reference Id of the calling component, service, or process that sent the request to the retriever to fetch relevant information. Examples: agent, prompt, or Apex class.
            SessionId SessionId Text Session id of the agent that called the retriever.
            Source Additional Information SourceAdditionalInfoTxt Text Additional information associated with the source asset that originated this call (key-value pairs in JSON format). Example: PROMPT
            Source Asset API Name SourceAssetApiName Text API name of the source asset that originated this call. Example: PROMPT
            Source Asset Type SourceAssetTypeName Text Type of the source asset that originated this call. Example: PROMPT
            Source Asset Version SourceAssetVersion Text Version of the source asset that originated this call. Example: PROMPT
            SpanId SpanId Text Span id is generated from the component that called the retriever directly.
            System Modified Stamp SystemModstamp Date - Time Timestamp (date/time) when this record was last modified by a user or an automated process.
            TraceId TraceId Text Trace id of the agent session in which this retriever call occurred.

            AIRetrieverResponse DLO

            A Data 360 DLO that captures retriever response details. The AIRetrieverResponse object has these attributes.

            Field Label Field API Name Data Type Description
            AI Retriever Response Id Id Text - Primary Key Primary key. Unique identifier of the AI retriever response.
            AI Retriever Request AiRetrieverRequestId Text - Reference - Id (parent) Foreign key reference to AIRetrieverRequestId that corresponds to this retriever response.
            Created By CreatedById Text - Reference - Id (lookup) User who created this record.
            Created Date CreatedDate Date - Time Timestamp (date/time) when this record was created.
            External Record Id ExternalRecordId Text Corresponding record Id from an external data source system.
            External Source Id ExternalSourceId Text Id of an external data source system.
            Last Modified By LastModifiedById Text - Reference - Id (lookup) User who most recently changed this record.
            Last Modified Date LastModifiedDate Date - Time Timestamp (date/time) when a user most recently modified this record.
            Response Information xResponseInfoText Text Additional information in the response (key/value pairs in JSON format).
            Response Timestamp ResponseTimestamp Date - Time Timestamp (date/time) when this response was emitted.
            Result ResultText Text JSON representation of the retriever response, including chunk, SourceRecordId, and so on.
            Sort Index SortIndexNumber Number - Integer SortIndex of the chunks that the retriever returned.
            Source Record SourceRecordId Text Document reference linked to the chunk.
            System Modified Stamp SystemModstamp Date - Time Timestamp (date/time) when this record was most recently modified by a user or an automated process.

            AIRetrieverQualityMetric DMO

            A Data 360 DMO that captures retriever quality metrics details. It’s used as the basis for reports, dashboards, and queries. The AIRetrieverQualityMetric object has these attributes.

            Field Label Field API Name Data Type Description
            AI Retriever Quality Metric Id Id Text Primary key. Unique identifier associated with this metric result.
            Agent Generated Response AgentGeneratedResponseText Text Context extracted from the ResponseText in AI Response Generation.
            AI Gateway Request CustomDMORef_AiGatewayRequestId Text - Reference - Id (lookup) Foreign key reference to the GenAIGatewayRequestId associated with this metric result.
            AI Gateway Request Id AiGatewayRequestId Text Reference to the GenAIGatewayRequestId associated with this metric result.
            AI Response Generation CustomDMORef_AiResponseGenerationId Text Foreign key reference to AIResponseGeneration (Custom DMO GenAIGeneration) associated with this metric result.
            AI Response Generation Id AiResponseGenerationId Text Reference to AIResponseGeneration associated with this metric result.
            AI Retriever Request CustomDMORef_AiRetrieverRequestId Text Foreign key reference to AIRetrieverRequestId associated with this metric result
            AI Retriever Request Id AI Retriever Request Id Text Reference to AIRetrieverRequestId associated with this metric result.
            Answer Relevancy Score AnswerRelevancyScoreNumber Number - Decimal Answer Relevancy Score. How completely and how well is the question answered?
            Context Precision Score ContextPrecisionScoreNumber Number - Decimal Context Precision Score. What proportion of the right knowledge was found?
            Created By CreatedById Text - Reference - Id (lookup) User who created the record.
            Created Date CreatedDate Date - Time Timestamp (date/time) when this record was created.
            External Record Id ExternalRecordId Text Corresponding record Id from an external data source system.
            External Source Id ExternalSourceId Text Id of an external data source system.
            Faithfulness Relevancy Score FaithfulnessRelevancyScoreNumber Number - Decimal Faithfulness Relevancy Score. How well did the Agent use the found knowledge?
            Last Modified By LastModifiedById Text - Reference - Id (lookup) User who most recently changed this record.
            Last Modified Date LastModifiedDate Date - Time Timestamp (date/time) when a user most recently changed this record.
            Last Processed Request Timestamp LastProcessedReqTimestamp Date - Time Timestamp (date/time) of the AIRetrieverRequest that was last processed for metric evaluation.
            Metric Created Timestamp MetricCreatedTimestamp Date - Time Timestamp (date/time) when the metric result was generated.
            Retrieved Context Id List RetrievedContextIdListText Text List of context Ids (Top-K) extracted from ResultText in the retriever response. Used for reporting.
            Retriever Api Name RetrieverApiName Text API name of the retriever associated with this request.
            Retriever Trace Id RetrieverTraceId Text Trace Id (for example, from OTel) that was generated during the retriever request.
            Retriever Trace Span Id RetrieverTraceSpanId Text Trace Span Id (for example, from OTel) that was generated during the retriever request. Reference to Telemetry Trace DMO.
            Source Document Id List SourceDocumentIdListText Text List of Source Record Ids from the retriever response. Used for reporting.
            System Modified Stamp SystemModstamp Date - Time Timestamp (date/time) when this record was last modified by a user or an automated process.
            UserUtterance UserUtteranceText Text Context extracted from the user utterance in the retriever request. Used for reporting.
             
            Loading
            Salesforce Help | Article