Datamodell for Agentforce
Bruk dataene i Data 360-DLO-er/DMO-er til å bygge rapporter, kontrollpaneler og spørringer som gir innsikt i agentvirkemåte.
Nødvendige utgaver
| Tilgjengelig i Enterprise, Performance og Ubegrenset Edition med et Einstein for Sales, Einstein for Platform, Einstein for Service, Einstein 1 Service eller Einstein GPT Service-tillegg. Hvis du vil kjøpe tillegg, kontakter du din Salesforce-kundeansvarlige. |
Om datamodellen for Agentforce
Datamodellen for Agentforce er en samling av DLO-er (datasjøobjekter) og DMO-er (datamodellobjekter) som inneholder detaljerte øktsporingslogger for agentvirkemåte. Datamodellen inkluderer også referanser til hvert LLM-kall som årsaksmotoren gjør for å støtte koblinger med tilbakemeldingsdata eller guardreils-målinger. Datastrømmer dirigerer data til DLO-er i Data 360. DMO-er tilordnes til DLO-ene.
Diagram over enhetsrelasjoner for Agentforce av datamodell
| DLO/DMO | Beskrivelse |
|---|---|
AIAgentSession
|
Representerer en overordnet beholder som fanger opp sammenhengende interaksjoner med én eller flere AI-agenter. En typisk økt kan starte når kunden stiller sitt første spørsmål, og slutte når kunden lukker chattevinduet for agenten. |
AIAgentSessionParticipant
|
Representerer en enhet (menneske eller AI) som deltar i en AIAgentSession. |
AIAgentInteraction
|
Representerer et segment i en økt. Den starter vanligvis med en brukers forespørsel og slutter når AI-agenten gir et svar på denne forespørselen. |
AIAgentInteractionStep
|
Representerer en diskret handling eller operasjon som utføres under en interaksjon for å innfri brukerens forespørsel. |
AIAgentInteractionMessage
|
Representerer en enkelt kommunikasjon levert av brukeren eller generert av AI-agenten under en økt. |
Her er relasjonene mellom enheter.
| Objekt | Relationship (Relasjon) |
|---|---|
AIAgentSession: AIAgentInteraction |
1: Mange (én økt har mange interaksjoner) |
AIAgentSession: AIAgentSessionParticipant |
1: Mange (én økt har mange deltagere) |
AIAgentInteraction: AIAgentInteractionMessage
|
1: Mange (én interaksjon har mange meldinger) |
AIAgentInteraction: AIAgentInteractionStep
|
1: Mange (én interaksjon har mange trinn) |
AIAgentInteractionMessage: AIAgentSessionParticipant |
Mange: 1 (hver melding har én avsenderdeltaker). Også, |
AI Agent-økt-DMO
Et Data Cloud DMO som fanger opp detaljer på agentnivå. AIAgentSession-objektet har disse attributtene.
| Feltetikett | API-navn for felt | Datatype | Beskrivelse |
|---|---|---|---|
AI Agent Session Id
|
Id
|
Tekst | Primærnøkkel. |
Start Timestamp
|
StartTimestamp
|
Dato - klokkeslett | Tidsstempel da økten startet. |
End Timestamp
|
EndTimestamp
|
Dato - klokkeslett | Foreldet. Tidsstempel når økten ble avsluttet eller tidsavbrutt. |
Variable
|
VariableText
|
Tekst | Reservert for fremtidig bruk. Nøkkel-verdi-par med kontekstuelle øktdata som brukes av agenter under interaksjoner. |
Session Owner
|
SessionOwnerId
|
Tekst | Reservert for fremtidig bruk. ID-en til posten til deltakeren som startet økten. |
Session Owner Object
|
SessionOwnerObject
|
Tekst | Reservert for fremtidig bruk. Navnet på DMO-et som Økteier-posten tilhører. Eksempelverdi: |
Individual
|
IndividualId
|
Tekst - referanse-ID (oppslag) | Reservert for fremtidig bruk. Referanse til en Individual-post som representerer økteierdeltakeren. Fylles ut bare hvis SessionOwnerObject er Individual. |
AI Agent Channel Type
|
AiAgentChannelTypeId
|
Tekst - referanse-ID (oppslag) | Type kommunikasjonskanal som startet økten. |
Related Voice Call
|
VoiceCallId
|
Tekst - referanse-ID (oppslag) | IDen som kobler økten til talesamtalen som startet økten. |
Related Messaging Session
|
MessagingSessionId
|
Tekst - referanse-ID (oppslag) | ID som kobler AI-agentøkten til meldingsøkten som startet AI-agentøkten. |
Previous Session Id
|
PreviousSessionId
|
Tekst - referanse-ID (oppslag) | Reservert for fremtidig bruk. Referanse til den forrige AI-agentøkten. Gjelder i et scenario for en økt med flere agenter. |
AI Agent Session End Type
|
AiAgentSessionEndType
|
Tekst - referanse-ID (oppslag) | Foreldet. Hvordan økten ble avsluttet. Eksempelverdier: |
AI-agentøktdeltaker-DMO
Et Data Cloud DMO som fanger opp detaljer om hvem som ble tilknyttet økten (for eksempel Kontakt, Salgsemne eller Konto). AIAgentSessionParticipant-objektet har disse attributtene.
| Feltetikett | API-navn for felt | Datatype | Beskrivelse |
|---|---|---|---|
AI Agent Session Participant Id
|
Id
|
Tekst | Primærnøkkel. |
AI Agent Session
|
AiAgentSessionId
|
Tekst - Referanse - Id (overordnet) | Referanse til den spesifikke AiAgentSession som denne deltakeren var involvert i. |
AI Agent Type
|
AiAgentTypeId
|
Tekst - Referanse - Id (oppslag) | Type AI-agent. Eksempelverdier: |
AI Agent Template Api Name
|
AiAgentTemplateApiName
|
Tekst | Mal brukt til å opprette agenten. |
Start Timestamp
|
Date - Time
|
Dato - klokkeslett | Tidsstempel da deltakeren sluttet seg til økten. |
End Timestamp
|
Date - Time
|
Dato - klokkeslett | Tidsstempel når deltakeren forlot økten eller sluttet å samhandle i økten. |
Participant Attribute
|
ParticipantAttributeText
|
Tekst | Reservert for fremtidig bruk. JSON-nøkkel-verdi-par som representerer andre metadata eller attributter for deltakeren spesifikk for denne økten. |
Participant
|
ParticipantId
|
Tekst | Referanse til posten som representerer deltakeren som er involvert i økten. |
Participant Object
|
ParticipantObject
|
Tekst | Navnet på DMO-et som Deltaker-posten tilhører. Eksempelverdier: |
AI Agent Version Api Name
|
AiAgentVersionApiName
|
Tekst | API-navnet på AI-agentversjonen. Fylles ut bare hvis deltakeren er en AI-agent. |
AI Agent Api Name
|
AiAgentApiName
|
Tekst | API-navnet på AI-agenten. Fylles ut bare hvis deltakeren er en AI-agent. |
Individual
|
IndividualId
|
Tekst - Referanse - Id (oppslag) | Reservert for fremtidig bruk. Referanse til en Individual-post som representerer deltakeren. Fylles ut hvis deltakerpostens DMO-type er Individual. |
AI Agent Session Participant Role
|
AiAgentSessionParticipantRoleId
|
Tekst - Referanse - Id (oppslag) | Definerer rollen til deltakeren i økten. Eksempelverdier: |
AI Agent Interaction DMO (DMO for AI-agentinteraksjon)
Et Data Cloud DMO som fanger opp detaljene som er knyttet til interaksjoner. AIAgentInteraction-objektet har disse attributtene.
| Feltetikett | API-navn for felt | Datatype | Beskrivelse |
|---|---|---|---|
AI Agent Interaction Id
|
Id
|
Tekst | Primærnøkkel. |
AI Agent Session
|
AiAgentSessionId
|
Tekst - Referanse - Id (overordnet) | Referanse til den overordnede økten der denne interaksjonen skjedde. |
Previous Interaction
|
PrevInteractionId
|
Tekst - Referanse - Id (oppslag) | Referanse til den forrige interaksjonen. Aktiverer sekvensering eller kjetting av interaksjoner. |
Ai Agent Interaction Type
|
AiAgentInteractionTypeId
|
Tekst - Referanse - Id (oppslag) | Kategoriserer interaksjonstypen. Eksempelverdi: |
Start Timestamp
|
StartTimestamp
|
Dato - klokkeslett | Tidsstempel da interaksjonen startet. |
End Timestamp
|
EndTimestamp
|
Dato - klokkeslett | Tidsstempel når interaksjonen ble fullført. |
Attributes
|
AttributeText
|
Tekst | JSON-nøkkel-verdi-par som lagrer andre metadata eller kontekstinformasjon spesifikk for interaksjonen. |
Telemetry Trace
|
TelemetryTraceId
|
Tekst | Identifikator brukt til distribuert sporing. Tillater sporing av interaksjoner på tvers av systemkomponenter. |
Telemetry Trace Span
|
TelemetryTraceSpanId
|
Tekst - Referanse - Id (oppslag) | Områdeidentifikator for sporing av denne spesifikke interaksjonen innenfor en større distribuert sporingskontekst. |
Session Owner
|
SessionOwnerId
|
Tekst | Reservert for fremtidig bruk. ID-en til posten til deltakeren som startet (eiet) økten. |
Session Owner Object
|
SessionOwnerObject
|
Tekst | Reservert for fremtidig bruk. Navnet på DMO-et som Økteier-posten tilhører. Eksempelverdi: |
Individual
|
IndividualId
|
Tekst - Referanse - Id (oppslag) | Reservert for fremtidig bruk. Referanse til en Enkeltperson-post som representerer økteierdeltakeren. Fylles ut bare hvis SessionOwnerObject er Individual. |
Topic Api Name
|
TopicApiName
|
Tekst | API-navnet på underagenten som ble klassifisert for interaksjonen. |
DMO for AI Agent Interaction-melding
Et Data Cloud DMO som fanger opp detaljer om øktinteraksjonsmeldinger. AIAgentInteractionMessage-objektet har disse attributtene.
| Feltetikett | API-navn for felt | Datatype | Beskrivelse |
|---|---|---|---|
AI Agent Interaction Message Id
|
Id
|
Tekst | Primærnøkkel. |
AI Agent Interaction
|
AiAgentInteractionId
|
Tekst - Referanse - Id (overordnet) | Referanse til interaksjonen som denne meldingen tilhører. |
AI Agent Session Participant
|
AiAgentSessionParticipantId
|
Tekst - Referanse - Id (oppslag) | Referanse til deltakeren som sendte meldingen. |
Parent Message
|
ParentMessageId
|
Tekst - Referanse - Id (oppslag) | Referanse til en annen melding. Fylles ut hvis denne meldingen er et svar eller en fortsettelse. |
AI Agent Interaction Message Type
|
AiAgentInteractionMessageTypeId
|
Tekst - Referanse - Id (oppslag) | Type melding. Eksempelverdier: |
Message Sent Timestamp
|
MessageSentTimestamp
|
Dato - klokkeslett | Nøyaktig tidspunktet da meldingen ble sendt. |
Message Modality |
MessageModalityId |
Tekst - Referanse - Id (oppslag) | Meldingsmodalitet. Lenker til AI Agent Interaction Message Modality. Eksempelverdier: Voice, Text |
Ai Agent Interaction Msg Content Type
|
AiAgentInteractionMsgContentTypeId
|
Tekst - Referanse - Id (oppslag) | Formatet på eller typen meldingsinnhold. Eksempelverdier: text/plain, application/json, audio/wav |
Content
|
ContentText
|
Tekst | Tekstinnhold hvis meldingen er tekstbasert. Hvis det ikke er tekstbasert, inneholder feltet NA. |
AI Agent Session
|
AiAgentSessionId
|
Tekst - Referanse - Id (oppslag) | Referanse til økten som denne meldingen tilhører. |
Session Owner
|
SessionOwnerId
|
Tekst | Reservert for fremtidig bruk. ID-en til posten til deltakeren som startet økten (eier). |
Session Owner Object
|
SessionOwnerObject
|
Tekst | Reservert for fremtidig bruk. Navnet på DMO-et som Økteier-posten tilhører. Eksempelverdi: |
Individual
|
IndividualId
|
Tekst - Referanse - Id (oppslag) | Reservert for fremtidig bruk. Referanse til en Individual-post. Representerer økteierdeltakeren. Fylles ut bare hvis SessionOwnerObject er Individual. |
DMO for AI Agent-interaksjonstrinn
Et Data Cloud DMO som fanger opp detaljer om interaksjonstrinn. AIAgentInteractionStep-objektet har disse attributtene.
| Feltetikett | API-navn for felt | Datatype | Beskrivelse |
|---|---|---|---|
AI Agent Interaction Step Id
|
Id
|
Tekst | Primærnøkkel. |
AI Agent Interaction
|
AiAgentInteractionId
|
Tekst - Referanse - Id (overordnet) | Referanse til interaksjonen som dette trinnet tilhører. |
Previous Step
|
PrevStepId
|
Tekst - Referanse - Id (oppslag) | Reservert for fremtidig bruk. Referanse til den forrige interaksjonen. Aktiverer sekvensering eller kjetting av interaksjoner. |
Ai Agent Interaction Step Type
|
AiAgentInteractionStepTypeId
|
Tekst - Referanse - Id (oppslag) | Kategoriserer trinntypen. Eksempelverdier: |
Start Timestamp
|
StartTimestamp
|
Dato - klokkeslett | Tidsstempel da utføring av trinn begynte. |
End Timestamp
|
EndTimestamp
|
Dato - klokkeslett | Tidsstempel når utførelsen av trinnet er fullført. |
Pre-step Variables
|
PreStepVariableText
|
Tekst | Reservert for fremtidig bruk. Status for relevante variabler før utføring av trinn startet. |
Post-step Variables
|
PostStepVariableText
|
Tekst | Reservert for fremtidig bruk. Status for variabler etter at utføringen av trinnet har blitt avsluttet. |
Input Value
|
InputValueText
|
Tekst | Inndata som leveres til trinnet. |
Output Value
|
OutputValueText
|
Tekst | Utdata som er resultat av utførelsen av trinnet. |
Error Message
|
ErrorMessageText
|
Tekst | Feildetaljer hvis utføringen av trinnet støter på problemer eller unntak. |
Attributes
|
AttributeText
|
Tekst | JSON-nøkkel-verdi-par som representerer andre metadata eller egenskaper for trinnet. |
Telemetry Trace Span
|
TelemetryTraceSpanId
|
Tekst - Referanse - Id (oppslag) | Identifikator brukt til distribuert sporing. Det knytter dette trinnet til en bredere sporingskontekst. |
Generation
|
GenerationId
|
Tekst | Referanse til en GenAiGeneration-post hvis trinnet opprettet en LLM-genereringsforespørsel. |
Gen AI Gateway Request
|
GenAiGatewayRequestId
|
Tekst | Referanse til en GenAiGatewayRequest-post hvis trinnet opprettet en LLM-genereringsforespørsel. |
Gen AI Gateway Response
|
GenAiGatewayResponseId
|
Tekst | Referanse til en GenAiGatewayResponse-post hvis trinnet som er involvert, gjør en genereringsforespørsel om LLM. |
Name
|
Name
|
Tekst | Navnet på trinnet som utføres av AI-agenten. Hvis for eksempel trinntypen er en handling, blir Name Handlingsnavn. |
Hjalp denne artikkelen med å løse problemet ditt?
La oss få vite det slik at vi kan forbedre!
