AI エージェント生成 AI 利用状況データモデル

AiAgentGenerativeAiUsage について

各レコードは、AI 測定サービスを介して処理される 1 つの生成 AI インタラクションイベントを表します。イベントは、大規模言語モデルへのコール、エージェントアクション、または 1 つのインタラクションです。オブジェクトは、AI サービス (LLM ゲートウェイなど) から請求と測定に関する決定を取得します。これには、インタラクションが請求可能だったかどうか、使用量、トークン数、トレーサビリティと監査の識別子が含まれます。

AI エージェントの生成 AI 利用状況項目

次の表は、AI エージェント生成 AI 利用状況 DMO (AiAgentGenerativeAiUsage、開発者名AiAgentGenerativeAiUsageDmo) の項目のリストです。

データモデルの照会

DMO から関連情報を取り込むアドホッククエリを実行できます。Data 360 では、データを照会する方法が複数用意されています。詳細は、「Query Data in Data 360」を参照してください。

使用できるクエリの例を次に示します。

Billable Usage by 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

モデル別のトークン消費

このクエリを使用して、最も多くのトークンを消費しているモデルを特定します。モデル ID、プロバイダー、クラス別に入力、完了、合計トークン、イベント数が集計されます。

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
    

Usage by Channel (チャネル別の利用状況)

次のクエリを使用して、音声チャネルとメッセージングチャネルの利用状況を比較します。生成 AI 使用状況テーブルとセッションテーブルを結合して、チャネル種別ごとに合計使用状況とトークンを集計します。

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

Data 360 レポートの作成

Knowledge/RAG品質データと総計値を分析するには、Data 360でAiAgentGenerativeAiUsage DMOから関連情報を取り込むレポートを作成します。計算済みインサイトを使用して、アラートをトリガーできる総計値を作成できます。詳細は、「Data 360 Reports and Dashboards」を参照してください。