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

# How data labeling works

> How work is divided between you and the agent — you describe the task and approve the calls that cost money; the agent builds, configures, and checks the pipeline.

Describe your labeling task to the agent, which builds and configures a pipeline. Review the setup and cost, then launch a run to process your items with experts or an LLM and write the results back.

<video controls preload="metadata" alt="Demo: describing a task, reviewing the pipeline the agent built, launching the run, and exporting results" aria-label="Demo: describing a task, reviewing the pipeline the agent built, launching the run, and exporting results">
  <source src="https://tlkfrontprod.azureedge.net/frontend-production/apps/self-service/self-service-v2-demo.mp4" type="video/mp4" />
</video>

![The flow: you describe the task, the agent builds the pipeline and sets up quality control, the self-check validates the setup, you launch and approve the cost, the run labels your items, you export the results.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/explanation/how-the-platform-works/platform-flow.svg?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=11058ee0e708e5ba8511af2c79c802c5)

## Describing the task

You start by telling the agent in a chat what you need labeled. For example, "classify these support tickets by intent" or "draw bounding boxes around every cat in these images." You don't need to assemble or configure the pipeline by hand.

From that description the agent assembles a **pipeline**: a sequence of nodes that takes your data in and produces labeled results. It decides which kinds of nodes the task needs, sets up the instructions and the labeling screen the experts will see, and sets the expert audience (languages, specializations, countries) and the pricing. When the data format, the languages your labelers should speak, or a quality threshold is ambiguous, it asks you rather than guessing.

Ask the agent to change any part of the proposed pipeline that does not match your task.

## What a pipeline is made of

A pipeline is a connected set of nodes. Each node is one of a small, fixed set of kinds, and the agent picks the kind that fits each part of your task:

* **Generation node** ([reference](https://docs.platform.toloka.ai/docs/data/reference/nodes/generation.md)). One labeler per item: annotating images, writing or rewriting text, rating or comparing outputs, or checking the output of a model. Expert labelers do this work by default, and it is the only node that can hand the same job to an LLM instead.
* **Quorum node** ([reference](https://docs.platform.toloka.ai/docs/data/reference/nodes/quorum.md)). The same item is labeled independently by several experts (you choose how many), and you get back all of their answers, so you can see where they agree and where they disagree. It does not decide a winner for you. If you want to reduce the answers to a single value, a following Code node computes it.
* **Code node** ([reference](https://docs.platform.toloka.ai/docs/data/reference/nodes/code.md)). A deterministic transformation: parsing, filtering, math, or calling an external service. Use this when the answer can be computed from the input without human judgment.
* **Match node** ([reference](https://docs.platform.toloka.ai/docs/data/reference/nodes/match.md)). Routes items down different paths based on their content, so different items get handled differently.

## How quality is controlled

Quality control is on by default on every labeling node. Which reviewer checks the labels, and for which items, is the node's review path. On a Generation node, ask the agent to enable human review if needed. See [Quality control](https://docs.platform.toloka.ai/docs/data/concepts/quality-control.md).

## The self-check

Use **Code Test** for sample code inputs, **Annotation Quality Assurance** for sample annotations, and **Synthetic Generation** for LLM-generated samples. Preview the labeling interface and test a submission before deploying.

Configuration errors and failed checks block deployment. Unrun test checks are warnings you can review and override. The built-in lints start automatically after edits and must finish before deployment: Quality Requirements and User Interface Types on labeling nodes, Dataset Items on Start, and Exam Golden Dataset on expert-labeling nodes with an enabled [exam](https://docs.platform.toloka.ai/docs/data/reference/nodes/generation.md#exam).

See [Self-check](https://docs.platform.toloka.ai/docs/data/concepts/self-check.md) for test cases, lint findings, and the **Issues** window.

## Launching a run

Real labeling costs money, so the decision to spend is always yours. When the pipeline is built and free of errors, **you** launch the run. The agent does not start it for you. If you want to bound the cost, you can set a cap on how many items the run processes, so you label a subset rather than the whole dataset. A single run [launches at most 10,000 items](https://docs.platform.toloka.ai/docs/data/reference/nodes.md). For expert labeling, your charge is [the per-task price you set plus the platform commission](https://docs.platform.toloka.ai/docs/data/reference/nodes/generation.md#pricing).

## Results

While a run is going, you can track its progress and look at individual results as they come in. When it finishes, you export the labeled dataset.

## One pipeline, one run

Deploying locks the pipeline: you cannot edit it, and you cannot run it a second time. The one exception is a failed deploy, which frees the same pipeline to fix and deploy again. To label another batch, clone the pipeline, re-point the copy, and deploy again.

![A pipeline's lifecycle: an editable pipeline deploys to a locked, deployed pipeline; a failed deploy returns it to editable; cloning it produces a new editable pipeline to re-point and deploy again.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/explanation/how-the-platform-works/pipeline-lifecycle.svg?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=fe0da22ee042d70421d1d6d82e7e1cf5)

For the full workflow, see [Label a large dataset in batches](https://docs.platform.toloka.ai/docs/data/guides/label-at-volume.md).

## Related

* [Get your first labeled dataset](https://docs.platform.toloka.ai/docs/data/get-started/first-labeled-dataset.md) — build and run a pipeline end to end.
* [Fields and data](https://docs.platform.toloka.ai/docs/data/concepts/fields-and-data.md) — the data model a pipeline reads and writes.
* [Quality control](https://docs.platform.toloka.ai/docs/data/concepts/quality-control.md) — how a node's labels are reviewed.
* [Pipeline nodes](https://docs.platform.toloka.ai/docs/data/reference/nodes.md) — what each kind of node does.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.