> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/ai-workbench-qore/control-center/evals/agent-list.md).

# Agent List

Assign evaluators to agents, select sampling rates, and enable online evaluation for live traffic.

Agent List maps evaluators to individual agents and controls how they score live traffic. Use it to turn on Online Eval, select evaluators, and set sampling rates that manage evaluation cost. An evaluator only scores an assigned agent when Online Eval is on for that agent.

Open it in **Control Center → Evals → Agent List**.

## Agent table

Filter the list by **Project**, or select **Search**, type part of an agent's name, and press **Enter**.

| Column                  | What it shows                                                                                                                                                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agent**               | The agent this row configures.                                                                                                                                                                      |
| **Project**             | The project the agent belongs to. An agent with the same name in two projects has two rows.                                                                                                         |
| **Assigned evaluators** | The evaluators assigned to this agent. An agent with many evaluators shows the first three and the rest as a count, such as **+3**. **Edit evaluators** in the row's **Actions** menu changes them. |
| **Sampling**            | The chance that each live conversation is evaluated. Lower it on high-traffic agents to keep judge costs down.                                                                                      |
| **Online eval**         | The toggle that turns live-traffic scoring on or off for this agent. While it's on, every enabled evaluator assigned to the agent scores the sampled share of its conversations.                    |

## Sampling and Online eval

| Setting         | Values and behavior                                                                                                                    |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Sampling**    | **100%**, **50%**, **25%**, or **10%**. A new agent starts at **100%**.                                                                |
| **Online eval** | Starts **off** for every agent, including one you assign an evaluator to. Turn it on or off with the toggle. There is no confirmation. |

An agent can show **Unsupported** instead of a sampling control and toggle. That agent's type doesn't support Online Eval. **Edit evaluators** still lets you pre-assign evaluators.

## Assign evaluators

**Edit evaluators** in the row's **Actions** menu opens the **Edit Evaluators** dialog for the agent. The dialog lists every evaluator in the account, with a count of the evaluators selected and **Select all** and **Clear** links. Select the evaluators that score the agent, and then select **Save**. The evaluators in the row update to match.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-7c67dc82118a4380fd1b996d53406dc1e81a78fc%2Fqore_control-center_evals-assign-evaluators_rounded_shadow.png?alt=media" alt="The Assign evaluators dialog for an agent, with a checkbox for each evaluator in the account and Cancel and Save buttons"><figcaption><p>Select the evaluators that score this agent.</p></figcaption></figure>

Assigning evaluators doesn't start scoring on its own. Turn on the agent's **Online eval** toggle as well.

## Messages

| Message                                                                                                                                                                                                                                                                                                | Meaning                                                      |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| `Online evaluation updated`                                                                                                                                                                                                                                                                            | The **Online eval** toggle changed.                          |
| "Each agent runs the evaluators you assign to it. Turn on online eval and pick which evaluators score its live traffic. Every enabled evaluator runs on the sampled responses. Sampling defaults to all traffic, so lower the rate in the Sampling column to control eval cost on high-volume agents." | The page's explanation of how scoring works. **X** hides it. |

## What's next

<table data-view="cards"><thead><tr><th>Title</th><th>Description</th><th data-card-target data-type="content-ref">Link</th></tr></thead><tbody><tr><td><strong>Evaluators</strong></td><td>Define how outputs are scored and who reviews them.</td><td><a href="https://docs.uptiq.ai/ai-workbench-qore/control-center/evals/evaluators.md">Evaluators</a></td></tr><tr><td><strong>Online Eval Runs</strong></td><td>See every scored live run and how it was judged.</td><td><a href="https://docs.uptiq.ai/ai-workbench-qore/control-center/evals/online-eval-runs.md">Online Eval Runs</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.uptiq.ai/ai-workbench-qore/control-center/evals/agent-list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
