trace

Query and filter Ara agent traces with Braintrust permalinks and SQL-backed transcripts.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Aradotso/ara.engineer --skill trace-aradotso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/Aradotso/ara.engineer/tree/main/skills/trace
Command: npx skills add https://github.com/Aradotso/ara.engineer --skill trace-aradotso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging and auditing Ara agent traces across builds, conversations, and tools by providing structured, searchable trace data and shareable Braintrust links.

Core Features & Use Cases

  • Trace querying and filtering (inbound webhooks, conversations, turns) across the website-agent stack.
  • Per-user trace summarization with latest link, top-user aggregation, and inline transcripts.
  • End-to-end scoring, regression dataset grow, and health checks to maintain trace quality.

Quick Start

Run bt view logs to locate recent webhook.inbound entries, then use /trace commands to inspect, filter, and generate Braintrust permalinks for sharing.

Frequently Asked Questions about trace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug agent traces and link them to shareable transcripts?

To debug agent traces, you can identify, extract, and correlate conversation and tool invocation data to generate SQL-backed inline transcripts and shareable Braintrust permalinks for auditing.

What is the best way to query inbound webhooks and locate recent agent trace logs?

The best way to query inbound webhooks is by running bt view logs to locate recent webhook.inbound entries, then using /trace commands to inspect, filter, and correlate website-agent stack data.

Can I aggregate top-user statistics from conversation traces without compromising privacy?

Yes, you can aggregate top-user statistics and generate per-user trace summaries from conversation transcripts while strictly preserving user privacy across the queried data views.

Does this trace debugging approach support production performance analysis and regression testing?

Yes, trace debugging supports production performance analysis and auditing by enabling end-to-end scoring and allowing you to grow regression datasets to maintain trace quality.

How do I perform a health check on agent traces across builds and user conversations?

You perform health checks on agent traces by applying end-to-end scoring and querying structured trace data across builds, tool invocations, and user conversations to maintain quality.

Why are my structured trace queries failing to correlate tool invocations with user conversations?

Trace queries may fail if the data views are not properly filtered; use /trace commands to inspect and correlate inbound webhooks, turns, and conversations across the website-agent stack.