Sie befinden sich hier:
Nutzungsdatenmodell der generativen AI des AI-Agenten
Verwenden Sie das Datenmodellobjekt (DMO) "Generative AI Usage" (Generative AI der generativen AI von AI-Agenten), um die Verbrauchsmuster von Agentforce und generativer AI in Data 360 zu analysieren.
Informationen zu AiAgentGenerativeAiUsage
Jeder Datensatz stellt ein einzelnes Interaktionsereignis mit generativer AI dar, das über den AI Metering Service verarbeitet wird. Das Objekt erfasst die Abrechnungs- und Messentscheidungen von AI-Services (z. B. LLM Gateway und Agent Reasoner), einschließlich der Frage, ob die Interaktion abrechnungsfähig war, der Nutzungsmenge, der Tokenanzahl und der Kennzeichner für die Rückverfolgbarkeit und Überprüfung.
Nutzungsfelder der generativen AI des AI-Agenten
In der folgenden Tabelle sind Felder für das Datenmodellobjekt für die generative AI (AiAgentGenerativeAiUsage) des Agenten mit dem Entwicklernamen AiAgentGenerativeAiUsageDmo aufgeführt.
| Feldbezeichnung | Feldentwicklername | Datentyp | Beschreibung |
|---|---|---|---|
Agent |
AgentIdentifier__c |
Text | BotDefinition oder Agentendatensatzkennzeichner (z. B. eine 0Xx-ID), wenn das Ereignis einem Agenten zugeordnet ist. |
Agent Developer Name |
AgentDeveloperName__c |
Text | Entwicklername des Agenten, sofern vorhanden. |
Agent Generative AI Usage ID |
Id__c |
Text | Eindeutiger Kennzeichner für den Nutzungsereignis-Datensatz. |
Agent Type Code |
AgentTypeCode__c |
Text | Agent oder Erfahrungstyp auf oberster Ebene (z. B. EinsteinServiceAgent, AgentforceEmployeeAgent oder NOT_SET für Aufforderungs-Flows, die keine Agenten sind). |
AI Agent Interaction |
AiAgentInteractionId__c |
Text | Kennzeichner für eine einzelne Interaktion innerhalb einer Sitzung. |
AI Agent Session |
AiAgentSessionId__c |
Text | Sitzungskennzeichner, der mehrere Interaktionen in einer Unterhaltung gruppiert. |
AI Agent Tool Identifier |
AiAgentToolIdentifier__c |
Text | Kennzeichner des vom Agenten aufgerufenen Tools, sofern zutreffend. |
AI Agent Tool Invocation Target Code |
AiAgentToolInvTargetCode__c |
Text | Vollständig qualifizierter Name oder Zielcode für das Basistool (z. B. EmployeeCopilot__IdentifyRecordByName). |
AI Agent Tool Name |
AiAgentToolName__c |
Text | Vom Menschen lesbarer oder vorlagenartiger Name des aufgerufenen Tools. |
Feature Descriptor Name |
FeatureDescriptorName__c |
Text | Die für die Anforderung verwendete Salesforce-Funktion (z. B. PromptTemplateGenerationsInvocable oder CopilotForDigitalChannels). |
Generative AI Gateway Model Name |
GenAiGatewayModelName__c |
Text | Modellkennzeichner im LLM-Gateway (z. B. sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Text | Funktionsname, wie er im Gateway der generativen AI dargestellt ist. |
Infrastructure Tenant Identifier
|
InfraTenantIdentifier__c
|
Text | Infrastruktur-Mandant für die Organisation (z. B. core/prod/ plus die 18-stellige Organisations-ID). |
Is Billable
|
IsBillableIndicator__c
|
Boolean (Boolesch) | Gibt an, ob das Ereignis für die Produktfunktion abgerechnet werden sollte. |
Is Metered
|
IsMeteredIndicator__c
|
Boolean (Boolesch) | Gibt an, ob das Ereignis dosiert und abgerechnet wurde (endgültige Messentscheidung). |
Metering Skip Reason Code |
MeteringSkipReasonCode__c |
Text | Gegebenenfalls wurde die Nutzung nicht gemessen (z. B. NOT_SKIPPED oder andere produktspezifische Codes). |
Model Class Type |
ModelClassType__c |
Text | Modellnutzungsklasse (z. B. STANDARD oder BASIC). |
Model Provider Model Name |
ModelProviderModelName__c |
Text | Anbieterspezifische Modellnamenszeichenfolge. |
Model Provider Name |
ModelProviderName__c |
Text | Anbieter des Modells (z. B. openai, azureopenai oder Open AI). |
Prompt Completion Token Count |
PromptCompletionTokenCount__c |
Number (Zahl) | Anzahl der zurückgegebenen Fertigstellungstoken. |
Prompt Input Token Count |
PromptInputTokenCount__c |
Number (Zahl) | Anzahl der Eingabetoken für die Eingabeaufforderung. |
Prompt Template |
PromptTemplateIdentifier__c |
Text | ID des Eingabeaufforderungsdesigns, das für vorlagengesteuerte Generierungen verwendet wird. |
Prompt Template Developer Name |
PromptTemplateDeveloperName__c |
Text | Entwicklername der Aufforderungsvorlage. |
Prompt Total Token Count |
PromptTotalTokenCount__c |
Number (Zahl) | Gesamtzahl der Eingabeaufforderungstoken (Eingabe plus Abschluss), wenn sie in aggregierter Form gemeldet werden. |
Request Identifier |
RequestIdentifier__c |
Text | Eindeutiger Kennzeichner für das spezifische Gateway oder die Laufzeitanforderung. |
Telemetry Trace
|
TelemetryTraceIdentifier__c
|
Text | Verfolgungskennzeichner für die durchgängige Protokollkorrelation (z. B. B3-Verfolgung oder Hexadezimalwert). |
Telemetry Trace Span
|
TelemetryTraceSpanId__c
|
Text | Eindeutiger Kennzeichner für das spezifische Gateway oder die Laufzeitanforderung. |
Tier Qualifier Type |
TierQualifierType__c |
Text | Stufenqualifizierer für das Ereignis (z. B. STANDARD, BASIC, scale, priority, CUSTOM oder NOT_SET). |
| Timestamp (Zeitstempel) | Zeitstempel__c | Datum/Uhrzeit | Uhrzeit, zu der das Dosierereignis aufgetreten ist. |
Usage Type Code |
UsageTypeCode__c |
Text | Nutzungstyp "Digital Wallet" (z. B. EmbeddedAI_StandardPrompts, Agentforce_StandardAction oder Agentforce_VoiceCustomAction). |
Usage Quantity
|
UsageQuantity__c
|
Number (Zahl) | Menge der für das Ereignis aufgezeichneten Geschäftsnutzungseinheiten. |
Unit Type Code |
UnitTypeCode__c |
Text | Eingehender Einheitentyp für die Messung (z. B. AKTION oder Generierungen). |
User Context |
UserContext__c |
Text | Kontext, der für die Messwertauswertung bereitgestellt wird (z. B. UT:STANDARD und Funktionskennzeichnungen). |
User ID |
UserId__c |
Text | Salesforce-Benutzerkennzeichner (005-Präfix) für den mit dem Ereignis verknüpften Benutzer, sofern verfügbar. |
Abfragen des Datenmodells
Sie können Ad-hoc-Abfragen ausführen, die relevante Informationen aus dem Datenmodellobjekt abrufen. Data 360 bietet mehrere Möglichkeiten zum Abfragen Ihrer Daten. Weitere Informationen finden Sie unter Abfragen von Daten in Data 360.
Im Folgenden finden Sie einige Beispielabfragen, die Sie verwenden können.
Abrechnungsfähige Nutzung nach Agent
Verwenden Sie diese Abfrage, um die teuersten Agenten zu ermitteln. Sie aggregiert die Gesamtnutzung und die Ereignisanzahl, gruppiert nach Name und Typ des Agentenentwicklers.
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
Tokenverbrauch nach Modell
Verwenden Sie diese Abfrage, um zu ermitteln, welche Modelle die meisten Token verwenden. Sie aggregiert Eingabe-, Vervollständigungs-, Gesamttoken- und Ereigniszahlen nach Modell-ID, Anbieter und Klasse.
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
Nutzung nach Kanal
Verwenden Sie diese Abfrage, um die Nutzung in Voice- und Messaging-Kanälen zu vergleichen. Sie verbindet die Nutzung der generativen AI und Sitzungstabellen, um die Gesamtnutzung und die Token nach Kanaltyp zu aggregieren.
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
Erstellen von Data 360-Berichten
Erstellen Sie zum Analysieren der Knowledge/RAG-Qualitätsdaten und Kennzahlen Berichte in Data 360, die relevante Informationen aus dem AiAgentGenerativeAiUsage-DMO abrufen. Sie können berechnete Statistiken verwenden, um Kennzahlen zu erstellen, die Warnungen auslösen können. Weitere Informationen finden Sie unter Data 360-Berichte und -Dashboards.

