Traces d'agent

Les traces d’agents issues de Claude Code, Codex, Pi, Hermes Agent et Factory Droid sont prises en charge nativement sur le Hugging Face Hub. Téléchargez les sessions JSONL brutes dans un Dataset ou un Storage Bucket pour les ouvrir dans un visualiseur de traces dédié. Les datasets affichent les traces dans Data Studio ; les buckets permettent d’ouvrir directement des fichiers .jsonl individuels.

Trouvez vos traces

La plupart des agents pris en charge écrivent des sessions JSONL dans des répertoires locaux :

Ces fichiers de trace sont pris en charge nativement, vous pouvez donc les téléverser sans avoir à les modifier ou à les convertir au préalable.

Hermes Agent stocke les sessions actuelles dans sa base de données de sessions. Exportez les sessions que vous souhaitez partager au format JSONL avant de les téléverser :

hermes sessions export session.jsonl --session-id <session_id>

Construisez-vous votre propre harnais ? Si votre agent n’est pas répertorié ci-dessus, vous pouvez faire afficher ses sessions dans le visualiseur de traces en émettant le Session Traces Format.

Les fichiers de trace peuvent contenir des invites, des entrées d’outils, des sorties de commandes, des chemins locaux, des captures d’écran, des secrets, du code privé et des données personnelles. Examinez et masquez les traces avant de les publier publiquement, ou conservez le jeu de données ou le bucket privé si vous n’êtes pas sûr de son contenu.

Pour les sessions Pi Agent, pi-share-hf peut aider à collecter les sessions de projet, à masquer les secrets connus, à exécuter TruffleHog et une revue par LLM, et à ne téléverser que les sessions qui passent les vérifications.

La méthode la plus simple pour effectuer le téléversement consiste à demander directement à votre agent : indiquez-lui le répertoire ou le fichier JSONL exporté ci-dessus et demandez-lui de téléverser les fichiers .jsonl vers un jeu de données ou un bucket du Hub.

Les buckets sont particulièrement utiles si vous souhaitez continuer à synchroniser les traces à mesure que de nouvelles sessions arrivent.

Téléchargez vos traces

Après avoir créé un jeu de données ou un bucket, installez le CLI hf à l'aide de l'installateur autonome recommandé et connectez-vous. L'installateur configure également le Hugging Face CLI Skill, permettant ainsi à votre agent de codage d'exécuter les commandes hf pour vous.

curl -LsSf https://hf.co/cli/install.sh | bash
hf auth login

hf upload <username>/<dataset-name> ~/.codex/sessions . --repo-type dataset
hf buckets sync ~/.codex/sessions hf://buckets/<username>/<bucket-name>/codex

Remplacez ~/.codex/sessions par le répertoire de session correspondant à votre agent, ou par un répertoire contenant des fichiers JSONL exportés depuis Hermes Agent. Utilisez hf upload pour les jeux de données et hf buckets sync pour les buckets que vous souhaitez mettre à jour à mesure que de nouvelles traces sont écrites. La commande plus courte hf sync est un alias de hf buckets sync.

Afficher vos traces

Une fois que vous avez des traces dans un jeu de données, ouvrez Data Studio et cliquez sur une ligne. Pour les traces dans un Storage Bucket, accédez au fichier .jsonl que vous souhaitez inspecter et ouvrez-le. Le visualiseur de traces affiche la chronologie de la session, les prompts, les messages de l’assistant, les appels d’outils, la sortie du shell, les blocs de raisonnement et les résultats.

Pour un exemple public, ouvrez TeichAI/DeepSeek-v4-Pro-Agent. Vous pouvez également parcourir d'autres jeux de données étiquetés traces.