Modèle de données d'utilisation de l'IA générative des agents IA

À propos de AiAgentGenerativeAiUsage

Chaque enregistrement représente un événement d'interaction IA générative unique traité via le Service de mesure IA. L'objet capture les décisions de facturation et de mesure des services IA (par exemple, passerelle LLM et raisonneur de l'agent), notamment si l'interaction était facturable, la quantité utilisée, le nombre de jetons et les identifiants de traçabilité et d'audit.

Champs d'utilisation de l'IA générative des agents IA

Le tableau ci-dessous répertorie les champs de l'objet modèle de données Utilisation de l'IA générative de l'agent IA (AiAgentGenerativeAiUsage, avec le nom de développeur AiAgentGenerativeAiUsageDmo).

Interrogation du modèle de données

Vous pouvez exécuter des requêtes ad hoc qui extraient des informations pertinentes de l'objet modèle de données. Data 360 offre plusieurs méthodes pour interroger vos données. Consultez Interrogation des données dans Data 360 pour plus d'informations.

Voici quelques exemples de requêtes que vous pouvez utiliser.

Utilisation facturable par un agent

Utilisez cette requête pour identifier les agents les plus chers. Il agrège l'utilisation totale et le nombre d'événements, regroupés par nom et type de développeur agent.

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

Consommation de jetons par modèle

Utilisez cette requête pour identifier les modèles qui consomment le plus grand nombre de jetons. Il agrège l'entrée, la réalisation, le nombre total de jetons et le nombre d'événements par ID de modèle, fournisseur et 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
    

Utilisation par canal

Utilisez cette requête pour comparer l'utilisation entre les canaux Voice et Messagerie. Il joint les tableaux d'utilisation et de session de l'IA générative pour agréger l'utilisation totale et les jetons par type 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

Élaboration de rapports Data 360

Pour analyser les données et les métriques de qualité Knowledge/RAG, élaborez dans Data 360 des rapports qui extraient des informations pertinentes de l'objet modèle de données AiAgentGenerativeAiUsage. Vous pouvez utiliser des connaissances calculées pour créer des métriques qui peuvent déclencher des alertes. Pour plus d'informations, consultez Rapports et tableaux de bord Data 360.