Ti trovi qui:
Modello di dati di utilizzo AI generativo degli agenti AI
Utilizzare l'oggetto modello di dati (DMO) Utilizzo AI generativo dell'agente AI per analizzare Agentforce e gli schemi di consumo AI generativi in Data 360.
Informazioni su AiAgentGenerativeAiUsage
Ogni record rappresenta un singolo evento di interazione AI generativo elaborato tramite il servizio di misurazione AI. L'oggetto acquisisce le decisioni di fatturazione e misurazione dai servizi di intelligenza artificiale (ad esempio, Gateway LLM e Agent Reasoner), incluso se l'interazione era fatturabile, la quantità di utilizzo, i conteggi dei token e gli identificatori per la tracciabilità e il controllo.
Campi di utilizzo AI generativi degli agenti AI
Nella tabella seguente sono elencati i campi del DMO Utilizzo AI generativo dell'agente AI (AiAgentGenerativeAiUsage, con il nome sviluppatore AiAgentGenerativeAiUsageDmo).
| Etichetta campo | Nome sviluppatore campo | Tipo di dati | Descrizione |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Testo | Identificatore di record BotDefinition o agente (ad esempio, un ID 0Xx) quando l'evento è associato a un agente. |
Agent Developer Name |
AgentDeveloperName__c |
Testo | Nome sviluppatore dell'agente, se presente. |
Agent Generative AI Usage ID |
Id__c |
Testo | Identificatore univoco del record evento di utilizzo. |
Agent Type Code |
AgentTypeCode__c |
Testo | Agente di alto livello o tipo di esperienza (ad esempio, EinsteinServiceAgent, AgentforceEmployeeAgent o NOT_SET per i flussi prompt non agente). |
AI Agent Interaction |
AiAgentInteractionId__c |
Testo | Identificatore di una singola interazione all'interno di una sessione. |
AI Agent Session |
AiAgentSessionId__c |
Testo | Identificatore di sessione che raggruppa più interazioni in una sola conversazione. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Testo | Identificatore dello strumento invocato dall'agente, se applicabile. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Testo | Nome completo o codice di destinazione dello strumento di base (ad esempio EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Testo | Nome in formato leggibile o in stile modello dello strumento richiamato. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Testo | Funzione di Salesforce utilizzata per la richiesta (ad esempio, PromptTemplateGenerationsInvocable o CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Testo | Identificatore del modello nel gateway LLM (ad esempio, sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Testo | Nome della funzione rappresentato in Gateway AI generativo. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Testo | Tenant dell'infrastruttura per l'organizzazione (ad esempio, core/prod/ più l'ID organizzazione a 18 caratteri). |
Is Billable
|
IsBillableIndicator__c
|
Booleano | Indica se l'evento doveva essere fatturabile per la funzione del prodotto. |
Is Metered
|
IsMeteredIndicator__c
|
Booleano | Se l'evento è stato misurato e addebitato (decisione finale sulla misurazione). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Testo | Se applicabile, il motivo per cui l'utilizzo non è stato misurato (ad esempio, NOT_SKIPPED o altri codici specifici del prodotto). |
Model Class Type |
ModelClassType__c |
Testo | Classe di utilizzo del modello (ad esempio STANDARD o BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Testo | Stringa del nome del modello specifica del provider. |
Model Provider Name |
ModelProviderName__c |
Testo | Fornitore del modello (ad esempio, openai, azureopenai o Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Numero | Conteggio dei token di completamento restituiti. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Numero | Conteggio dei token di input per il prompt. |
Prompt Template |
PromptTemplateIdentifier__c |
Testo | ID della struttura del prompt utilizzata per le generazioni basate su modello. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Testo | Nome sviluppatore del modello di prompt. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Numero | Token prompt totali (input più completamento) se segnalati in aggregazione. |
Request Identifier |
RequestIdentifier__c |
Testo | Identificatore univoco per il gateway o la richiesta di runtime specifica. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Testo | Identificatore di traccia per la correlazione del registro end-to-end (ad esempio, una traccia B3 o un valore di traccia esadecimale). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Testo | Identificatore univoco per il gateway o la richiesta di runtime specifica. |
Tier Qualifier Type |
TierQualifierType__c |
Testo | Qualificatore di livello per l'evento (ad esempio, STANDARD, BASIC, scale, priority, CUSTOM o NOT_SET). |
| Timestamp (Indicazione oraria) | indicazione oraria__c | DateTime | Ora in cui si è verificato l'evento di misurazione. |
Usage Type Code |
UsageTypeCode__c |
Testo | Tipo di utilizzo Digital Wallet (ad esempio, EmbeddedAI_StandardPrompts, Agentforce_StandardAction o Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Numero | Quantità di unità di utilizzo aziendali registrate per l'evento. |
Unit Type Code |
UnitTypeCode__c |
Testo | Tipo di unità in entrata per la misurazione (ad esempio, ACTION o generazioni). |
User Context |
UserContext__c |
Testo | Contesto fornito per la valutazione della misurazione (ad esempio, UT:STANDARD e flag delle funzioni). |
User ID |
UserId__c |
Testo | Identificatore utente Salesforce (prefisso 005) dell'utente associato all'evento, se disponibile. |
Esecuzione di query sul modello di dati
È possibile eseguire query ad hoc che estraggono informazioni pertinenti dal DMO. Data 360 offre diversi modi per eseguire query sui dati. Per ulteriori informazioni, vedere Query sui dati.
Di seguito sono riportati alcuni esempi di query che è possibile utilizzare.
Utilizzo fatturabile per agente
Utilizzare questa query per identificare gli agenti più costosi. Aggrega l'utilizzo totale e i conteggi degli eventi, raggruppati per nome sviluppatore agente e tipo.
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
Consumo token per modello
Utilizzare questa query per identificare i modelli che consumano più token. Aggrega input, completamento, token totali e conteggi eventi per ID modello, provider e classe.
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
Utilizzo per canale
Utilizzare questa query per confrontare l'utilizzo nei canali Voice e Messaggistica. Unisce l'utilizzo generativo dell'intelligenza artificiale e le tabelle di sessione per aggregare l'utilizzo totale e i token per tipo di canale.
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
Creazione di rapporti Data 360
Per analizzare i dati e le metriche di qualità Knowledge/RAG, creare rapporti in Data 360 che estraggono le informazioni pertinenti dal DMO AiAgentGenerativeAiUsage. È possibile utilizzare gli approfondimenti calcolati per creare metriche che possono attivare avvisi. Per ulteriori informazioni, vedere Rapporti e cruscotti digitali

