Trazas de agentes

Las trazas de agentes de Claude Code, Codex, Pi, Hermes Agent y Factory Droid se admiten de forma nativa en Hugging Face Hub. Sube las sesiones JSONL sin procesar a un Dataset o a un Storage Bucket para abrirlas en un visor de trazas dedicado. Los datasets muestran las trazas en Data Studio; los buckets permiten abrir archivos .jsonl individuales directamente.

Encuentra tus trazas

La mayoría de los agentes compatibles escriben sesiones JSONL en directorios locales:

Estos archivos de trazas son compatibles de forma nativa, por lo que puedes subirlos sin necesidad de modificarlos o convertirlos previamente.

Hermes Agent almacena las sesiones actuales en su base de datos de sesiones. Exporta las sesiones que quieras compartir como JSONL antes de subirlas:

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

¿Estás construyendo tu propio harness? Si tu agente no aparece en la lista anterior, puedes hacer que sus sesiones se muestren en el visor de trazas emitiendo el Session Traces Format.

Los archivos de trazas pueden incluir indicaciones, entradas de herramientas, salida de comandos, rutas locales, capturas de pantalla, secretos, código privado y datos personales. Revisa y censura las trazas antes de publicarlas públicamente, o mantén el conjunto de datos o el cubo privado si no estás seguro de qué contiene.

Para las sesiones de Pi Agent, pi-share-hf puede ayudar a recopilar sesiones del proyecto, redactar secretos conocidos, ejecutar TruffleHog y una revisión con LLM, y subir solo las sesiones que superan las comprobaciones.

La forma más sencilla de subir es pedirle a tu agente que lo haga: dirígelo al directorio o al archivo JSONL exportado anterior y dile que suba los archivos .jsonl a un conjunto de datos o cubo del Hub.

Los buckets son especialmente útiles si deseas seguir sincronizando las trazas a medida que llegan nuevas sesiones.

Sube tus trazas

Después de crear un conjunto de datos o un bucket, instala la CLI hf con el instalador independiente recomendado e inicia sesión. El instalador también configura la Hugging Face CLI Skill, de modo que tu agente de codificación pueda ejecutar comandos hf por ti.

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

Sustituya ~/.codex/sessions por el directorio de sesión correspondiente a su agente, o por un directorio que contenga archivos JSONL exportados desde Hermes Agent. Use hf upload para conjuntos de datos y hf buckets sync para los buckets que desee actualizar a medida que se escriban nuevas trazas. El comando más corto hf sync es un alias de hf buckets sync.

Ver tus trazas

Una vez que tengas trazas en un conjunto de datos, abre Data Studio y haz clic en una fila. Para las trazas en un Storage Bucket, navega hasta el archivo .jsonl que deseas inspeccionar y ábrelo. El visor de trazas muestra la línea de tiempo de la sesión, los prompts, los mensajes del asistente, las llamadas a herramientas, la salida de la shell, los bloques de razonamiento y los resultados.

Para un ejemplo público, abra TeichAI/DeepSeek-v4-Pro-Agent. También puede explorar más conjuntos de datos etiquetados como traces.