> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovara-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Efficient annotation

> Review surfaced runs and save useful labels.

Sovara keeps the annotation queue focused. It separates runs to annotate from
already annotated runs, shows why a run was surfaced, and points reviewers to
the trace steps worth checking first.

<img className="docs-screenshot docs-screenshot-light" src="https://mintcdn.com/sovaralabs/NvGxJrAQ7PUWeA2e/assets/screenshots/annotation-light.png?fit=max&auto=format&n=NvGxJrAQ7PUWeA2e&q=85&s=631e5ec1340dbe492a3fd3f512ebed2a" alt="Sovara annotation queue with surfaced runs and reviewer guidance" width="3104" height="2144" data-path="assets/screenshots/annotation-light.png" />

<img className="docs-screenshot docs-screenshot-dark" src="https://mintcdn.com/sovaralabs/NvGxJrAQ7PUWeA2e/assets/screenshots/annotation-dark.png?fit=max&auto=format&n=NvGxJrAQ7PUWeA2e&q=85&s=c3d169859b8c256ce6eeac1681731723" alt="Sovara annotation queue with surfaced runs and reviewer guidance" width="3104" height="2144" data-path="assets/screenshots/annotation-dark.png" />

## Add a run manually

Sovara recommends runs automatically, but you can also add a run from the Runs
view when you already know it deserves review. Select the run, open
**Actions**, then choose
<strong><Icon icon="list-plus" size={14} /> Add to annotation queue</strong>.

<img className="docs-screenshot docs-screenshot-light" src="https://mintcdn.com/sovaralabs/NvGxJrAQ7PUWeA2e/assets/screenshots/annotate-in-runs-light.png?fit=max&auto=format&n=NvGxJrAQ7PUWeA2e&q=85&s=cd8c5f96114cde6dbe603c22e47fbccb" alt="Add a selected run to the annotation queue from the Runs view" width="2368" height="722" data-path="assets/screenshots/annotate-in-runs-light.png" />

<img className="docs-screenshot docs-screenshot-dark" src="https://mintcdn.com/sovaralabs/NvGxJrAQ7PUWeA2e/assets/screenshots/annotate-in-runs-dark.png?fit=max&auto=format&n=NvGxJrAQ7PUWeA2e&q=85&s=c805bd889fee7953ad99f81f1cc80bd1" alt="Add a selected run to the annotation queue from the Runs view" width="2368" height="722" data-path="assets/screenshots/annotate-in-runs-dark.png" />

## Review the run

Click <strong><Icon icon="search" size={14} /> Inspect run</strong> to inspect
the trace, read the recommendation, and save a label. For failures, include the
ground truth or correction that should guide future behavior.

<img className="docs-screenshot docs-screenshot-light" src="https://mintcdn.com/sovaralabs/NvGxJrAQ7PUWeA2e/assets/screenshots/annotate-drill-light.png?fit=max&auto=format&n=NvGxJrAQ7PUWeA2e&q=85&s=37a8c49880dc43ef7ccc98c55b2249fa" alt="Annotation review view opened into the run trace" width="3104" height="2144" data-path="assets/screenshots/annotate-drill-light.png" />

<img className="docs-screenshot docs-screenshot-dark" src="https://mintcdn.com/sovaralabs/NvGxJrAQ7PUWeA2e/assets/screenshots/annotate-drill-dark.png?fit=max&auto=format&n=NvGxJrAQ7PUWeA2e&q=85&s=60d680cb2e2fca9638d811144f74286a" alt="Annotation review view opened into the run trace" width="3104" height="2144" data-path="assets/screenshots/annotate-drill-dark.png" />

Use annotation to:

* Mark a run as success or failure
* Preserve the ground truth for important failures
* Capture recurring domain knowledge as a lesson
* Build a reviewed set of examples for future regression checks
