Você está aqui:
Entender os IDs de recurso e recurso raiz
O modelo de dados Digital Wallet inclui dois identificadores-chave, “ID do recurso raiz ou nome da API” e “ID do recurso ou nome da API”, que capturam o que consome créditos em seus produtos baseados em consumo. Saber quando cada campo é preenchido ou permanece vazio ajuda a interpretar com precisão os relatórios de uso e identificar o que está gerando consumo.
Consulte Cenários de relatório para campos de Recurso raiz e ID do recurso para exemplos de casos de uso.
| Nome do campo | Definição | Exemplos |
|---|---|---|
| ID do recurso raiz ou nome da API | Representa o recurso de nível superior que inicia o consumo de crédito. No momento, esse campo é preenchido apenas quando os agentes do Agentforce iniciam o consumo. | Agentforce_Employee_Agent_NG, Sales_Agent, Customer_Support_Agent |
| Tipo de recurso raiz | O tipo de objeto do recurso raiz. Ajuda a classificar o recurso responsável pelo início. | BotDefinition |
| ID do recurso ou nome da API | Representa o recurso ou ação específica que de fato consumiu os créditos. Esse campo representa o nível de uso mais granular (como uma ação do agente, um segmento ou um fluxo de dados) e é preenchido para vários eventos de faturamento. |
|
| Resource Type | O tipo de objeto do recurso específico, que fornece contexto adicional sobre o tipo de recurso que os créditos consumiram e onde seus detalhes são armazenados. |
|
Por que o campo "ID do recurso raiz ou nome da API" às vezes está vazio?
O campo ID do recurso raiz é preenchido apenas quando um agente Agentforce inicia o consumo. Se a sua organização estiver consumindo créditos por meio de recursos não agentes, como segmentos de marketing do Data 360, pipelines de dados em lote ou transformações de dados, o campo Recurso raiz permanecerá vazio. Nesses casos, o segmento ou pipeline é o recurso principal.
Por que o campo "ID do recurso ou nome da API" às vezes está vazio?
Os recursos e seus tipos de uso associados, como Armazenamento do Data 360 ou Armazenamento em cache de perfil em tempo real, calculam o consumo no nível geral da organização usando a capacidade de pico/snapshot (agregação MAX). Portanto, eles não têm um ID de Recurso associado a eles.
Quando os campos ID do recurso raiz e ID do recurso são preenchidos?
Você vê os campos Root Resource ID or API Name e Resource ID or
API Name preenchidos quando o consumo é acionado por um agente que é uma ação ou um aviso.
Cenários de relatório para campos de ID do recurso e recurso raiz
Aprenda como os campos "ID do recurso raiz ou Nome da API" e "ID do recurso ou Nome da API" se comportam em cenários comuns e encontrem configurações recomendadas para rastreá-los em seus relatórios.
Agente de funcionários da Agentforce
O cenário: Um funcionário interage com um agente de funcionários do Agentforce para saber mais sobre os benefícios da empresa. Para responder à pergunta, o agente pesquisa documentos do Knowledge, acionando uma ação "Responder pergunta com Knowledge".
- ID do recurso raiz: Nome da API do agente (
Agentforce_Employee_Agent_NG) - Tipo de recurso raiz:
BotDefinition - ID do recurso: Nome da API de ação (
AnswerQuestionWithKnowledge_<n>) - Tipo de recurso:
GenAiFunctionDefinition
Como criar o relatório
| Filtros |
|
| Agrupar linhas |
|
| Colunas |
|
Neste relatório, você pode ver o detalhamento (por Recurso) do consumo para o Agente do funcionário do Agentforce (Recurso raiz).
Segmentação do Data Cloud
O cenário: Uma equipe de marketing executa um segmento de Vendas de 4 de julho direcionado a clientes de Nova York para gerar uma lista de campanha por email.
- ID do recurso raiz ou Nome da API: Vazio (não o consumo de Crédito Flex do agente Agentforce)
- ID do recurso ou Nome da API: Nome do segmento (July_4th_Segment)
- Tipo de recurso:
MarketSegmentDefinition
Como criar o relatório
Esse relatório é filtrado para mostrar apenas o tipo de uso de Segmentação. Unidades consumidas indica a soma total de créditos consumidos em todas as execuções desse segmento.
| Filtros |
|
| Agrupar linhas |
|
| Colunas |
|
Como o segmento não está relacionado a um agente, não é necessário incluir o ID do recurso raiz ou o Nome da API. Se você incluí-lo ao criar seu relatório, ele estará vazio.
Ingestão do pipeline de dados em lote
O cenário: Uma equipe de conta ingere lotes de dados de fatura no Data 360 para criar perfis de cliente unificados usando um fluxo de dados chamado "Cliente potencial de evento NTO".
- ID do recurso raiz ou Nome da API: Vazio (não o consumo de Crédito Flex do agente Agentforce)
- ID do recurso ou Nome da API: Nome do fluxo de dados (por exemplo, NTO_Event_Prospect)
- Tipo de recurso:
DataStreamDefinition
Como criar o relatório
O relatório é filtrado para mostrar apenas o tipo de uso de Funil de dados em lote.
| Filtros |
|
| Agrupar linhas |
|
| Colunas |
|
Como o segmento não está relacionado a um agente, não é necessário incluir o ID do recurso raiz ou o Nome da API. Se você incluí-lo ao criar seu relatório, ele estará vazio.
