Вы находитесь здесь:
Модель данных генерирующего использования искусственного интеллекта агента
Используйте объект модели данных (DMO) «Использование генеративного искусственного интеллекта» Agentforce и генеративные схемы потребления искусственного интеллекта в Data 360.
Общие сведения об использовании AiAgentGenerativeAiUsage
Каждая запись представляет одно генеративное событие взаимодействия на основе искусственного интеллекта, обработанное посредством службы учета на основе искусственного интеллекта. Объект собирает решения по выставлению счетов и измерению в службах искусственного интеллекта (например, шлюз LLM и причина агента), включительно с оплатой взаимодействия, количеством использования, количеством маркеров и идентификаторами для отслеживания и аудита.
Поля использования генерирующего искусственного интеллекта агента
Следующая таблица содержит поля для 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 (например, sfdc_ai__DefaultOpenAIGPT4Omni). |
Generative Gateway Feature Name |
GenAiGatewayFeatureName__c |
Текст | Имя функции, представленное в Шлюзе генерирующего искусственного интеллекта. |
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 |
Текст | Определитель уровня для события (например, СТАНДАРТ, БАЗОВЫЙ, шкала, приоритет, НАСТРАИВАЕМЫЙ или NOT_SET). |
| Timestamp | Временная отметка__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
Потребление маркера по модели
Используйте этот запрос для определения моделей, использующих больше всего маркеров. Он агрегирует ввод, завершение, общее количество маркеров и количество событий по коду модели, поставщику и классу.
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 и службы сообщений. Он присоединяется к генеративным таблицам использования искусственного интеллекта и сеансов для агрегации общего использования и маркеров по типу канала.
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, которые извлекают актуальные сведения из DMO AiAgentGenerativeAiUsage. Вы можете использовать вычисленные важные данные для создания показателей, которые могут инициировать предупреждения. Дополнительные сведения см. в разделе «Отчеты и панели мониторинга Data 360».

