Annotrace: A Workbench for Step-Level Annotation of Agent Traces

arXiv:2610.23284 · cs.AI, cs.CL, cs.HC, cs.MA · Submitted 2026-10-16 · Read on arXiv

cs.AI, cs.CL, cs.HC, cs.MA

Submitted: 2026-10-16

Updated: 2026-10-16

Comments: 4 pages, 4 figures, 1 table. Under review at the AAAI 2027 Demonstration Program

License: http://creativecommons.org/licenses/by/4.0/

The gist: Every study of why LLM agents fail begins by labelling traces by hand, and every such study builds its own throwaway tool.

Terminology

Abstract

Every study of why LLM agents fail begins by labelling traces by hand, and every such study builds its own throwaway tool. Observability platforms record agent traces but offer no structured labelling; annotation tools label text but have no notion of a step, a delegation or a tool call, leaving it unclear what the smallest unit of execution to label should be. Annotrace reads six trace formats, including OpenTelemetry GenAI, LangSmith and Langfuse, and turns each run into an ordered, nested list of steps. The annotator writes their own labelling codebook; a frontier model proposes a starting set from a sample of their own traces, answers first, and is asked exactly the questions the human is asked, making annotation a joint human-AI process. Annotrace measures agreement between any two annotators, human or AI. On a multi-agent question-answering corpus it reproduces a previous manual effort's 235 annotation units exactly, and two models labelling the same traces agree 91% of the time at κ= 0.82.

Related papers