Rastreamentos de Agentes

Os rastros de agentes do Claude Code, Codex, Pi, Hermes Agent e Factory Droid são suportados nativamente no Hugging Face Hub. Envie as sessões JSONL brutas para um Dataset ou um Storage Bucket para abri-los em um visualizador de rastros dedicado. Os Datasets exibem os rastros no Data Studio; os buckets permitem abrir arquivos .jsonl individuais diretamente.

Encontre seus rastros

A maioria dos agentes suportados grava sessões JSONL em diretórios locais:

Esses arquivos de trilha são suportados nativamente, portanto, você pode enviá-los sem modificá-los ou convertê-los antes.

O Hermes Agent armazena as sessões atuais em seu banco de dados de sessões. Exporte as sessões que deseja compartilhar como JSONL antes de fazer o upload:

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

Você está construindo seu próprio harness? Se o seu agente não está listado acima, você pode fazer com que as sessões dele sejam renderizadas no visualizador de rastros emitindo o Session Traces Format.

Os arquivos de trilha podem incluir prompts, entradas de ferramentas, saída de comandos, caminhos locais, capturas de tela, segredos, código privado e dados pessoais. Revise e remova informações sensíveis das trilhas antes de publicá-las, ou mantenha o conjunto de dados ou o bucket privado se você não tiver certeza do que está contido neles.

Para sessões do Pi Agent, pi-share-hf pode ajudar a coletar sessões do projeto, ocultar segredos conhecidos, executar TruffleHog e revisão por LLM, e enviar apenas as sessões que passam nas verificações.

A maneira mais fácil de fazer o upload é pedir ao próprio agente: aponte-o para o diretório ou arquivo JSONL exportado acima e diga a ele para fazer o upload dos arquivos .jsonl para um dataset ou bucket do Hub.

Buckets são especialmente úteis se você deseja continuar sincronizando traces à medida que novas sessões chegam.

Envie seus rastreamentos

Após criar um dataset ou bucket, instale o CLI hf com o instalador standalone recomendado e faça login. O instalador também configura o Hugging Face CLI Skill, para que seu agente de codificação possa executar comandos hf por você.

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

Substitua ~/.codex/sessions pelo diretório de sessão correspondente ao seu agente, ou por um diretório contendo arquivos JSONL exportados do Hermes Agent. Use hf upload para datasets e hf buckets sync para buckets que você deseja atualizar à medida que novos traces são gravados. O comando mais curto hf sync é um alias para hf buckets sync.

Visualize seus rastros

Depois que você tiver traces em um dataset, abra o Data Studio e clique em uma linha. Para traces em um Storage Bucket, navegue até o arquivo .jsonl que deseja inspecionar e abra-o. O visualizador de traces exibe a linha do tempo da sessão, prompts, mensagens do assistente, chamadas de ferramentas, saída do shell, blocos de raciocínio e resultados.

Para um exemplo público, abra TeichAI/DeepSeek-v4-Pro-Agent. Você também pode navegar por mais datasets marcados como traces.