Dấu vết của Agent

Agent traces từ Claude Code, Codex, Pi, Hermes Agent và Factory Droid được hỗ trợ nguyên sinh trên Hugging Face Hub. Tải các phiên JSONL thô lên một Dataset hoặc một Storage Bucket để mở chúng trong trình xem trace chuyên dụng. Datasets hiển thị các trace trong Data Studio; buckets cho phép bạn mở trực tiếp các tệp .jsonl riêng lẻ.

Tìm các trace của bạn

Hầu hết các agent được hỗ trợ ghi các phiên JSONL vào các thư mục cục bộ:

Các tệp trace này được hỗ trợ ngay từ đầu, vì vậy bạn có thể tải chúng lên mà không cần chỉnh sửa hay chuyển đổi trước.

Hermes Agent lưu các phiên hiện tại trong cơ sở dữ liệu phiên của nó. Hãy xuất các phiên bạn muốn chia sẻ dưới dạng JSONL trước khi tải lên:

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

Bạn đang tự xây dựng harness của riêng mình? Nếu agent của bạn không được liệt kê ở trên, bạn có thể hiển thị các phiên của nó trong trace viewer bằng cách phát ra Session Traces Format.

File trace có thể chứa prompts, đầu vào của công cụ, đầu ra của lệnh, đường dẫn cục bộ, ảnh chụp màn hình, thông tin bí mật, mã nguồn riêng tư và dữ liệu cá nhân. Hãy xem xét và che đi các phần nhạy cảm trong trace trước khi công bố chúng công khai, hoặc giữ dataset hoặc bucket ở chế độ riêng tư nếu bạn không chắc chắn về nội dung bên trong.

Đối với các phiên Pi Agent, pi-share-hf có thể hỗ trợ thu thập các phiên dự án, che đi các bí mật đã biết, chạy TruffleHog và LLM review, và chỉ tải lên các phiên vượt qua các bước kiểm tra.

Cách dễ nhất để tải lên là yêu cầu chính tác tử của bạn: chỉ cho nó thư mục hoặc tệp JSONL đã xuất ở trên và bảo nó tải các tệp .jsonl lên một bộ dữ liệu Hub hoặc bucket.

Buckets đặc biệt hữu ích nếu bạn muốn tiếp tục đồng bộ hóa các trace khi các phiên mới được tạo.

Tải lên các trace của bạn

Sau khi tạo dataset hoặc bucket, hãy cài đặt CLI hf bằng trình cài đặt độc lập được khuyến nghị và đăng nhập. Trình cài đặt cũng thiết lập Hugging Face CLI Skill, cho phép tác nhân lập trình của bạn chạy các lệnh hf thay cho bạn.

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

Thay ~/.codex/sessions bằng thư mục phiên tương ứng cho agent của bạn, hoặc bằng một thư mục chứa các tệp JSONL được xuất từ Hermes Agent. Sử dụng hf upload cho datasets và hf buckets sync cho các bucket mà bạn muốn cập nhật khi các trace mới được ghi. Lệnh ngắn hơn hf sync là một alias của hf buckets sync.

Xem các trace của bạn

Khi bạn đã có các trace trong một dataset, hãy mở Data Studio và nhấp vào một dòng. Đối với các trace trong Storage Bucket, hãy điều hướng đến tệp .jsonl mà bạn muốn kiểm tra và mở nó. Trình xem trace hiển thị dòng thời gian của phiên, các prompt, thông điệp từ trợ lý, các cuộc gọi công cụ, đầu ra shell, các khối suy luận và kết quả.

Để xem một ví dụ công khai, hãy mở TeichAI/DeepSeek-v4-Pro-Agent. Bạn cũng có thể xem thêm các bộ dữ liệu được gắn thẻ traces.