Du er her:
AI Agent Generative AI-bruksdatamodell
Bruk datamodellobjektet Generativ AI-bruk av AI-agent (DMO) til å analysere Agentforce og generative AI-forbruksmønstre i Data 360.
Om AiAgentGenerativeAiUsage
Hver post representerer én generativ AI-interaksjonshendelse som behandles via AI-målingstjenesten. En hendelse kan være et kall til den store språkmodellen, en agenthandling eller en enkelt interaksjon. Objektet fanger opp fakturerings- og målingsbeslutninger fra AI-tjenester (for eksempel LLM Gateway), inkludert om interaksjonen kunne faktureres, bruksmengde, tokenantall og identifikatorer for sporing og revisjon.
Generative AI-brukfelt for AI-agent
Tabellen nedenfor viser felt for DMO-et AI Agent Generative AI Usage (AiAgentGenerativeAiUsage, med utviklernavnet AiAgentGenerativeAiUsageDmo).
| Feltetikett | Utviklernavn for felt | Datatype | Beskrivelse |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Tekst | BotDefinition- eller agentpostidentifikator (for eksempel en 0Xx-ID) når hendelsen er knyttet til en agent. |
Agent Developer Name |
AgentDeveloperName__c |
Tekst | Utviklernavnet på agenten når den er til stede. |
Agent Generative AI Usage ID |
Id__c |
Tekst | Unik identifikator for brukshendelsesposten. |
Agent Type Code |
AgentTypeCode__c |
Tekst | Agent eller opplevelsestype på høyt nivå (for eksempel EinsteinServiceAgent, AgentforceEmployeeAgent eller NOT_SET for flyter uten agent). |
AI Agent Interaction |
AiAgentInteractionId__c |
Tekst | Identifikator for en enkelt interaksjon i en økt. |
AI Agent Session |
AiAgentSessionId__c |
Tekst | Øktidentifikator som grupperer flere interaksjoner i én samtale. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Tekst | Identifikator for verktøyet som kalles opp av agenten, når det er aktuelt. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Tekst | Fullt kvalifisert navn eller målkode for basisverktøyet (for eksempel EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Tekst | Navnet på verktøyet som kalles opp, som er menneskelig lesbart eller i malstil. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Tekst | Salesforce-funksjonen som brukes til forespørselen (for eksempel PromptTemplateGenerationsInvocable eller CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Tekst | Modellidentifikator i LLM Gateway (for eksempel sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Tekst | Funksjonsnavn som representert i Generativ AI-gateway. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Tekst | Infrastrukturleietager for organisasjonen (for eksempel core/prod/ pluss organisasjons-IDen på 18 tegn). |
Is Billable
|
IsBillableIndicator__c
|
Boolsk | Om hendelsen var ment å være fakturerbar for produktfunksjonen. |
Is Metered
|
IsMeteredIndicator__c
|
Boolsk | Om hendelsen ble målt og belastet (sluttbeslutning om måling). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Tekst | Når det er aktuelt, ble årsaken til at bruken ikke ble målt (for eksempel NOT_SKIPPED eller andre produktspesifikke koder). |
Model Class Type |
ModelClassType__c |
Tekst | Modellbruksklasse (for eksempel STANDARD eller BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Tekst | Leverandørspesifikk modellnavnstreng. |
Model Provider Name |
ModelProviderName__c |
Tekst | Leverandør av modellen (for eksempel openai, azureopenai eller Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Tall | Antall fullførelsestokener returnert. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Tall | Antall inndatatokener for ledeteksten. |
Prompt Template |
PromptTemplateIdentifier__c |
Tekst | ID-en til ledetekstutformingen som brukes til maldrevne generasjoner. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Tekst | Utviklernavnet på ledetekstmalen. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Tall | Totalt antall ledetekster (inndata pluss fullføring) når rapporteres samlet. |
Request Identifier |
RequestIdentifier__c |
Tekst | Unik identifikator for den spesifikke gateway- eller kjøretidsforespørselen. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Tekst | Sporingsidentifikator for slutt-til-slutt-logg-korrelasjon (for eksempel en B3-sporings- eller heksadesporingsverdi). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Tekst | Unik identifikator for den spesifikke gateway- eller kjøretidsforespørselen. |
Tier Qualifier Type |
TierQualifierType__c |
Tekst | Sjiktkvalifikator for hendelsen (for eksempel STANDARD, BASIC, scale, priority, CUSTOM eller NOT_SET). |
| Tidsstempel | Tidsstempel__c | Dato/klokkeslett | Klokkeslettet da målingshendelsen skjedde. |
Usage Type Code |
UsageTypeCode__c |
Tekst | Brukstypen Digital Wallet (for eksempel EmbeddedAI_StandardPrompts, Agentforce_StandardAction eller Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Tall | Mengden forretningsbruksenheter som er registrert for hendelsen. |
Unit Type Code |
UnitTypeCode__c |
Tekst | Innkommende enhetstype for måling (for eksempel ACTION eller generasjoner). |
User Context |
UserContext__c |
Tekst | Kontekst som leveres for målingsvurdering (for eksempel UT:STANDARD og funksjonsflagg). |
User ID |
UserId__c |
Tekst | Salesforce-brukeridentifikator (005-prefiks) for brukeren som er knyttet til hendelsen, hvis tilgjengelig. |
Spørre datamodellen
Du kan kjøre ad hoc-spørringer som trekker ut relevant informasjon fra DMO-et. Data 360 tilbyr flere måter å spørre data på. Se Spørringsdata i Data 360 for å finne ut mer.
Her er noen eksempler på spørringer du kan bruke.
Billbar bruk per agent
Bruk denne spørringen til å identifisere de dyreste agentene. Den oppsummerer totalt antall bruks- og hendelsesantall gruppert etter agentutviklernavn og -type.
SELECT
AgentDeveloperName__c,
AgentTypeCode__c,
SUM(UsageQuantity__c) AS TotalUsage,
COUNT(*) AS EventCount
FROM AiAgentGenerativeAiUsage_std__dlm
WHERE IsBillableIndicator__c = true
AND Timestamp__c >= CURRENT_DATE - 30
GROUP BY AgentDeveloperName__c, AgentTypeCode__c
ORDER BY TotalUsage DESC
Tokenforbruk etter modell
Bruk denne spørringen til å identifisere hvilke modeller som bruker flest tokener. Den aggregerer inndata, fullføring, totalt antall tokener og antall hendelser etter modell-ID, leverandør og klasse.
SELECT
GenAiGatewayModelName__c,
ModelProviderName__c,
ModelClassType__c,
SUM(PromptInputTokenCount__c) AS TotalInputTokens,
SUM(PromptCompletionTokenCount__c) AS TotalCompletionTokens,
SUM(PromptTotalTokenCount__c) AS TotalTokens,
COUNT(*) AS EventCount
FROM AiAgentGenerativeAiUsage_std__dlm
WHERE Timestamp__c >= CURRENT_DATE - 30
GROUP BY GenAiGatewayModelName__c, ModelProviderName__c, ModelClassType__c
ORDER BY TotalTokens DESC
Bruk per kanal
Bruk denne spørringen til å sammenligne bruk på tvers av Voice- og Meldinger-kanaler. Den slår sammen de generative AI-bruk- og økttabellene for å aggregere total bruk og tokener etter kanaltype.
SELECT
s.ssot__AiAgentChannelType__c AS ChannelType,
s.ssot__RelatedMessagingSessionId__c AS MessagingSessionId,
s.ssot__RelatedVoiceCallId__c AS VoiceCallId,
u.AgentDeveloperName__c,
SUM(u.UsageQuantity__c) AS TotalUsage,
SUM(u.PromptTotalTokenCount__c) AS TotalTokens
FROM AiAgentGenerativeAiUsage_std__dlm u
JOIN ssot__AiAgentSession__dlm s
ON u.AiAgentSessionId__c = s.ssot__Id__c
WHERE u.Timestamp__c >= CURRENT_DATE - 30
GROUP BY s.ssot__AiAgentChannelType__c,
s.ssot__RelatedMessagingSessionId__c,
s.ssot__RelatedVoiceCallId__c,
u.AgentDeveloperName__c
ORDER BY TotalUsage DESC
LIMIT 20
Bygge Data 360-rapporter
For å analysere Knowledge/RAG-kvalitetsdata og -målinger bygger du rapporter i Data 360 som henter relevant informasjon fra AiAgentGenerativeAiUsage DMO. Du kan bruke beregnet innsikt til å opprette målinger som kan utløse varsler. Hvis du vil vite mer, kan du se Data 360-rapporter og -kontrollpaneler.

