위치:
AI 에이전트 생성형 AI 사용 데이터 모델
AI 에이전트 생성형 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 |
텍스트 | 기본 도구에 대한 정규화된 이름 또는 대상 코드입니다(예: EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
텍스트 | 호출된 도구의 사람 읽기 또는 템플릿 스타일 이름입니다. |
Feature Descriptor Name |
FeatureDescriptorName__c |
텍스트 | 요청에 사용되는 Salesforce 기능(예: PromptTemplateGenerationsInvocable 또는 CopilotForDigitalChannels). |
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 추적 또는 16진수 추적 값). |
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 |
텍스트 | 계량을 위한 유입 단위 유형입니다(예: ACTION 또는 Generations). |
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
채널별 사용
이 쿼리를 사용하여 Voice 및 Messaging 채널 전반의 사용량을 비교합니다. 생성형 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 보고서 및 대시보드를 참조하십시오.

