U bent hier:
Gegevensmodel Generatief AI-gebruik van AI-agent
Gebruik het gegevensmodelobject (Data Model Object, DMO) AI Agent Generative AI Usage (AI-agent genererend AI-gebruik) om Agentforce en genererende AI-verbruikspatronen in Data 360 te analyseren.
Info over AiAgentGenerativeAiUsage
Elke record vertegenwoordigt één genererende AI-interactie-event die wordt verwerkt via de AI-meetservice. Een event kan een aanroep zijn naar het large languate-model, een agentactie of één interactie. Het object legt de beslissingen over facturering en metingen vast van AI-services (bijvoorbeeld LLM Gateway), inclusief of de interactie factureerbaar was, gebruikshoeveelheid, tokentellingen en identifiers voor traceerbaarheid en controle.
Velden voor genereren van AI-gebruik door AI-agenten
De volgende tabel vermeldt velden voor het DMO Generatief AI-gebruik van AI-agent (AiAgentGenerativeAiUsage, met de ontwikkelaarsnaam AiAgentGenerativeAiUsageDmo).
| Veldlabel | Naam veldontwikkelaar | Gegevenstype | Beschrijving |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Tekst | BotDefinition of agentrecordidentifier (bijvoorbeeld een 0Xx-ID) wanneer de event is gekoppeld aan een agent. |
Agent Developer Name |
AgentDeveloperName__c |
Tekst | Naam ontwikkelaar van de agent indien aanwezig. |
Agent Generative AI Usage ID |
Id__c |
Tekst | Unieke identifier voor de gebruikseventrecord. |
Agent Type Code |
AgentTypeCode__c |
Tekst | Agent op hoog niveau of type ervaring (bijvoorbeeld EinsteinServiceAgent, AgentforceEmployeeAgent of NOT_SET voor aanwijzingsstromen voor niet-agenten). |
AI Agent Interaction |
AiAgentInteractionId__c |
Tekst | ID voor één interactie binnen een sessie. |
AI Agent Session |
AiAgentSessionId__c |
Tekst | Sessie-identifier die meerdere interacties in één gesprek groepeert. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Tekst | Identifier van de tool die wordt aangeroepen door de agent, indien van toepassing. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Tekst | Volledig gekwalificeerde naam of doelcode voor de basistool (bijvoorbeeld EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Tekst | Voor mensen leesbare of sjabloonachtige naam van de tool die wordt aangeroepen. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Tekst | Salesforce-voorziening die voor het verzoek wordt gebruikt (bijvoorbeeld PromptTemplateGenerationsInvocable of CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Tekst | Modelidentifier in LLM Gateway (bijvoorbeeld sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Tekst | Naam van voorziening zoals weergegeven in Generative AI Gateway. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Tekst | Infrastructuurbelanghebbende voor de organisatie (bijvoorbeeld core/prod/ plus de organisatie-ID van 18 tekens). |
Is Billable
|
IsBillableIndicator__c
|
Booleaans | Of de event was bedoeld om te worden gefactureerd voor de productvoorziening. |
Is Metered
|
IsMeteredIndicator__c
|
Booleaans | Of de event is gemeten en in rekening is gebracht (definitieve beslissing over de meting). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Tekst | Indien van toepassing, de reden waarom het gebruik niet is gemeten (bijvoorbeeld NOT_SKIPPED of andere productspecifieke codes). |
Model Class Type |
ModelClassType__c |
Tekst | Modelgebruiksklasse (bijvoorbeeld STANDARD of BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Tekst | Leverancierspecifieke tekenreeks voor modelnaam. |
Model Provider Name |
ModelProviderName__c |
Tekst | Leverancier van het model (bijvoorbeeld openai, azureopenai of Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Getal | Aantal voltooiingstokens dat is geretourneerd. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Getal | Aantal invoertokens voor de aanwijzing. |
Prompt Template |
PromptTemplateIdentifier__c |
Tekst | ID van het aanwijzingsontwerp dat wordt gebruikt voor sjabloongestuurde generaties. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Tekst | Naam ontwikkelaar van de aanwijzingssjabloon. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Getal | Totale aantal aanwijzingstokens (invoer plus voltooiing) indien geaggregeerd gerapporteerd. |
Request Identifier |
RequestIdentifier__c |
Tekst | Unieke identifier voor de specifieke gateway of run-time aanvraag. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Tekst | Trace-identifier voor end-to-end logboekcorrelatie (bijvoorbeeld een B3-tracering of hexadecimale traceringswaarde). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Tekst | Unieke identifier voor de specifieke gateway of run-time aanvraag. |
Tier Qualifier Type |
TierQualifierType__c |
Tekst | Laagkwalificatie voor de event (bijvoorbeeld STANDARD, BASIC, scale, priority, CUSTOM of NOT_SET). |
| Tijdstempel | Tijdstempel__c | DatumTijd | Tijd waarop de metingsevent zich heeft voorgedaan. |
Usage Type Code |
UsageTypeCode__c |
Tekst | Digital Wallet gebruikstype (bijvoorbeeld EmbeddedAI_StandardPrompts, Agentforce _StandardAction of Agentforce _ VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Getal | Hoeveelheid bedrijfsgebruikseenheden die zijn vastgelegd voor de event. |
Unit Type Code |
UnitTypeCode__c |
Tekst | Type inkomende eenheid voor meting (bijvoorbeeld ACTIE of generaties). |
User Context |
UserContext__c |
Tekst | Context die wordt geleverd voor de evaluatie van metingen (bijvoorbeeld UT:STANDARD en voorzieningsvlaggen). |
User ID |
UserId__c |
Tekst | Salesforce-gebruikers-ID (005-prefix) voor de gebruiker die aan de event is gekoppeld, indien beschikbaar. |
Een query uitvoeren op het gegevensmodel
U kunt ad-hocquery's uitvoeren die relevante informatie ophalen uit het DMO. Data 360 biedt meerdere manieren om een query op uw gegevens uit te voeren. Zie Query uitvoeren op gegevens in Data 360 voor meer informatie.
Hier zijn enkele voorbeeldquery's die u kunt gebruiken.
Factureerbaar gebruik door agent
Gebruik deze query om de duurste agenten te identificeren. Het aggregeert totale aantal gebruiks- en eventtellingen, gegroepeerd op naam en type agentontwikkelaar.
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
Tokenverbruik op model
Gebruik deze query om te bepalen welke modellen de meeste tokens verbruiken. Het aggregeert invoer, voltooiing, totale aantal tokens en eventtellingen op model-ID, provider en 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
Gebruik op kanaal
Gebruik deze query voor het vergelijken van gebruik binnen Voice- en Berichtenverkeerskanalen. Het voegt zich bij de generatieve AI-gebruiks- en sessietabellen om het totale gebruik en de tokens te aggregeren op kanaaltype.
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
Data 360-rapporten samenstellen
Als u Knowledge / RAG-kwaliteitsgegevens en -meetgegevens wilt analyseren, stelt u rapporten samen in Data 360 die relevante informatie ophalen uit het DMO AiAgentGenerativeAiUsage. U kunt berekende insights gebruiken om meetgegevens te maken die waarschuwingen kunnen activeren. Zie Data 360-rapporten en -dashboards voor meer informatie.

