您在此处:
AI 客服人员生成式 AI 使用数据模型
使用 AI Agent 生成式 AI 使用情况数据模型对象 (DMO) 分析 Data 360 中的 Agentforce 和生成式 AI 消耗模式。
关于 AiAgentGenerativeAiUsage
每个记录代表通过 AI 计量服务处理的单个生成式 AI 交互事件。该对象从 AI 服务(例如,LLM 网关和客服人员原因)捕获计费和计量决策,包括交互是否可计费、使用数量、令牌计数以及用于跟踪和审计的标识符。
AI 客服人员生成式 AI 使用字段
下表列出了 AI 客服人员生成式 AI 使用情况 DMO 的字段(AiAgentGenerativeAiUsage,带有开发人员姓名 AiAgentGenerativeAiUsageDmo)。
| 字段标签 | 字段开发人员姓名 | 数据类型 | 说明 |
|---|---|---|---|
Agent |
AgentIdentifier__c |
文本 | 事件与客服人员关联时的 BotDefinition 或客服人员记录标识符(例如,0Xx ID)。 |
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 |
文本 | 基本工具的完全限定名称或目标代码(例如,employeeCo pilot__IdentifyRecordByName)。 |
AI Agent Tool Name |
AiAgentToolName__c |
文本 | 调用的工具的可读或模板样式名称。 |
Feature Descriptor Name |
FeatureDescriptorName__c |
文本 | 用于请求的 Salesforce 功能(例如,PromptTemplateGenerationsInvocable 或 Co PilotForDigitalChannels)。 |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
文本 | LLM 网关中的模型标识符(例如,sfdc_ai__DefaultOpenAIGPT4Omni)。 |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
文本 | 生成式 AI 网关中表示的功能名称。 |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
文本 | 组织的基础架构租户(例如,core/prod/ 加上 18 个字符的组织 ID)。 |
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 |
文本 | 用于模板驱动生成的提示设计的 ID。 |
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)。 |
| 时间戳 | 时间戳__c | 日期时间 | 计量事件发生的时间。 |
Usage Type Code |
UsageTypeCode__c |
文本 | Digital Wallet 使用类型(例如,EmbeddedAI_StandardPrompts、Agentforce_StandardAction 或 Agentforce_VoiceCustomAction)。 |
Usage Quantity
|
UsageQuantity__c
|
数字 | 为事件记录的业务使用单位数量。 |
Unit Type Code |
UnitTypeCode__c |
文本 | 用于计量的传入单位类型(例如,操作或生成)。 |
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
按型号划分的令牌消耗
使用此查询来确定哪些模型消耗了最多的令牌。它按模型 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
按渠道使用
使用此查询比较语音和消息传递渠道的使用情况。它连接生成式 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 报表和仪表板。

