Traçage de la plate-forme de l'agent

Configuration du traçage de la plate-forme de l'agent

Pour générer des rapports Data 360 pour les Traces de session et de plate-forme, les utilisateurs doivent au préalable activer Data 360 et le Traçage de plate-forme.

1. Dans Configuration, utilisez la case Recherche rapide pour rechercher IA générative Einstein.
2. Dans IA générative Einstein, cliquez sur Einstein Audit, Analytics, and Monitoring Setup.
3. Vérifiez que le Traçage des sessions Agentforce est activé. Consultez Configuration du traçage des sessions Agentforce.
4. Faites défiler jusqu'au commutateur Traçage de la plate-forme de l'agent, puis activez-le.

Votre modèle de données est provisionné en quelques minutes seulement. La collecte des données commence immédiatement et se répète à intervalles de cinq minutes. Notez que l'activation de la collecte de données augmente le taux de consommation de crédit de votre organisation.

La suspension de la collecte de données conserve vos données pour pouvoir les reprendre ultérieurement. Tous les rapports indiquent un écart entre le moment où vous le désactivez et le moment où vous le réactivez.

Rapports Data 360 pour les sessions de représentant de service et les traces de plate-forme

Pour recueillir des connaissances sur les indicateurs de performance clés et les tendances, créez un rapport Data 360 unique qui intègre les traces Session de l'agent et les traces Plate-forme de bout en bout. Ce rapport peut être exécuté pour des données en temps quasi réel, permet de regrouper, de filtrer et de résumer des enregistrements, et peut être partagé avec d'autres utilisateurs.

Le traçage des agents inclut les étendues des services suivants :

• Apex
• Flux
• Générateur de réplique
• Actions invocables
• Planificateur
• AI Gateway
• Passerelle LLM
• Fédérateur de requête DC

Génération d'un rapport Data 360

Créez des rapports sur des objets modèle de données (DMO) spécifiques, tels que Étendue de trace télémétrique et Interaction de l'agent IA, pour analyser et apprendre à partir de données unifiées.

1. Accédez à l'onglet Rapports dans Salesforce, puis cliquez sur Nouveau rapport. La page Types de rapport est affichée.
2. Dans la barre de recherche, saisissez le nom de l'objet modèle de données (DMO) dont vous souhaitez générer le rapport. Dans ce cas, vous sélectionnez Trace de télémétrie Span ou Interaction de l'agent IA.
3. Créez une nouvelle relation de champ dans les objets modèle de données appropriés. Dans ce cas, vous pouvez sélectionner Trace de télémétrie - Trace de télémétrie → ManyToOne → Interaction de l'agent IA - Trace de télémétrie.

   Dans Data 360, les relations entre les DMO sont établies en définissant une connexion depuis un « DMO source » vers un « DMO cible » en utilisant des champs clés. Le type de relation le plus fréquent est Plusieurs-à-Un, où plusieurs enregistrements de l'objet modèle de données Source correspondent à un seul enregistrement dans l'objet modèle de données Cible. Pour plus d'informations, consultez Relations des objets modèle de données.

4. La page de détail de l'objet modèle de données contient un onglet Relations. Cet onglet présente une vue visuelle et structurée de toutes les relations qui existent pour cet objet modèle de données. Vérifiez les nouvelles relations des objets modèle de données sous l'onglet Relations.

   Exemple de portée de trace télémétrique

   Exemple d'interaction avec un agent IA

5. Créez un type de rapport personnalisé.
6. Cliquez sur Nouveau rapport personnalisé dans Configuration, sous Nouveau rapport personnalisé. Complétez les champs pour créer un type de rapport personnalisé. Dans ce cas, vous créez un type de rapport Session & Platform Traces.
7. Accédez à l'application Data Cloud, puis sélectionnez l'onglet Rapports.
8. Créez un rapport Data 360. Cliquez sur Nouveau rapport, puis sélectionnez le type de rapport voulu (par exemple Traces de session et Traces de plate-forme).
9. Cliquez sur Démarrer le rapport.

Une fois le rapport initié, vous devez pouvoir visualiser les étendues de trace de télémétrie de plate-forme corrélées consignées dans le cadre de chaque session d'agent.

Remarque Les rapports Data 360 affichent au maximum 2000 lignes en mode d'exécution. Vous pouvez exporter jusqu'à 50 000 lignes. Pour plus d'informations, consultez Rapports et tableaux de bord Data 360 et Rapports et tableaux de bord Data Cloud : Limitations.

Modèle de données pour le traçage de la plate-forme de l'agent

L'activation de ces fonctionnalités génère automatiquement un flux de données Data 360, un objet lac de données (DLO) et un objet modèle de données (DMO). Ces données sont créées dans l'espace de données spécifié dans Audit et surveillance.

Flux de données Étendue de l'observabilité

