Gegevensmodel voor Agentforce Sessietracering
Gebruik de gegevens in Data 360-DLO's/-DMO's om rapporten, dashboards en query's samen te stellen die insights bieden in het gedrag van agenten.
Vereiste editions
| Beschikbaar in: Enterprise, Performance en Unlimited Edition met een uitbreiding Einstein for Sales, Einstein for Platform, Einstein for Service, Einstein 1 Service of Einstein GPT Service. Neem voor het aanschaffen van uitbreidingen contact op met uw Salesforce Account Executive. |
Info over het gegevensmodel van Agentforce Sessietracering
Het gegevensmodel voor Agentforce Sessietracering is een verzameling DLO's (Data Lake Objects) en DMO's (Data Model Objects) die gedetailleerde sessietraceringslogboeken van het gedrag van agenten bevatten. Het gegevensmodel bevat ook verwijzingen naar elke LLM-aanroep die de redeneringsengine doet om joins te ondersteunen met feedbackgegevens of vangrailsmeetgegevens. Gegevensstromen leiden gegevens naar DLO's in Data 360. DMO's worden toegewezen aan de DLO's.
Entiteitsdiagram van Agentforce Sessietracering van gegevensmodel
| DLO/DMO | Beschrijving |
|---|---|
AIAgentSession
|
Vertegenwoordigt een overkoepelende container die continue interacties met een of meer AI-agenten vastlegt. Een normale sessie kan beginnen wanneer de klant de eerste vraag stelt en eindigen wanneer de klant het chatvenster voor agenten sluit. |
AIAgentSessionParticipant
|
Vertegenwoordigt een entiteit (mens of AI) die deelneemt aan een AIAgentSession. |
AIAgentInteraction
|
Vertegenwoordigt een segment binnen een sessie. Het begint meestal met het verzoek van een gebruiker en eindigt wanneer de AI-agent een reactie op dat verzoek geeft. |
AIAgentInteractionStep
|
Vertegenwoordigt een afzonderlijke actie of bewerking die wordt uitgevoerd tijdens een interactie om aan het verzoek van de gebruiker te voldoen. |
AIAgentInteractionMessage
|
Vertegenwoordigt één communicatie die wordt geleverd door de gebruiker of wordt gegenereerd door de AI-agent tijdens een sessie. |
Hier zijn de relaties tussen entiteiten.
| Object | Relatie |
|---|---|
AIAgentSession: AIAgentInteraction |
1: Veel (één sessie heeft veel interacties) |
AIAgentSession: AIAgentSessionParticipant |
1: Veel (één sessie heeft veel deelnemers) |
AIAgentInteraction: AIAgentInteractionMessage
|
1: Veel (één interactie heeft veel berichten) |
AIAgentInteraction: AIAgentInteractionStep
|
1: Veel (één interactie heeft veel stappen) |
AIAgentInteractionMessage: AIAgentSessionParticipant |
Veel: 1 (elk bericht heeft één afzenderdeelnemer).
|
DMO AI-agentsessie
Een Data Cloud-DMO dat details op sessieniveau van agenten vastlegt. Het object AIAgentSession heeft deze kenmerken.
| Veldlabel | Veld-API-naam | Gegevenstype | Beschrijving |
|---|---|---|---|
AI Agent Session Id
|
Id
|
Tekst | Primaire sleutel. |
Start Timestamp
|
StartTimestamp
|
Datum - tijd | Tijdstempel toen de sessie begon. |
End Timestamp
|
EndTimestamp
|
Datum - tijd | Niet meer gebruikt. Tijdstempel wanneer de sessie is beëindigd of een time-out heeft gehad. |
Variable
|
VariableText
|
Tekst | Gereserveerd voor toekomstig gebruik. Sleutelwaardeparen van contextuele sessiegegevens die door agenten worden gebruikt tijdens interacties. |
Session Owner
|
SessionOwnerId
|
Tekst | Gereserveerd voor toekomstig gebruik. ID van de record van de deelnemer die de sessie heeft geïnitieerd. |
Session Owner Object
|
SessionOwnerObject
|
Tekst | Gereserveerd voor toekomstig gebruik. De naam van het DMO waartoe de record Sessie-eigenaar behoort. Voorbeeldwaarde: |
Individual
|
IndividualId
|
Tekst - verwijzings-ID (opzoeken) | Gereserveerd voor toekomstig gebruik. Verwijzing naar een Individual dat de deelnemer aan de sessie-eigenaar vertegenwoordigt. Alleen ingevuld als de SessionOwnerObject Individual is. |
AI Agent Channel Type
|
AiAgentChannelTypeId
|
Tekst - verwijzings-ID (opzoeken) | Type communicatiekanaal dat de sessie heeft geïnitieerd. |
Related Voice Call
|
VoiceCallId
|
Tekst - verwijzings-ID (opzoeken) | ID die de sessie koppelt aan het spraakoproep die de sessie heeft geïnitieerd. |
Related Messaging Session
|
MessagingSessionId
|
Tekst - verwijzings-ID (opzoeken) | ID die de AI-agentsessie koppelt aan de berichtenverkeerssessie die de AI-agentsessie heeft geïnitieerd. |
Previous Session Id
|
PreviousSessionId
|
Tekst - verwijzings-ID (opzoeken) | Gereserveerd voor toekomstig gebruik. Verwijzing naar de vorige AI-agentsessie. Geldt in een sessiescenario voor meerdere agenten. |
AI Agent Session End Type
|
AiAgentSessionEndType
|
Tekst - verwijzings-ID (opzoeken) | Niet meer gebruikt. Hoe de sessie is beëindigd. Voorbeeldwaarden: |
DMO Deelnemer van AI-agentsessie
Een Data Cloud-DMO dat details vastlegt over wie aan de sessie was gekoppeld (bijvoorbeeld de contactpersoon, lead of account). Het object AIAgentSessionParticipant heeft deze kenmerken.
| Veldlabel | Veld-API-naam | Gegevenstype | Beschrijving |
|---|---|---|---|
AI Agent Session Participant Id
|
Id
|
Tekst | Primaire sleutel. |
AI Agent Session
|
AiAgentSessionId
|
Tekst - Verwijzing - ID (bovenliggend niveau) | Verwijzing naar de specifieke AiAgentSession waarbij deze deelnemer betrokken was. |
AI Agent Type
|
AiAgentTypeId
|
Tekst - Verwijzing - ID (opzoeken) | Type AI-agent. Voorbeeldwaarden: |
AI Agent Template Api Name
|
AiAgentTemplateApiName
|
Tekst | Sjabloon die wordt gebruikt om de agent te maken. |
Start Timestamp
|
Date - Time
|
Datum - tijd | Tijdstempel toen de deelnemer lid werd van de sessie. |
End Timestamp
|
Date - Time
|
Datum - tijd | Tijdstempel wanneer de deelnemer de sessie heeft verlaten of is gestopt met de interactie in de sessie. |
Participant Attribute
|
ParticipantAttributeText
|
Tekst | Gereserveerd voor toekomstig gebruik. JSON-sleutelwaardeparen die andere metagegevens of kenmerken van de deelnemer vertegenwoordigen die specifiek zijn voor deze sessie. |
Participant
|
ParticipantId
|
Tekst | Verwijzing naar de record die de bij de sessie betrokken deelnemer vertegenwoordigt. |
Participant Object
|
ParticipantObject
|
Tekst | Naam van het DMO waartoe de deelnemersrecord behoort. Voorbeeldwaarden: |
AI Agent Version Api Name
|
AiAgentVersionApiName
|
Tekst | API-naam van de AI-agentversie. Alleen ingevuld als de deelnemer een AI-agent is. |
AI Agent Api Name
|
AiAgentApiName
|
Tekst | API-naam van de AI-agent. Alleen ingevuld als de deelnemer een AI-agent is. |
Individual
|
IndividualId
|
Tekst - Verwijzing - ID (opzoeken) | Gereserveerd voor toekomstig gebruik. Verwijzing naar een Individual dat de deelnemer vertegenwoordigt. Ingevuld als het DMO-type van de deelnemersrecord Individual is. |
AI Agent Session Participant Role
|
AiAgentSessionParticipantRoleId
|
Tekst - Verwijzing - ID (opzoeken) | Definieert de rol van de deelnemer binnen de sessie. Voorbeeldwaarden: |
DMO Interactie met AI-agent
Een Data Cloud-DMO dat stapsgewijze details vastlegt die zijn gekoppeld aan interacties. Het object AIAgentInteraction heeft deze kenmerken.
| Veldlabel | Veld-API-naam | Gegevenstype | Beschrijving |
|---|---|---|---|
AI Agent Interaction Id
|
Id
|
Tekst | Primaire sleutel. |
AI Agent Session
|
AiAgentSessionId
|
Tekst - Verwijzing - ID (bovenliggend niveau) | Verwijzing naar de bovenliggende sessie waarin deze interactie heeft plaatsgevonden. |
Previous Interaction
|
PrevInteractionId
|
Tekst - Verwijzing - ID (opzoeken) | Verwijzing naar de vorige interactie. Schakelt de volgorde of keten van interacties in. |
Ai Agent Interaction Type
|
AiAgentInteractionTypeId
|
Tekst - Verwijzing - ID (opzoeken) | Categoriseert het interactietype. Voorbeeldwaarde: |
Start Timestamp
|
StartTimestamp
|
Datum - tijd | Tijdstempel toen de interactie begon. |
End Timestamp
|
EndTimestamp
|
Datum - tijd | Tijdstempel wanneer de interactie is voltooid. |
Attributes
|
AttributeText
|
Tekst | JSON-sleutel-waardeparen die andere metagegevens of contextuele informatie opslaan die specifiek is voor de interactie. |
Telemetry Trace
|
TelemetryTraceId
|
Tekst | Identifier die wordt gebruikt voor gedistribueerde tracering. Hiermee kunnen interacties tussen systeemcomponenten worden bijgehouden. |
Telemetry Trace Span
|
TelemetryTraceSpanId
|
Tekst - Verwijzing - ID (opzoeken) | Span identifier voor het traceren van deze specifieke interactie binnen een grotere gedistribueerde traceringscontext. |
Session Owner
|
SessionOwnerId
|
Tekst | Gereserveerd voor toekomstig gebruik. ID van de record van de deelnemer die de sessie heeft geïnitieerd (eigenaar was). |
Session Owner Object
|
SessionOwnerObject
|
Tekst | Gereserveerd voor toekomstig gebruik. De naam van het DMO waartoe de record Sessie-eigenaar behoort. Voorbeeldwaarde: |
Individual
|
IndividualId
|
Tekst - Verwijzing - ID (opzoeken) | Gereserveerd voor toekomstig gebruik. Verwijzing naar een record Individu die de deelnemer aan de sessie-eigenaar vertegenwoordigt. Alleen ingevuld als de SessionOwnerObject Individual is. |
Topic Api Name
|
TopicApiName
|
Tekst | API-naam van de subagent die is geclassificeerd voor de interactie. |
DMO Interactiebericht AI-agent
Een Data Cloud-DMO dat details vastlegt over berichten over sessie-interactie. Het object AIAgentInteractionMessage heeft deze kenmerken.
| Veldlabel | Veld-API-naam | Gegevenstype | Beschrijving |
|---|---|---|---|
AI Agent Interaction Message Id
|
Id
|
Tekst | Primaire sleutel. |
AI Agent Interaction
|
AiAgentInteractionId
|
Tekst - Verwijzing - ID (bovenliggend niveau) | Verwijzing naar de interactie waartoe dit bericht behoort. |
AI Agent Session Participant
|
AiAgentSessionParticipantId
|
Tekst - Verwijzing - ID (opzoeken) | Verwijzing naar de deelnemer die het bericht heeft verzonden. |
Parent Message
|
ParentMessageId
|
Tekst - Verwijzing - ID (opzoeken) | Verwijzing naar een ander bericht. Ingevuld als dit bericht een antwoord of voortzetting is. |
AI Agent Interaction Message Type
|
AiAgentInteractionMessageTypeId
|
Tekst - Verwijzing - ID (opzoeken) | Type bericht. Voorbeeldwaarden: |
Message Sent Timestamp
|
MessageSentTimestamp
|
Datum - tijd | Exacte tijd waarop het bericht is verzonden. |
Message Modality |
MessageModalityId |
Tekst - Verwijzing - ID (opzoeken) | Berichtmodaliteit. Koppelingen naar AI Agent Interaction Message Modality. Voorbeeldwaarden: Voice, Text |
Ai Agent Interaction Msg Content Type
|
AiAgentInteractionMsgContentTypeId
|
Tekst - Verwijzing - ID (opzoeken) | Indeling of type van de berichtinhoud. Voorbeeldwaarden: text/plain, application/json, audio/wav |
Content
|
ContentText
|
Tekst | Tekstuele inhoud als het bericht op tekst is gebaseerd. Als het niet op tekst is gebaseerd, bevat het veld NA. |
AI Agent Session
|
AiAgentSessionId
|
Tekst - Verwijzing - ID (opzoeken) | Verwijzing naar de sessie waartoe dit bericht behoort. |
Session Owner
|
SessionOwnerId
|
Tekst | Gereserveerd voor toekomstig gebruik. ID van de record van de deelnemer die de sessie heeft geïnitieerd (eigenaar). |
Session Owner Object
|
SessionOwnerObject
|
Tekst | Gereserveerd voor toekomstig gebruik. De naam van het DMO waartoe de record Sessie-eigenaar behoort. Voorbeeldwaarde: |
Individual
|
IndividualId
|
Tekst - Verwijzing - ID (opzoeken) | Gereserveerd voor toekomstig gebruik. Verwijzing naar een Individual. Vertegenwoordigt de deelnemer van de sessie-eigenaar. Alleen ingevuld als de SessionOwnerObject Individual is. |
DMO Interactiestap AI-agent
Een Data Cloud-DMO dat details over interactiestappen vastlegt. Het object AIAgentInteractionStep heeft deze kenmerken.
| Veldlabel | Veld-API-naam | Gegevenstype | Beschrijving |
|---|---|---|---|
AI Agent Interaction Step Id
|
Id
|
Tekst | Primaire sleutel. |
AI Agent Interaction
|
AiAgentInteractionId
|
Tekst - Verwijzing - ID (bovenliggend niveau) | Verwijzing naar de interactie waartoe deze stap behoort. |
Previous Step
|
PrevStepId
|
Tekst - Verwijzing - ID (opzoeken) | Gereserveerd voor toekomstig gebruik. Verwijzing naar de vorige interactie. Schakelt de volgorde of keten van interacties in. |
Ai Agent Interaction Step Type
|
AiAgentInteractionStepTypeId
|
Tekst - Verwijzing - ID (opzoeken) | Categoriseert het staptype. Voorbeeldwaarden: |
Start Timestamp
|
StartTimestamp
|
Datum - tijd | Tijdstempel waarop de uitvoering van de stap is begonnen. |
End Timestamp
|
EndTimestamp
|
Datum - tijd | Tijdstempel wanneer de uitvoering van de stap is voltooid. |
Pre-step Variables
|
PreStepVariableText
|
Tekst | Gereserveerd voor toekomstig gebruik. Status van relevante variabelen voordat de uitvoering van de stap begon. |
Post-step Variables
|
PostStepVariableText
|
Tekst | Gereserveerd voor toekomstig gebruik. Status van variabelen nadat de uitvoering van de stap is beëindigd. |
Input Value
|
InputValueText
|
Tekst | Invoergegevens die aan de stap zijn verstrekt. |
Output Value
|
OutputValueText
|
Tekst | Uitvoergegevens die het resultaat zijn van de uitvoering van de stap. |
Error Message
|
ErrorMessageText
|
Tekst | Foutdetails als er bij de uitvoering van de stap problemen of uitzonderingen zijn opgetreden. |
Attributes
|
AttributeText
|
Tekst | JSON-sleutel-waardeparen die andere metagegevens of eigenschappen van de stap vertegenwoordigen. |
Telemetry Trace Span
|
TelemetryTraceSpanId
|
Tekst - Verwijzing - ID (opzoeken) | Identifier die wordt gebruikt voor gedistribueerde tracering. Het koppelt deze stap binnen een bredere traceringscontext. |
Generation
|
GenerationId
|
Tekst | Verwijzing naar een GenAiGeneration-record als de stap een LLM-generatieverzoek heeft ingediend. |
Gen AI Gateway Request
|
GenAiGatewayRequestId
|
Tekst | Verwijzing naar een GenAiGatewayRequest-record als de stap een LLM-generatieverzoek heeft ingediend. |
Gen AI Gateway Response
|
GenAiGatewayResponseId
|
Tekst | Verwijzing naar een GenAiGatewayResponse-record als de betrokken stap een LLM-generatieverzoek doet. |
Name
|
Name
|
Tekst | Naam van de stap die wordt uitgevoerd door de AI-agent. Als het staptype bijvoorbeeld een actie is, is de Name de Actienaam. |
