您位於此處:
AI 工作人員生成式 AI 用量資料模型
使用「AI 工作人員生成式 AI 用量」資料模型物件 (DMO) 分析 Data 360 中的 Agentforce 和生成式 AI 耗用模式。
關於 AiAgentGenerativeAiUsage
每個記錄皆代表透過 AI 計量服務處理的單一生成式 AI 互動事件。物件會從 AI 服務 (例如 LLM Gateway 和「工作人員原因者」) 捕捉帳單與計量決策,包括互動是否為可計費、用量數量、權杖計數,以及可追溯性和稽核的識別碼。
AI 工作人員生成式 AI 用量欄位
下表列出「AI 工作人員生成式 AI 用量 DMO」(AiAgentGenerativeAiUsage,開發人員名稱為 AiAgentGenerativeAiUsageDmo) 的欄位。
| 欄位標籤 | 現場開發人員名稱 | 資料類型 | 描述 |
|---|---|---|---|
Agent |
AgentIdentifier__c |
文字 | 事件與工作人員相關聯時,BotDefinition 或工作人員記錄識別碼 (例如 0Xx 識別碼)。 |
Agent Developer Name |
AgentDeveloperName__c |
文字 | 現時工作人員的開發人員名稱。 |
Agent Generative AI Usage ID |
Id__c |
文字 | 用量事件記錄的唯一識別碼。 |
Agent Type Code |
AgentTypeCode__c |
文字 | 高層級工作人員或體驗類型 (例如,EinsteinServiceAgent、AgentforceEmployeeAgent 或 NOT_SET 用於非工作人員提示流程)。 |
AI Agent Interaction |
AiAgentInteractionId__c |
文字 | 工作階段內單一互動的識別碼。 |
AI Agent Session |
AiAgentSessionId__c |
文字 | 在一個對話中將多個互動分組的工作階段識別碼。 |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
文字 | 工作人員叫用的工具識別碼 (若適用)。 |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
文字 | 基本工具的完全合格名稱或目標代碼 (例如,EmployeeCopilot__IdentifyRecordByName)。 |
AI Agent Tool Name |
AiAgentToolName__c |
文字 | 叫用工具的人類可讀取或範本樣式的名稱。 |
Feature Descriptor Name |
FeatureDescriptorName__c |
文字 | 用於要求的 Salesforce 功能 (例如 PromptTemplateGenerationsInvocable 或 CopilotForDigitalChannels)。 |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
文字 | LLM Gateway 中的模型識別碼 (例如 sfdc_ai__DefaultOpenAIGPT4Omni)。 |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
文字 | 如生成式 AI Gateway 中所代表的功能名稱。 |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
文字 | 組織的基礎結構租戶 (例如 core/prod/ 加上 18 個字元的組織識別碼)。 |
Is Billable
|
IsBillableIndicator__c
|
布林值 | 事件是否應針對產品功能計費。 |
Is Metered
|
IsMeteredIndicator__c
|
布林值 | 事件是否計量且已收費 (最終計量決策)。 |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
文字 | 若適用,則未計量原因使用量 (例如 NOT_SKIPPED 或其他產品特定代碼)。 |
Model Class Type |
ModelClassType__c |
文字 | 模型使用類別 (例如,STANDARD 或 BASIC)。 |
Model Provider Model Name |
ModelProviderModelName__c |
文字 | 提供者特定的模型名稱字串。 |
Model Provider Name |
ModelProviderName__c |
文字 | 模型的提供者 (例如 openai、azureopenai 或 Open AI)。 |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
數字 | 傳回的完成權杖計數。 |
Prompt Input Token Count |
PromptInputTokenCount__c |
數字 | 提示的輸入權杖計數。 |
Prompt Template |
PromptTemplateIdentifier__c |
文字 | 用於範本驅動產生的提示設計識別碼。 |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
文字 | 提示範本的開發人員名稱。 |
Prompt Total Token Count |
PromptTotalTokenCount__c |
數字 | 摘要報告時的提示權杖總數 (輸入加上完成)。 |
Request Identifier |
RequestIdentifier__c |
文字 | 特定門戶或執行階段要求的唯一識別碼。 |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
文字 | 端對端記錄關聯的追蹤識別碼 (例如 B3 追蹤或十六進位追蹤值)。 |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
文字 | 特定門戶或執行階段要求的唯一識別碼。 |
Tier Qualifier Type |
TierQualifierType__c |
文字 | 事件的層級限定詞 (例如,STANDARD、BASIC、scale、priority、CUSTOM 或 NOT_SET)。 |
| 時間戳記 | Timestamp__c | DateTime | 計量事件發生的時間。 |
Usage Type Code |
UsageTypeCode__c |
文字 | Digital Wallet 使用類型 (例如 EmbeddedAI_StandardPrompts、Agentforce_StandardAction 或 Agentforce_VoiceCustomAction)。 |
Usage Quantity
|
UsageQuantity__c
|
數字 | 針對事件記錄的業務使用單位數量。 |
Unit Type Code |
UnitTypeCode__c |
文字 | 計量的傳入單位類型 (例如,ACTION 或產生)。 |
User Context |
UserContext__c |
文字 | 提供用於計量評估的內容 (例如 UT:STANDARD 和功能標記)。 |
User ID |
UserId__c |
文字 | 與事件相關聯的使用者其 Salesforce 使用者識別碼 (005 字首) (若有的話)。 |
查詢資料模型
您可以執行臨時查詢,從 DMO 提取相關資訊。Data 360 提供多種方法可查詢您的資料。請參閱 Data 360 中的 查詢資料以深入瞭解。
以下是您可以使用的一些範例查詢。
依工作人員的可計費用量
使用此查詢可識別最昂貴的工作人員。它會彙總用量總數和事件計數,依工作人員開發人員名稱和類型分組。
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
依模型的權杖消耗量
使用此查詢可識別耗用最多權杖的模型。它會依模型識別碼、提供者和類別彙總輸入、完成、權杖總數和事件計數。
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
依管道的使用量
使用此查詢比較「語音」和「傳訊」管道的使用狀況。它會聯結生成式 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 報告和顯示面板。

