Skip to content
Platform docsPlatform docsPlatform docs

Label with an LLM instead of experts

Have an LLM label a node's data instead of expert labelers, with each label checked against your quality criteria by a separate LLM call.

With synthetic labeling, a labeling node uses an LLM rather than expert labelers. The LLM generates each label. A separate LLM call with its own model setting checks the label against your quality criteria. This suits high-volume tasks where you accept automated quality control instead of expert review. You cap what the node can spend with a generation budget you set per attempt.

You set this up through the agent while you build the pipeline. It switches a node only when you ask. You can also flip it yourself on the node’s Audience & Pricing card by selecting Human experts or Synthetic data generation.

The Audience & Pricing card: the Human experts / Synthetic data generation choice, with the Model list below.

You need:

  • A pipeline you are building or editing with the agent, with a labeling node in it. See the first labeled dataset tutorial if you have not built a pipeline yet.
  • A node that labels existing data, not one that collects new content. Synthetic labeling is not available for data-collection nodes.

Step 1 — Ask the agent to switch the node to synthetic labeling

Section titled “Step 1 — Ask the agent to switch the node to synthetic labeling”

Tell the agent, in plain language, that you want this node labeled by an LLM instead of experts. For example, say “label this node synthetically” or “use an LLM to generate the labels here.” The agent confirms the switch. Three things change at once:

  • Quality review is set to LLM review. The node’s settings show LLM Only.
  • Any audience reuse from another pipeline is cleared.
  • The expert audience settings no longer apply.

The agent's confirmation after the switch: the node now labels synthetically, quality review locked to LLM, everything else unchanged.

Before it switches the node, the agent asks you for a generation budget — the most one generation attempt may spend. It will not switch without a number, and Step 3 covers how to pick one. Flip the switch by hand instead and the card prefills it.

The node’s cost estimate changes with it. The per-task expert price, onboarding cost, and per-expert cap are replaced by one Synthetic generation line, capped per item, with the model’s token rates beneath it, plus the automated quality checks:

The cost breakdown after the switch: the synthetic generation token lines and the LLM QA per-call line — no expert pricing.

If the node collects new content rather than labeling existing data, the agent reports that synthetic labeling is rejected. It works only on nodes that label existing data.

Step 2 — Choose the generation model and effort (optional)

Section titled “Step 2 — Choose the generation model and effort (optional)”

By default the node uses the recommended model at its default reasoning effort. The catalog currently offers eight generation models, with GPT-5.6 Terra the recommended default. The list changes over time, so ask the agent for the current options. A node pinned to a retired model keeps it, shown disabled with an Unavailable badge; once you move off it you cannot pick it again. Tell the agent which model to use, or ask it to make the model reason harder or lighter on each item. The agent confirms the model and, where the model supports it, the reasoning effort. On a model that cannot adjust effort, the agent keeps the default or picks a model that supports it. The cost estimate follows your choice. More reasoning raises the estimated tokens per item and the estimated price. A lighter setting lowers them.

The generation model and the review model are two independent settings that share a default, GPT-5.6 Terra. Move one of them off it: a model rates its own output too favorably. Switching a node to synthetic labeling keeps whatever review model it already had, and picking a generation model never changes it.

SettingWhat it doesHow you set it
Generation modelProduces each label.Through the agent, or by hand under Model in the node’s Audience & Pricing settings, with Reasoning effort and the Special LLM instruction box just below it.
Review modelChecks each label against your quality criteria.By hand in the node’s Quality Assurance settings. The agent does not manage it.

To change the review model, open the node on the Pipeline tab and pick the Model under its Quality Assurance settings:

The Quality Assurance settings of a synthetic node: the mode locked to LLM Only, with the review-model selector below.

The generation budget is the most one generation attempt may spend on tokens. Give the preferred amount to agent, or set it with the Generation budget per attempt slider on the node’s Audience & Pricing card. An item runs up to two attempts — the first pass, plus one retry if quality assurance rejects the label — so the most you can be charged for an item is twice the budget, and that is the per-item price the cost estimate shows. Quality-assurance calls are billed on top of it. You still pay for real token use; the budget only caps it.

The range follows the model and effort you chose in Step 2, so settle those first:

FigureWhat it means
Minimum$0.01 per attempt. Below this the node does not deploy
TypicalWhat one attempt usually costs on this model, shown as a badge on the slider
MaximumThe model’s estimated worst case for a single attempt, which the card prefills. Anything above this buys nothing

Those figures come from the model, not your data. Actual item costs depend on how much the model has to read and write: a few short text fields usually cost well under the Typical amount, so a lower budget is safe. But a long document or an entire web page in an input field can far exceed it—the agent rereads its context at every step, so you pay for large inputs many times over. In those cases, keep the budget close to the maximum on those nodes.

Going below the typical cost is allowed but flagged: generation stops when the budget runs out, which can truncate a label and waste the retry. Changing the model or effort keeps your cap, so choose it again—worst cases can differ several-fold between models. If the budget is above the new model’s maximum, deployment is blocked; if it’s below the new model’s typical cost, you’ll get a warning.

Step 4 — Add extra guidance for the model (optional)

Section titled “Step 4 — Add extra guidance for the model (optional)”

If the model needs guidance beyond the main task instructions, tell the agent to add it for the LLM. This might be a tone to follow or an output quirk to avoid. You can also specify an edge case to watch. The agent adds the guidance on top of the node’s task instructions. Keep the task itself in the main instructions and use this only for model-specific notes. To check what is set, ask the agent to read the guidance back, or click Preview next to the Special LLM instruction box on the node’s Audience & Pricing card.

Ask the agent to show the node’s quality criteria and tell it what to change, or edit them by hand on the node’s Quality Requirements card. The shared review model is covered under Quality control. Every generated label is checked against these criteria, and a failing label is retried, so they decide both the quality you get and the tokens you spend. The agent lists each criterion with its pass and fail conditions. Make sure every output the node produces has at least one criterion and each pass condition describes exactly what you would accept.

Step 6 — Run the pipeline and check the results

Section titled “Step 6 — Run the pipeline and check the results”

Launch the run as you would for any pipeline. Each item goes through the generate-and-check cycle described above. If a label doesn’t pass the check, it’s regenerated and rechecked once—one retry, set by the platform and not configurable. Each labeled item is returned with its generated fields and a verdict for each quality criterion, just as if it had been labeled by experts with LLM review.

Wait until the run has finished, then export it. An export is a snapshot taken when you start it, so items that finish later are not included. In the export, each item lists its output fields and the per-criterion verdicts, each with a reason. A criterion on a repeating output field returns a list of verdicts, one per repetition. Most verdicts read pass or fail. Occasionally another state, such as skipped or error, appears when a check could not be completed for that item.

  • Quality review is done by an LLM, not people. Expert review runs on an expert workforce, which a synthetic node does not use, so review here is always by LLM.
  • Each check is a billed LLM call. Every quality criterion is checked with its own call, and once per repetition for a repeating output field. More criteria or repeating outputs raise the check cost even when every label passes.
  • Retries consume paid tokens too. A failed attempt is billed like any other generation, and both attempts share a single cap: twice your per-attempt budget.
  • Switching back to experts starts fresh. If you later ask the agent to use expert labelers again, it does not restore the audience, price, or review settings you had before. You set those again.