Que fait sf-ai-agentforce-observabilité ?
Extraction et analyse des traces de sessions Agentforce. DÉCLENCHER lorsque : l'utilisateur extrait des données STDM de Data Cloud, analyse des traces de sessions d'agents, débogue des conversations d'agents via la télémétrie, ou travaille avec des fichiers .parquet d'Agentforce. NE PAS DÉCLENCHER lors de : tests d'agents (utiliser sf-ai-agentforce-testing), logs de débogage Apex (utiliser sf-debug), ou création d'agents (utiliser sf-ai-agentforce).
Aperçu
Cette compétence fournit des outils pour extraire et analyser les données de traces des sessions Agentforce à partir de Data Cloud. Elle prend en charge le débogage des conversations d'agents via la télémétrie, l'identification des goulots d'étranglement, la résolution des erreurs et l'optimisation des performances des agents.
Fonctionnalités
- Extraction STDM : Récupère les données STDM (Session Trace Data Model) depuis Data Cloud pour l'analyse.
- Analyse des traces : Traite et analyse les traces de sessions d'agents pour identifier des modèles et des anomalies.
- Débogage par télémétrie : Utilise les données de télémétrie pour déboguer les conversations et les interactions des agents.
- Prise en charge des fichiers .parquet : Travaille directement avec les fichiers
.parquetexportés depuis Agentforce.
Prérequis
- Accès à une organisation Salesforce avec Data Cloud activé.
- Autorisations pour extraire des données de Data Cloud.
- Fichiers
.parquetd'Agentforce (si une analyse hors ligne est nécessaire).
Utilisation
- Extraire les données STDM : Utilisez la commande appropriée pour récupérer les données de session depuis Data Cloud.
- Analyser les traces : Fournissez les traces extraites à la compétence pour une analyse automatisée.
- Déboguer les conversations : Examinez les données de télémétrie pour identifier les problèmes dans les interactions des agents.
- Travailler avec des fichiers .parquet : Importez des fichiers
.parquetpour l'analyse hors ligne.
Commandes
extraire-stdm: Extrait les données STDM depuis Data Cloud.analyser-traces: Analyse les traces de sessions fournies.deboguer-conversation: Débogue une conversation spécifique via la télémétrie.
Exemple
# Extraire les données STDM pour une session spécifique
outil extraire-stdm --session-id "00Dxx0000000001"
# Analyser les traces extraites
outil analyser-traces --fichier "traces.parquet"
Limites
- Cette compétence ne doit pas être utilisée pour les tests d'agents (utilisez
sf-ai-agentforce-testing). - Elle ne convient pas pour les logs de débogage Apex (utilisez
sf-debug). - Elle ne crée ni ne modifie les agents (utilisez
sf-ai-agentforce).
Dépannage
- Erreur d'extraction : Vérifiez que les autorisations Data Cloud sont correctes.
- Fichier .parquet corrompu : Assurez-vous que le fichier est correctement exporté depuis Agentforce.
- Données manquantes : Vérifiez que la session existe dans Data Cloud.