Du är här:
Datamodell för AI-agentgenerativ AI-användning
Använd datamodellobjektet AI Agent Generative AI Usage (DMO) för att analysera Agentforce och generativa AI-användningsmönster i Data 360.
Om AiAgentGenerativeAiUsage
Varje post representerar en enskild genererande AI-interaktionshändelse som bearbetas genom AI-mättjänsten. En händelse kan vara ett anrop till den stora språkmodellen, eller en agentåtgärd, eller en enskild interaktion. Objektet samlar in beslut om fakturering och mätning från AI-tjänster (till exempel LLM Gateway), inklusive om interaktionen var faktureringsbar, användningskvantitet, tokenantal och identifierare för spårbarhet och granskning.
Användningsfält för AI-agentgenerativ AI
Följande tabell listar fält för DMO för AI Agent Generative AI Usage (AiAgentGenerativeAiUsage, med utvecklarnamnet AiAgentGenerativeAiUsageDmo).
| Fältetikett | Namn på fältutvecklare | Datatyp | Beskrivning |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Text | BotDefinition eller agentpostidentifierare (till exempel ett 0Xx-ID) när händelsen är associerad med en agent. |
Agent Developer Name |
AgentDeveloperName__c |
Text | Agentens utvecklarnamn när det finns. |
Agent Generative AI Usage ID |
Id__c |
Text | Unik identifierare för användningshändelseposten. |
Agent Type Code |
AgentTypeCode__c |
Text | Agent- eller upplevelsetyp på hög nivå (till exempel EinsteinServiceAgent, AgentforceEmployeeAgent eller NOT_SET för uppmaningsflöden som inte är agenter). |
AI Agent Interaction |
AiAgentInteractionId__c |
Text | Identifierare för en enskild interaktion inom en session. |
AI Agent Session |
AiAgentSessionId__c |
Text | Sessionsidentifierare som grupperar flera interaktioner i en konversation. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Text | Identifierare för det verktyg som åberopas av agenten, om tillämpligt. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Text | Fullständigt kvalificerat namn eller målkod för basverktyget (till exempel EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Text | Namn på det åberopade verktyget som är läsbart för människor eller i mallstil. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Text | Salesforce-funktion som används för begäran (till exempel PromptTemplateGenerationsInvocable eller CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Text | Modellidentifierare i LLM Gateway (till exempel sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Text | Funktionsnamn som representeras i Generative AI Gateway. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Text | Organisationens infrastrukturarrendator (till exempel core/prod/ plus organisations-ID på 18 tecken). |
Is Billable
|
IsBillableIndicator__c
|
Boolesk | Om händelsen var avsedd att faktureras för produktfunktionen. |
Is Metered
|
IsMeteredIndicator__c
|
Boolesk | Om händelsen mättes och debiterades (slutgiltigt beslut om mätning). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Text | I tillämpliga fall mättes inte orsaken till användningen (till exempel NOT_SKIPPED eller andra produktspecifika koder). |
Model Class Type |
ModelClassType__c |
Text | Modellanvändningsklass (till exempel STANDARD eller BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Text | Leverantörsspecifik modellnamnsträng. |
Model Provider Name |
ModelProviderName__c |
Text | Leverantör av modellen (till exempel openai, azureopenai eller Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Nummer | Antal returnerade slutförandetokens. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Nummer | Antal indatatokens för uppmaningen. |
Prompt Template |
PromptTemplateIdentifier__c |
Text | ID för uppmaningsdesignen som används för malldrivna generationer. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Text | Utvecklarnamn på uppmaningsmallen. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Nummer | Totalt antal uppmaningstokens (indata plus slutförande) när de rapporteras i aggregering. |
Request Identifier |
RequestIdentifier__c |
Text | Unik identifierare för den specifika gateway- eller runtimebegäran. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Text | Spårningsidentifierare för loggkorrelation från början till slut (till exempel ett B3-spår eller hexspårvärde). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Text | Unik identifierare för den specifika gateway- eller runtimebegäran. |
Tier Qualifier Type |
TierQualifierType__c |
Text | Nivåkvalifierare för händelsen (till exempel STANDARD, BASIC, scale, priority, CUSTOM eller NOT_SET). |
| Tidstämpel | Tidstämpel__c | DateTime | Tid då händelsen för mätning inträffade. |
Usage Type Code |
UsageTypeCode__c |
Text | Användningstyp för Digital Wallet (till exempel EmbeddedAI_StandardPrompts, Agentforce_StandardAction eller Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Nummer | Mängd affärsanvändningsenheter som registrerats för händelsen. |
Unit Type Code |
UnitTypeCode__c |
Text | Inkommande enhetstyp för mätning (till exempel ACTION eller generationer). |
User Context |
UserContext__c |
Text | Sammanhang som tillhandahålls för utvärdering av mätare (till exempel UT:STANDARD och funktionsflaggor). |
User ID |
UserId__c |
Text | Salesforce-användaridentifierare (005-prefix) för användaren som är associerad med händelsen, om tillgängligt. |
Fråga datamodellen
Du kan köra ad hoc-frågor som hämtar relevant information från DMO. Data 360 erbjuder flera sätt att fråga dina data. Se Frågedata i Data 360 för mer information.
Här är några exempel på sökfrågor som du kan använda.
Fakturerbar användning efter agent
Använd denna sökfråga för att identifiera de dyraste agenterna. Den aggregerar totalt antal användningar och händelser, grupperade efter agentens utvecklarnamn och typ.
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
Tokenkonsumtion efter modell
Använd denna sökfråga för att identifiera vilka modeller som konsumerar flest tokens. Den aggregerar indata, slutförande, totala tokens och händelseantal efter modell-ID, leverantör och klass.
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
Användning efter kanal
Använd denna sökfråga för att jämföra användning mellan Voice- och Meddelandekanaler. Den slår samman den generativa AI-användningen och sessionstabellerna för att aggregera total användning och tokens efter kanaltyp.
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
Bygg Data 360-rapporter
För att analysera Knowledge/RAG-kvalitetsdata och -mått, bygg rapporter i Data 360 som hämtar relevant information från AiAgentGenerativeAiUsage DMO. Du kan använda beräknade insikter för att skapa mått som kan utlösa varningar. Mer information finns i Data 360-rapporter och -instrumentpaneler.

