Loading
Salesforce now sends email only from verified domains. Read 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 Agentforce Session Tracing

            You are here:

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

            Data Model for Agentforce Session Tracing

            Use the data in Data 360 DLOs/DMOs to build reports, dashboards, and queries that provide insights into agent behavior.

            Required Editions

            Available in: Enterprise, Performance, and Unlimited Editions with an Einstein for Sales, Einstein for Platform, Einstein for Service, Einstein 1 Service, or Einstein GPT Service add-on. To purchase add-ons, contact your Salesforce account executive.

            About the Agentforce Session Tracing Data Model

            The data model for Agentforce Session Tracing is a collection of DLOs (data lake objects) and DMOs (data model objects) that contain detailed session trace logs of agent behavior. The data model also includes references to every LLM call that the reasoning engine makes to support joins with feedback data or guardrails metrics. Data streams direct data to DLOs in Data 360. DMOs are mapped to the DLOs.

            Agentforce Session Tracing Data Model Entity Relationship Diagram

            An entity relationship diagram showing the entities and relationships of the Agentforce Session Tracing Data Model.
            DLO/DMO Description
            AIAgentSession Represents an overarching container capturing contiguous interactions with one or more AI agents. A typical session can start when the customer asks their first question and end when the customer closes the agent chat window.
            AIAgentSessionParticipant Represents an entity (human or AI) that takes part in an AIAgentSession.
            AIAgentInteraction Represents a segment within a session. It typically begins with a user’s request and ends when the AI agent provides a response to that request.
            AIAgentInteractionStep Represents a discrete action or operation performed during an interaction to fulfill the user’s request.
            AIAgentInteractionMessage Represents a single communication provided by the user or generated by the AI agent during a session.

            Here are the relationships between entities.

            Object Relationship
            AIAgentSession: AIAgentInteraction 1: Many (one session has many interactions)
            AIAgentSession: AIAgentSessionParticipant 1: Many (one session has many participants)
            AIAgentInteraction: AIAgentInteractionMessage 1: Many (one interaction has many messages)
            AIAgentInteraction: AIAgentInteractionStep 1: Many (one interaction has many steps)
            AIAgentInteractionMessage: AIAgentSessionParticipant

            Many: 1 (each message has one sender participant).

            Also, AIAgentInteractionMessage > parent message (optional self-link) for threads.

            AI Agent Session DMO

            A Data Cloud DMO that captures agent session-level details. The AIAgentSession object has these attributes.

            Field Label Field API Name Data Type Description
            AI Agent Session Id Id Text Primary key.
            Start Timestamp StartTimestamp Date - Time Timestamp when the session began.
            End Timestamp EndTimestamp Date - Time Timestamp when the session concluded or timed out.
            Variable VariableText Text Reserved for future use. Key-value pairs of contextual session data used by agents during interactions.
            Session Owner SessionOwnerId Text Reserved for future use. ID of the record of the participant who initiated the session.
            Session Owner Object SessionOwnerObject Text

            Reserved for future use. The name of the DMO to which the Session Owner record belongs.

            Example value: Individual
            Individual IndividualId Text - Reference Id (Lookup) Reserved for future use. Reference to an Individual record that represents the session owner participant. Populated only if the SessionOwnerObject is Individual.
            AI Agent Channel Type AiAgentChannelTypeId Text - Reference Id (Lookup) Type of communication channel that intiated the session.
            Related Voice Call VoiceCallId Text - Reference Id (Lookup) ID that links the session to the voice call that initiated the session.
            Related Messaging Session MessagingSessionId Text - Reference Id (Lookup) ID linking the AI agent session to the messaging session that initiated the AI agent session.
            Previous Session Id PreviousSessionId Text - Reference Id (Lookup) Reserved for future use. Reference to the previous AI agent session. Applies in a multi-agent session scenario.
            AI Agent Session End Type AiAgentSessionEndType Text - Reference Id (Lookup)

            How the session ended.

            Example values: resolved, escalated, deflected, or other.

            AI Agent Session Participant DMO

            A Data Cloud DMO that captures details about who was associated with the session (for example, the Contact, Lead, or Account). The AIAgentSessionParticipant object has these attributes.

            Field Label Field API Name Data Type Description
            AI Agent Session Participant Id Id Text Primary key.
            AI Agent Session AiAgentSessionId Text - Reference - Id (Parent) Reference to the specific AiAgentSession in which this participant was involved.
            AI Agent Type AiAgentTypeId Text - Reference - Id (Lookup)

            Type of AI Agent.

            Example values: Employee, EinsteinSDR, EinsteinServiceAgent
            AI Agent Template Api Name AiAgentTemplateApiName Text Template used to create the agent.
            Start Timestamp Date - Time Date - Time Timestamp when the participant joined the session.
            End Timestamp Date - Time Date - Time Timestamp when the participant left the session or stopped interacting in the session.
            Participant Attribute ParticipantAttributeText Text Reserved for future use. JSON key-value pairs that represent other metadata or attributes of the participant specific to this session.
            Participant ParticipantId Text Reference to the record representing the participant involved in the session.
            Participant Object ParticipantObject Text

            Name of the DMO to which the Participant record belongs.

            Example values: Individual
            AI Agent Version Api Name AiAgentVersionApiName Text API name of the AI agent version. Populated only if the participant is an AI agent.
            AI Agent Api Name AiAgentApiName Text API name of the AI agent. Populated only if the participant is an AI agent.
            Individual IndividualId Text - Reference - Id (Lookup) Reserved for future use. Reference to an Individual record that represents the participant. Populated if the participant record's DMO type is Individual.
            AI Agent Session Participant Role AiAgentSessionParticipantRoleId Text - Reference - Id (Lookup)

            Defines the role of the participant within the session.

            Example values: Owner, Observer

            AI Agent Interaction DMO

            A Data Cloud DMO that captures turn-by-turn details associated with interactions. The AIAgentInteraction object has these attributes.

            Field Label Field API Name Data Type Description
            AI Agent Interaction Id Id Text Primary key.
            AI Agent Session AiAgentSessionId Text - Reference - Id (Parent) Reference to the parent session in which this interaction occurred.
            Previous Interaction PrevInteractionId Text - Reference - Id (Lookup) Reference to the previous interaction. Enables the sequencing or chaining of interactions.
            Ai Agent Interaction Type AiAgentInteractionTypeId Text - Reference - Id (Lookup)

            Categorizes the interaction type.

            Example value: Turn
            Start Timestamp StartTimestamp Date - Time Timestamp when the interaction began.
            End Timestamp EndTimestamp Date - Time Timestamp when the interaction completed.
            Attributes AttributeText Text JSON key-value pairs that store other metadata or contextual information specific to the interaction.
            Telemetry Trace TelemetryTraceId Text Identifier used for distributed tracing. Allows for the tracking of interactions across system components.
            Telemetry Trace Span TelemetryTraceSpanId Text - Reference - Id (Lookup) Span identifier for tracing this specific interaction within a larger distributed tracing context.
            Session Owner SessionOwnerId Text Reserved for future use. Id of the record of the participant who initiated (owned) the session.
            Session Owner Object SessionOwnerObject Text

            Reserved for future use. The name of the DMO to which the Session Owner record belongs.

            Example value: Individual
            Individual IndividualId Text - Reference - Id (Lookup) Reserved for future use. Reference to an Individual record that represents the session owner participant. Populated only if the SessionOwnerObject is Individual.
            Topic Api Name TopicApiName Text API name of the subagent that was classified for the interaction.

            AI Agent Interaction Message DMO

            A Data Cloud DMO that captures details about session interaction messages. The AIAgentInteractionMessage object has these attributes.

            Field Label Field API Name Data Type Description
            AI Agent Interaction Message Id Id Text Primary key.
            AI Agent Interaction AiAgentInteractionId Text - Reference - Id (Parent) Reference to the interaction to which this message belongs.
            AI Agent Session Participant AiAgentSessionParticipantId Text - Reference - Id (Lookup) Reference to the participant who sent the message.
            Parent Message ParentMessageId Text - Reference - Id (Lookup) Reference to another message. Populated if this message is a reply or continuation.
            AI Agent Interaction Message Type AiAgentInteractionMessageTypeId Text - Reference - Id (Lookup)

            Type of message.

            Example values: Input, Output
            Message Sent Timestamp MessageSentTimestamp Date - Time Exact time when the message was sent.
            Ai Agent Interaction Msg Content Type AiAgentInteractionMsgContentTypeId Text - Reference - Id (Lookup)

            Format or type of the message content.

            Example values: text/plain, application/json, audio/wav
            Content ContentText Text Textual content if the message is text based. If not text based, the field contains NA.
            AI Agent Session AiAgentSessionId Text - Reference - Id (Lookup) Reference to the session to which this message belongs.
            Session Owner SessionOwnerId Text Reserved for future use. ID of the record of the participant who initiated the session (owner).
            Session Owner Object SessionOwnerObject Text

            Reserved for future use. The name of the DMO to which the Session Owner record belongs.

            Example value: Individual
            Individual IndividualId Text - Reference - Id (Lookup) Reserved for future use. Reference to an Individual record. Represents the session owner participant. Populated only if the SessionOwnerObject is Individual.

            AI Agent Interaction Step DMO

            A Data Cloud DMO that captures details about interaction steps. The AIAgentInteractionStep object has these attributes.

            Field Label Field API Name Data Type Description
            AI Agent Interaction Step Id Id Text Primary key.
            AI Agent Interaction AiAgentInteractionId Text - Reference - Id (Parent) Reference to the interaction to which this step belongs.
            Previous Step PrevStepId Text - Reference - Id (Lookup) Reserved for future use. Reference to the previous interaction. Enables the sequencing or chaining of interactions.
            Ai Agent Interaction Step Type AiAgentInteractionStepTypeId Text - Reference - Id (Lookup)

            Categorizes the step type.

            Example values: UserInputStep, LLMExecutionStep, FunctionStep
            Start Timestamp StartTimestamp Date - Time Timestamp when step execution began.
            End Timestamp EndTimestamp Date - Time Timestamp when step execution completed.
            Pre-step Variables PreStepVariableText Text Reserved for future use. State of relevant variables before step execution began.
            Post-step Variables PostStepVariableText Text Reserved for future use. State of variables after step execution ends.
            Input Value InputValueText Text Input data provided to the step.
            Output Value OutputValueText Text Output data resulting from the step's execution.
            Error Message ErrorMessageText Text Error details if the step execution encountered issues or exceptions.
            Attributes AttributeText Text JSON key-value pairs representing other metadata or properties of the step.
            Telemetry Trace Span TelemetryTraceSpanId Text - Reference - Id (Lookup) Identifier used for distributed tracing. It associates this step within a broader tracing context.
            Generation GenerationId Text Reference to a GenAiGeneration record if the step made an LLM generation request.
            Gen AI Gateway Request GenAiGatewayRequestId Text Reference to a GenAiGatewayRequest record if the step made an LLM generation request.
            Gen AI Gateway Response GenAiGatewayResponseId Text Reference to a GenAiGatewayResponse record if the step involved makes an LLM generation request.
            Name Name Text Name of the step performed by the AI Agent. For example, if the step type is an action, the Name is the Action Name.
             
            Loading
            Salesforce Help | Article