Modelo de dados de uso de IA generativa do agente de IA

Sobre AiAgentGenerativeAiUsage

Cada registro representa um único evento de interação de IA generativa processado por meio do Serviço de métrica de IA. O objeto captura as decisões de faturamento e medição de serviços de IA (por exemplo, Gateway do LLM e Reasonador do agente), incluindo se a interação era faturável, quantidade de uso, contagens de token e identificadores para rastreabilidade e auditoria.

Campos de uso de IA generativa do agente de IA

A tabela a seguir lista os campos para o DMO de Uso generativo de IA do agente de IA (AiAgentGenerativeAiUsage, com o nome do desenvolvedor AiAgentGenerativeAiUsageDmo).

Consultar o modelo de dados

Você pode executar consultas ad hoc que capturam informações relevantes do DMO. O Data 360 oferece várias maneiras de consultar seus dados. Consulte Dados de consulta no Data 360 para saber mais.

Aqui estão alguns exemplos de consultas que você pode usar.

Uso faturável por agente

Use essa consulta para identificar os agentes mais caros. Ele agrega o total de contagens de uso e evento, agrupadas por nome e tipo de desenvolvedor do 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 token por modelo

Use essa consulta para identificar quais modelos consomem mais tokens. Ele agrega entradas, conclusões, totais de tokens e contagens de eventos por ID do modelo, provedor 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
    

Uso por canal

Use essa consulta para comparar o uso entre canais do Voice e do Messaging. Ele une o uso de IA generativa e as tabelas de sessão para agregar o uso total e os 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

Criar relatórios do Data 360

Para analisar dados e métricas de qualidade do Knowledge/RAG, crie relatórios no Data 360 que extraem informações relevantes do DMO de AiAgentGenerativeAiUsage. Você pode usar percepções calculadas para criar métricas que podem acionar alertas. Para saber mais, consulte Relatórios e painéis do Data 360.