Le flux de données Observability Spans est automatiquement créé pour capturer les données de trace :

Objet Lac de données étendu à l'observabilité

Un nouvel objet lac de données appelé ObservabilitySpans est créé avec les champs suivants :

Objet modèle de données Trace de télémétrie

Un nouvel objet modèle de données appelé Étendue de trace télémétrique est créé avec les champs suivants :

Exemples SOQL

DLO SOQL

SELECT attributes__c, cdp_sys_PartitionDate__c, cdp_sys_SourceVersion__c, DataSource__c, DataSourceObject__c, 
durationNanos__c, endDateTime__c, InternalOrganization__c, KQ_parentSpanId__c, KQ_spanId__c 
FROM ObservabilitySpans__dll LIMIT 100

DMO SOQL

SELECT ssot__DataSourceId__c, ssot__DataSourceObjectId__c, ssot__DurationNumber__c, ssot__EndDateTime__c, 
ssot__InternalOrganizationId__c, KQ_TelemetryParentSpanId__c, KQ_Id__c, ssot__OperationName__c, ssot__ServiceName__c, 
ssot__SpanKind__c FROM ssot__TelemetryTraceSpan__dlm LIMIT 100

Exemple de trace

  Trace ID: a744ad5ccf0f61c2                                                                                                    
   
  run.interaction [Atlas Reasoning Engine] [ROOT]                                                                               
  (spanId: 9dcc09221a05d4cf)
  │
  ├── run.action.AnswerQuestionsWithKnowledge_179gL0000019Ah7 [Atlas Reasoning Engine]
  │   (spanId: 90a3808ba7a67fe8)
  │   │
  │   └── run.invokeActions.STREAM_KNOWLEDGE_SEARCH [InvocableAction]
  │       (spanId: 95499b41725eb82a)
  │       │
  │       └── run.einstein_gpt__answerWithKnowledge.1 [PromptTemplate]
  │           (spanId: a9a8b8f2e1fd35cb)
  │           📋 Attributes:
  │              • prompt_template.execution.api.version: 66.0
  │              • prompt_template.execution.step: 66.0
  │              • prompt_template.api.name: einstein_gpt__answerWithKnowledge
  │              • prompt_template.api.version: 1
  │           │
  │           └── run.invokeActions.EINSTEIN_RETRIEVER_GET_RESULTS [InvocableAction]
  │               (spanId: 82559a5dedaff638)
  │               │
  │               ├── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
  │               │   (spanId: 934afceaac15c6d4)
  │               │   📋 Attributes:
  │               │      • prompt_template.step.start_time: 1774049705404
  │               │      • prompt_template.step.end_time: 1774049705430
  │               │      • prompt_template.step: resolve_template
  │               │   │
  │               │   └── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
  │               │       (spanId: b93e831b1c492cf9)
  │               │       📋 Attributes:
  │               │          • prompt_template.step.start_time: 1774049705447
  │               │          • prompt_template.step.end_time: 1774049705449
  │               │          • prompt_template.step: mask_template
  │               │       │
  │               │       └── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
  │               │           (spanId: 8380c9b813f64afa)
  │               │           📋 Attributes:
  │               │              • prompt_template.step.start_time: 1774049705500
  │               │              • prompt_template.step.end_time: 1774049705502
  │               │              • prompt_template.step: generation
  │               │
  │               └── run.retriever.File_ADL_File_ADL_1Cx_Xl7d6d114de [Einstein AI Gateway]
  │                   (spanId: a0f6b9721e1049a3)
  │                   📋 Attributes:
  │                      • retriever.numberofresults: 10
  │                      • retriever.isadvancedmode: False
  │                      • retriever.retrievername: File_ADL_File_ADL_1Cx_Xl7d6d114de
  │                   │
  │                   └── run.hybridsearch.ADL_File_ADL_index__dlm [Data Cloud]
  │                       (spanId: 86aa7512858c1aa9)
  │
  ├── run.topic.GeneralFAQ_16jgL000001ATzR [Atlas Reasoning Engine]
  │   (spanId: a3709c000d5d6a2e)
  │   │
  │   ├── run.llmstep [Atlas Reasoning Engine]
  │   │   (spanId: 9829763b4362466f)
  │   │
  │   ├── run.llmstep [Atlas Reasoning Engine]
  │   │   (spanId: 9a29b1009ea0f4c6)
  │   │
  │   └── run.llmstep [Atlas Reasoning Engine]
  │       (spanId: bf63506e4fccff9f)
  │
  └── run.llmstep [Atlas Reasoning Engine]
      (spanId: 9f31edde2c62d1dc)
  Summary:
  - 15 total spans in this trace
  - 5 spans with attributes (marked with 📋)
  - 10 spans without attributes
  - All spans share trace ID: a744ad5ccf0f61c2