--- schema_version: "1" id: d3923e411005ed399fbf648d58fc3cc0f21730b064290eea19ee4215e7e72d89 title: Data Model for Agentforce Session Tracing collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/generative_ai_session_trace_data_model.md canonical_url: https://help.salesforce.com/s/articleView?id=ai.generative_ai_session_trace_data_model.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 6bdd37246c5d7d711864122a7a254e40a7328dc35a8f5b98247570a1b16da6a4 description: Use the data model in Data 360 to build reports, dashboards, and queries that provide insights into agent behavior. The system streams data to data lake objects (DLOs) in Data 360 within minutes. Access the data via the standard data model objects (DMOs), which are mapped to the DLOs. products: - Agentforce - Cross Cloud release: "264" --- # Data Model for Agentforce Session Tracing Use the data model in Data 360 to build reports, dashboards, and queries that provide insights into agent behavior. The system streams data to data lake objects (DLOs) in Data 360 within minutes. Access the data via the standard data model objects (DMOs), which are mapped to the DLOs. ### 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 and DMOs 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. ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_tip.png) Tip - If you build custom reports, query the DMOs. Don't query the DLOs directly. - If you notice that data is not showing up in the DLOs as expected, investigate the equivalent Problem Record DLOs. Determine what data quality issues are showing up and address any underlying causes. See [Monitoring Data Stream Problem Records](https://help.salesforce.com/s/articleView?id=data.c360_a_datastream_dlo_problem_record.htm&type=5&language=en_US). **Agentforce Session Tracing Data Model Entity Relationship Diagram** ![An entity relationship diagram showing the entities and relationships of the Agentforce Session Tracing Data Model.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/generative_ai/images/generative_ai_session_trace_data_model.png) | 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. [AIAgentSession](https://developer.salesforce.com/docs/data/data-cloud-dmo-mapping/guide/c360dm-si-aiagentsessiondmo-dmo.html) 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 Deprecated. 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 initiated 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. Applicable in multi-agent session scenarios.
AI Agent Session End Type AiAgentSessionEndType Text - Reference Id (Lookup)

Deprecated. 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). [AIAgentSessionParticipant](https://developer.salesforce.com/docs/data/data-cloud-dmo-mapping/guide/c360dm-si-aiagentsessionparticipantdmo-dmo.html) 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. [AIAgentInteraction](https://developer.salesforce.com/docs/data/data-cloud-dmo-mapping/guide/c360dm-si-aiagentinteractiondmo-dmo.html) 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. [AIAgentInteractionMessage](https://developer.salesforce.com/docs/data/data-cloud-dmo-mapping/guide/c360dm-si-aiagentinteractionmessagedmo-dmo.html) 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.
Message Modality MessageModalityId Text - Reference - Id (Lookup) Message modality. Links to AI Agent Interaction Message Modality. Example values: Voice, Text
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 it's 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. [AIAgentInteractionStep](https://developer.salesforce.com/docs/data/data-cloud-dmo-mapping/guide/c360dm-si-aiagentinteractionstepdmo-dmo.html) 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 State of relevant variables before step execution began.
Post-step Variables PostStepVariableText Text 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.
Sub Type SubType Text Step subtype. Populated only when AiAgentInteractionStep.Type is ACTION_STEP. Examples: APEX, FLOW, MCP
Topic Api Name TopicApiName Text Developer name of a subagent (or, in a multi-agent solution, a connected subagent) at the AiAgentInteractionStep level.