Vous êtes ici :
Compréhension des ID de ressource racine et de ressource
Le modèle de données Digital Wallet inclut deux identifiants clés, « ID de ressource racine ou Nom d'API » et « ID de ressource ou Nom d'API », qui capturent ce qui consomme des crédits dans vos produits basés sur la consommation. Déterminer quand chaque champ est rempli ou reste vide aide à interpréter avec précision les rapports d'utilisation et à identifier les facteurs qui déterminent la consommation.
Pour des exemples de cas d'utilisation, consultez Scénarios de rapport sur les champs de ressource racine et d'ID de ressource.
| Nom du champ | Définition | Exemples |
|---|---|---|
| ID de ressource racine ou nom d'API | Représente la ressource de niveau supérieur qui initie la consommation de crédit. Actuellement, ce champ n'est rempli que lorsque les agents Agentforce initient la consommation. | Agentforce_Employee_Agent_NG, Sales_Agent, Customer_Support_Agent |
| Type de ressource racine | Le type d'objet de la ressource racine. Il permet de classer la ressource initiatrice. | BotDefinition |
| ID de ressource ou nom d'API | Représente la ressource ou l'action spécifique qui a réellement consommé les crédits. Ce champ représente le niveau d'utilisation le plus précis (par exemple une action d'agent, un segment ou un flux de données) et est rempli pour plusieurs événements de facturation. |
|
| Type de ressource | Le type d'objet de la ressource spécifique, qui fournit un contexte supplémentaire sur le type de fonctionnalité consommée par les crédits et l'emplacement de stockage de ses détails. |
|
Pourquoi le champ « ID de ressource racine ou Nom d'API » est-il parfois vide ?
Le champ ID de ressource racine est rempli uniquement lorsqu'un agent Agentforce initie la consommation. Si votre organisation consomme des crédits via des fonctionnalités non-agents, telles que des segments marketing Data 360, des pipelines de données par lot ou des transformations de données, le champ Ressource racine reste vide. Dans ce cas, le segment ou le pipeline est la ressource principale.
Pourquoi le champ « ID de ressource ou Nom d'API » est-il parfois vide ?
Les ressources et leurs types d'utilisation associés, tels que Data 360 Storage ou Real-Time Profile Caching, calculent la consommation au niveau global de l'organisation en utilisant la capacité crête/instantané (agrégation MAX). Par conséquent, aucun ID de ressource ne leur est associé.
Quand les champs ID de ressource racine et ID de ressource sont-ils remplis ?
Les champs Root Resource ID or API Name et Resource ID or
API Name sont remplis lorsque la consommation est déclenchée par un agent qui est une action ou une invite.
Scénarios de rapport pour les champs Ressource racine et ID de ressource
Découvrez le comportement des champs « ID de ressource racine ou Nom d'API » et « ID de ressource ou Nom d'API » dans les scénarios courants, et recherchez des configurations recommandées pour les suivre dans vos rapports.
Agent employé Agentforce
Le scénario : Un employé interagit avec un Agent employé Agentforce pour prendre connaissance des avantages sociaux de l'entreprise. Pour répondre à la demande, l'agent recherche des documents Knowledge, déclenchant une action "Répondre à la question avec Knowledge".
- ID de ressource racine : Nom d'API de l'agent (
Agentforce_Employee_Agent_NG) - Type de ressource racine :
BotDefinition - ID de ressource : Nom d'API de l'action (
AnswerQuestionWithKnowledge_<n>) - Type de ressource :
GenAiFunctionDefinition
Comment élaborer le rapport
| Filtres |
|
| Grouper les lignes |
|
| Colonnes |
|
Dans ce rapport, vous pouvez voir la répartition (par Ressource) de la consommation pour l'Agent Employé Agentforce (Ressource racine).
Segmentation Data Cloud
Le scénario : Une équipe marketing organise un segment Ventes du 4 juillet destiné aux clients de New York pour générer une liste de campagnes par e-mail.
- ID de ressource racine ou nom d'API : Vide (pas la consommation de crédit Flex Agentforce Agent)
- ID de ressource ou Nom d'API : Nom du segment (July_4th_Segment)
- Type de ressource :
MarketSegmentDefinition
Comment élaborer le rapport
Ce rapport est filtré pour afficher uniquement le type d'utilisation Segmentation. Unités consommées indique la somme totale des crédits consommés dans toutes les exécutions de ce segment.
| Filtres |
|
| Grouper les lignes |
|
| Colonnes |
|
Comme le segment n'est pas associé à un agent, il n'est pas nécessaire d'inclure l'ID de ressource racine ou le Nom d'API. Si vous l'incluez en élaborant votre rapport, il est vide.
Ingestion de pipeline de données par lot
Le scénario : Une équipe de compte ingère des lots de données de facture dans Data 360 pour élaborer des profils clients unifiés en utilisant un flux de données appelé « NTO Event Prospect ».
- ID de ressource racine ou nom d'API : Vide (pas la consommation de crédit Flex Agentforce Agent)
- ID de ressource ou Nom d'API : Nom du flux de données (par exemple, NTO_Event_Prospect)
- Type de ressource :
DataStreamDefinition
Comment élaborer le rapport
Le rapport est filtré pour afficher uniquement le type d'utilisation Pipeline de données par lot.
| Filtres |
|
| Grouper les lignes |
|
| Colonnes |
|
Comme le segment n'est pas associé à un agent, il n'est pas nécessaire d'inclure l'ID de ressource racine ou le Nom d'API. Si vous l'incluez en élaborant votre rapport, il est vide.
