borderless / TRACE_SHARING.md
spagestic's picture
Document the demo flow, field notes, and trace sharing process.
14b75bf
|
Raw
History Blame Contribute Delete
838 Bytes
# Trace Sharing
Borderless writes non-blocking JSONL tool traces to `agent_traces/` by default.
These traces are ignored by git so local demos do not accidentally commit noisy
runtime files.
Each line includes:
- Timestamp
- Tool name
- Tool arguments
- Duration
- Truncated tool result
Use these traces to support the Build Small **Sharing is Caring** badge:
1. Run a polished demo prompt in the Space or locally.
2. Review the generated `agent_traces/borderless-YYYYMMDD.jsonl` file.
3. Remove any personal information from the user profile or tool results.
4. Publish the sanitized trace as a Hugging Face dataset, gist, or appendix to a
field-notes post.
Configuration:
- `BORDERLESS_TRACE_DIR`: output directory, default `agent_traces`.
- `BORDERLESS_DISABLE_TRACE_LOGS=1`: disable trace logging.