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

# Labeling Queues

> Route spans to focused review workflows and build ground truth datasets for benchmarks and automated evals.

<h2 id="labeling-queues">
  Send your data to subject matter experts
</h2>

Use labeling queues when you want a subject matter expert or third party to label spans without exposing the full traces view. Reviewers get a focused interface showing only what they need to annotate. Once labeled, those examples become the ground truth dataset you use to validate evaluators and run experiments.

<Tabs>
  <Tab title="By Alyx">
    Ask Alyx to create a labeling queue, send data to it, and optionally annotate data. For example:

    * "Send spans where latency is over 5 seconds to my Slow Response labeling queue"
    * "Send spans where hallucination eval scored 0 to the Hallucination Review queue"

    <Frame caption="Send data to a labeling queue with Alyx">
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/alyx%20-%20send%20data%20to%20queue.png" alt="Tracing view with eval filter applied and Alyx sidebar suggesting sending low-scoring hallucination spans to the Hallucination Review labeling queue" />
    </Frame>
  </Tab>

  <Tab title="By UI">
    You can create a labeling queue from the traces or spans table, from within an individual span, or directly from **Labeling Queues** in the left nav. In all cases you define review instructions, select annotation configs, and assign team members.

    <Frame caption="Select traces then add them to a labeling queue">
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/create%20queue%20from%20trace.png" alt="Playground Traces table with rows selected and the footer action bar showing Send to Labeling Queue and Add to Dataset" />
    </Frame>

    <Frame>
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/create_queue.png" alt="New Labeling Queue modal with queue name, annotation configs, instructions, assignment method, and annotator selection" />
    </Frame>

    <Frame>
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/queues.png" alt="Labeling queue open with a records table showing assignees and completed or pending status for each record" />
    </Frame>
  </Tab>
</Tabs>

## Build a ground truth dataset

A ground truth dataset is a curated set of labeled examples that captures the range of behaviors your system should and should not produce. It gives you a stable benchmark for validating automated evaluators and a reusable dataset to run experiments against as your prompts and models evolve.

<Tabs>
  <Tab title="By Alyx">
    Ask Alyx to create a dataset from spans of interest, append spans to an existing dataset, or suggest examples that cover edge cases for your rubric.

    Example prompts:

    * "Create a dataset from the spans I filtered in this trace view and include inputs and outputs"
    * "Append these high-error spans to my regression benchmark dataset"
    * "Suggest 20 diverse examples for a golden dataset based on my last week's traces"

    <Frame caption="Create a golden dataset with Alyx">
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/Use%20Alyx%20-%20golden%20dataset.png" alt="Tracing view with span filter applied and Alyx sidebar offering to create a golden dataset from factual spans, with preview table and Accept and Create Dataset action" />
    </Frame>
  </Tab>

  <Tab title="By UI">
    To build one, filter or search your spans in Tracing to find representative examples. Select rows and use Add to Dataset to create a new dataset or append to an existing one — span fields map to columns you can edit. Open the dataset from the left nav to review rows, add reference output columns, and version the dataset as labels stabilize.

    <Frame caption="Filter spans">
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/filter.png" alt="Tracing Traces tab with Span Query bar filtering on eval label, summary counts, and traces table" />
    </Frame>

    <Frame caption="Add to dataset">
      <img src="https://storage.googleapis.com/arize-phoenix-assets/assets/images/arize-docs-images/evaluate/create%20golden%20dataset%20UI.png" alt="Traces table with rows selected and footer showing Add to Dataset with option to append to an existing golden dataset or create a new dataset" />
    </Frame>
  </Tab>
</Tabs>
