breadcrumbDescription
Model for genererende AI-anvendelsesdata for AI-agent
Brug DMO (AI Agent Generative AI Usage data model object) til at analysere Agentforce og generative AI-forbrugsmønstre i Data 360.
Om AiAgentGenerativeAiUsage
Hver registrering repræsenterer en enkelt genererende AI-interaktionsbegivenhed, der behandles gennem AI-måletjenesten. Objektet registrerer fakturerings- og måleenhedsbeslutninger fra AI-tjenester (f.eks. LLM Gateway og Agent Reasoner), herunder om interaktionen kan faktureres, anvendelsesmængde, tokenantal og id'er til sporbarhed og revision.
Felter til genererende AI-anvendelse for AI-agent
Følgende tabel viser felter for AI Agent Generative AI Usage DMO (AiAgentGenerativeAiUsage, med udviklernavnet AiAgentGenerativeAiUsageDmo).
| Feltbetegnelse | Feltudviklernavn | Datatype | Beskrivelse |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Tekst | BotDefinition eller agentregistrerings-id (f.eks. et 0Xx-id), når begivenheden er knyttet til en agent. |
Agent Developer Name |
AgentDeveloperName__c |
Tekst | Udviklernavn på agenten, når den er til stede. |
Agent Generative AI Usage ID |
Id__c |
Tekst | Entydigt id for anvendelsesbegivenhedsregistreringen. |
Agent Type Code |
AgentTypeCode__c |
Tekst | Agent på højt niveau eller oplevelsestype (f.eks. EinsteinServiceAgent, AgentforceEmployeeAgent eller NOT_SET for ikke-agent-meddelelsesforløb). |
AI Agent Interaction |
AiAgentInteractionId__c |
Tekst | Identifikator for en enkelt interaktion i en session. |
AI Agent Session |
AiAgentSessionId__c |
Tekst | Sessions-id, der grupperer flere interaktioner i en samtale. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Tekst | Identifikator for det værktøj, der er kaldt af agenten, når det er relevant. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Tekst | Fuldt kvalificeret navn eller målkode for basisværktøjet (f.eks. EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Tekst | Navn på det kaldte værktøj, der er menneskelæseligt eller i skabelontypografi. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Tekst | Salesforce-funktion, der bruges til anmodningen (f.eks. PromptTemplateGenerationsInvocable eller CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Tekst | Model-id i LLM Gateway (f.eks. sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Tekst | Funktionsnavn som repræsenteret i Genererende AI-gateway. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Tekst | Infrastrukturlejer for organisationen (f.eks. core/prod/ plus 18-tegns organisations-id). |
Is Billable
|
IsBillableIndicator__c
|
Boolesk | Om begivenheden skulle være fakturabel for produktfunktionen. |
Is Metered
|
IsMeteredIndicator__c
|
Boolesk | Om begivenheden blev målt og opkrævet (slutmålsbeslutning). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Tekst | Når det er relevant, blev årsagsanvendelsen ikke målt (f.eks. NOT_SKIPPED eller andre produktspecifikke koder). |
Model Class Type |
ModelClassType__c |
Tekst | Modelanvendelsesklasse (f.eks. STANDARD eller BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Tekst | Udbyderspecifik modelnavnsstreng. |
Model Provider Name |
ModelProviderName__c |
Tekst | Udbyder af modellen (f.eks. openai, azureopenai eller Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Tal | Antal fuldførelsestokener, der er returneret. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Tal | Antal inputtokener for meddelelsen. |
Prompt Template |
PromptTemplateIdentifier__c |
Tekst | Id for det meddelelsesdesign, der bruges til skabelonstyrede genereringer. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Tekst | Udviklernavn på meddelelsesskabelonen. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Tal | Meddelelsestokener i alt (input plus fuldførelse), når de rapporteres i aggregering. |
Request Identifier |
RequestIdentifier__c |
Tekst | Entydig identifikator for den specifikke gateway- eller kørselsanmodning. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Tekst | Sporings-id for end-to-end log-korrelation (f.eks. en B3-sporings- eller hex-sporingsværdi). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Tekst | Entydig identifikator for den specifikke gateway- eller kørselsanmodning. |
Tier Qualifier Type |
TierQualifierType__c |
Tekst | Niveaukvalificering for begivenheden (f.eks. STANDARD, BASIC, scale, priority, CUSTOM eller NOT_SET). |
| Tidsstempel | Tidsstempel__c | DateTime | Det tidspunkt, hvor målingsbegivenheden forekom. |
Usage Type Code |
UsageTypeCode__c |
Tekst | Anvendelsestype for Digital Wallet (f.eks. EmbeddedAI_StandardPrompts, Agentforce_StandardAction eller Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Tal | Mængde af forretningsanvendelsesenheder, der er registreret for begivenheden. |
Unit Type Code |
UnitTypeCode__c |
Tekst | Indgående enhedstype til måling (f.eks. ACTION eller generationer). |
User Context |
UserContext__c |
Tekst | Kontekst, der leveres til målevaluering (f.eks. UT:STANDARD og funktionsflag). |
User ID |
UserId__c |
Tekst | Salesforce-bruger-id (005-præfiks) for den bruger, der er tilknyttet begivenheden, når det er tilgængeligt. |
Forespørg på datamodellen
Du kan køre ad hoc-forespørgsler, der henter relevante oplysninger fra DMO. Data 360 tilbyder flere måder, hvorpå du kan forespørge på dine data. Se Forespørgselsdata i Data 360 for at få mere at vide.
Her er nogle eksempelforespørgsler, du kan bruge.
Fakturerbart brug af agent
Brug denne forespørgsel til at identificere de dyreste agenter. Den aggregerer det samlede antal anvendelser og begivenheder grupperet efter agentudviklernavn 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
Tokenforbrug efter model
Brug denne forespørgsel til at identificere, hvilke modeller der forbruger flest tokener. Den aggregerer input, fuldførelse, samlede tokener og begivenhedsantal efter model-id, udbyder 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
Anvendelse efter kanal
Brug denne forespørgsel til at sammenligne anvendelse på tværs af Voice- og Meddelelseskanaler. Den sammenføjer de genererende AI-anvendelses- og sessionstabeller for at aggregere den samlede anvendelse og tokener efter 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
Opbyg Data 360-rapporter
Hvis du vil analysere Knowledge/RAG-kvalitetsdata og -metrikker, skal du opbygge rapporter i Data 360, der trækker relevante oplysninger fra AiAgentGenerativeAiUsage DMO. Du kan bruge beregnede indsigter til at oprette metrikker, der kan udløse advarsler. Hvis du vil vide mere, kan du se Data 360-rapporter og -dashboards.

