Usted está aquí:
Modelo de datos de uso de IA generativa de agente de IA
Utilice el objeto de modelo de datos (DMO) Uso de IA generativa de agente de IA para analizar Agentforce y patrones de consumo de IA generativa en Data 360.
Acerca de AiAgentGenerativeAiUsage
Cada registro representa un único evento de interacción de IA generativa procesado a través del Servicio de medición de IA. El objeto captura las decisiones de facturación y medición de servicios de IA (por ejemplo, Pasarela LLM y Razón de agente), incluyendo si la interacción era facturable, cantidad de uso, conteos de tokens e identificadores para la trazabilidad y la auditoría.
Campos de uso de IA generativa de agente de IA
La siguiente tabla enumera campos para el DMO de uso de IA generativa de agente de IA (AiAgentGenerativeAiUsage, con el nombre de desarrollador AiAgentGenerativeAiUsageDmo).
| Etiqueta de campo | Nombre de desarrollador de campo | Tipo de datos | Descripción |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Texto | BotDefinition o identificador de registro de agente (por ejemplo, un Id. 0Xx) cuando el evento está asociado con un agente. |
Agent Developer Name |
AgentDeveloperName__c |
Texto | Nombre del desarrollador del agente cuando está presente. |
Agent Generative AI Usage ID |
Id__c |
Texto | Identificador exclusivo para el registro de evento de uso. |
Agent Type Code |
AgentTypeCode__c |
Texto | Tipo de agente o experiencia de alto nivel (por ejemplo, EinsteinServiceAgent, AgentforceEmployeeAgent o NOT_SET para flujos de solicitudes que no son de agentes). |
AI Agent Interaction |
AiAgentInteractionId__c |
Texto | Identificador para una única interacción en una sesión. |
AI Agent Session |
AiAgentSessionId__c |
Texto | Identificador de sesión que agrupa múltiples interacciones en una plática. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Texto | Identificador de la herramienta invocada por el agente, cuando corresponda. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Texto | Nombre completamente cualificado o código de destino para la herramienta base (por ejemplo, EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Texto | Nombre legible o de estilo plantilla de la herramienta invocada. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Texto | Función de Salesforce utilizada para la solicitud (por ejemplo, PromptTemplateGenerationsInvocable o CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Texto | Identificador de modelo en pasarela LLM (por ejemplo, sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Texto | Nombre de función como se representa en Pasarela de IA generativa. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Texto | Arrendatario de infraestructura para la organización (por ejemplo, core/prod/ más el Id. de organización de 18 caracteres). |
Is Billable
|
IsBillableIndicator__c
|
Booleano | Si el evento estaba pensado para ser facturable para la función de producto. |
Is Metered
|
IsMeteredIndicator__c
|
Booleano | Si el evento se midió y se cargó (decisión de medición final). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Texto | Cuando sea aplicable, el motivo por el que no se midió el uso (por ejemplo, NOT_SKIPPED u otros códigos específicos de productos). |
Model Class Type |
ModelClassType__c |
Texto | Clase de uso de modelo (por ejemplo, STANDARD o BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Texto | Cadena de nombre de modelo específica del proveedor. |
Model Provider Name |
ModelProviderName__c |
Texto | Proveedor del modelo (por ejemplo, openai, azureopenai o Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Número | Conteo de tokens de finalización devueltos. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Número | Conteo de tokens de entrada para la solicitud. |
Prompt Template |
PromptTemplateIdentifier__c |
Texto | Id. del diseño de solicitud utilizado para generaciones dirigidas por plantillas. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Texto | Nombre de desarrollador de la plantilla de solicitud. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Número | Total de tokens de solicitud (entrada más finalización) cuando se reporta en conjunto. |
Request Identifier |
RequestIdentifier__c |
Texto | Identificador exclusivo para la pasarela específica o la solicitud de tiempo de ejecución. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Texto | Identificador de rastreo para correlación de registro de extremo a extremo (por ejemplo, un valor de rastreo B3 o rastreo hexadecimal). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Texto | Identificador exclusivo para la pasarela específica o la solicitud de tiempo de ejecución. |
Tier Qualifier Type |
TierQualifierType__c |
Texto | Calificador de nivel para el evento (por ejemplo, STANDARD, BASIC, scale, priority, CUSTOM o NOT_SET). |
| Timestamp (Marca de tiempo) | Marca de hora__c | Fecha y hora | Hora en la que se produjo el evento de medición. |
Usage Type Code |
UsageTypeCode__c |
Texto | Tipo de uso Digital Wallet (por ejemplo, EmbeddedAI_StandardPrompts, Agentforce_StandardAction o Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Número | Cantidad de unidades de uso de negocio registradas para el evento. |
Unit Type Code |
UnitTypeCode__c |
Texto | Tipo de unidad entrante para la medición (por ejemplo, ACCIÓN o generaciones). |
User Context |
UserContext__c |
Texto | Contexto proporcionado para la evaluación de mediciones (por ejemplo, UT:STANDARD e indicadores de funciones). |
User ID |
UserId__c |
Texto | Identificador de usuario de Salesforce (prefijo 005) para el usuario asociado con el evento, cuando esté disponible. |
Consultar el modelo de datos
Puede ejecutar consultas ad hoc que extraen información relevante del DMO. Data 360 ofrece múltiples formas de consultar sus datos. Consulte Consultar datos en Data 360 para obtener más información.
Estas son algunas consultas de ejemplo que puede utilizar.
Uso facturable por agente
Utilice esta consulta para identificar los agentes más caros. Agrega el uso total y los conteos de eventos, agrupados por nombre y tipo de desarrollador de agente.
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 de tokens por modelo
Utilice esta consulta para identificar qué modelos consumen más tokens. Agrega entradas, finalización, tokens totales y conteos de eventos por Id. de modelo, proveedor y clase.
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
Uso por canal
Utilice esta consulta para comparar el uso entre canales de Voice y Mensajería. Une el uso de IA generativa y las tablas de sesiones para agregar el uso total y los tokens por tipo de canal.
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
Crear reportes de Data 360
Para analizar datos y mediciones de calidad de Knowledge / RAG, cree reportes en Data 360 que extraen información relevante del DMO de AiAgentGenerativeAiUsage. Puede utilizar perspectivas calculadas para crear mediciones que pueden desencadenar alertas. Para obtener más información, consulte Reportes y tableros Data 360.

