Skip to main content
The agent builds the screen your experts fill in for each item, called the labeling interface. You can check that screen and fix it by asking the agent or editing it yourself. This applies to the Generation and Quorum nodes, the two whose inspector carries a UI for Experts card. Review and fix the interface while the pipeline is still editable, before you deploy. Once a run is active the interface locks, as When editing is locked explains.

What the expert sees

At deploy, four parts of your build make up what the expert reads and fills in: the onboarding course first, if it is turned on, the Display name shown alongside the task, the written instructions, and the labeling interface covered on this page. Only the labeling interface is reviewed and fixed here. The Display name and instructions and the onboarding course are separate cards with their own rules.

Try the real screen

Open the node and find its UI for Experts card. The card has two tabs, View and Edit. View shows the real, interactive form with a sample item already filled in. The expert fills in this same form. Where the agent built the interface without choosing a sample, it filled the form with the dataset’s first item. The UI for Experts card on its View tab: the interactive form the expert fills in, rendered on a sample item. Fill in the form as an expert would. Check that every required input is shown and the controls collect the right answer. Then test a submission. The automatic User Interface Types Lint also checks that the interface compiles and collects answers in the expected format.

Fix it by asking the agent

Asking the agent is the usual way to change the interface. Describe the change in plain words: “add a comment box under the video”, “make the rating required”, “show the source text above the question”. The agent rebuilds the interface and saves it. The agent can also test the interface in ways the card cannot:
  • It catches build errors that would stop the form from rendering, before you see it.
  • It takes a screenshot of the rendered form and reads it back.
  • It fills the form and validates a complete submission end to end before it reports the interface done.

Fix it by hand

The Edit tab opens the editor with the sample data and the form preview side by side. Those two panes are all it shows on open — to reach the interface markup itself, switch on the View pane in the Layout bar. Then you change the interface and watch the preview update. There is no Save button: edits autosave about a second after you stop, and every save is a step you can undo. The markup language and its component set are not documented in this portal. Hand edits work best for small adjustments you can make by copying the patterns already in the markup — changing a label, reordering controls, tweaking a layout. For structural changes, or to add a component you do not see used yet, ask the agent: it knows the component set and validates the build. The Edit tab: the editor with the sample data pane on the left and the live form preview on the right. The sample data is a JSON object keyed by the node’s input fields, and its keys must match those inputs. A key the node does not read, or a missing value for a required input, blocks the deploy. See the sample-data errors. To change which inputs and outputs the node has, edit the node’s Datapoint Structure card or ask the agent. The interface only lays out fields that already exist.
Hand edits and agent edits change the same interface, and the last change wins. If you hand-tune the form and then ask the agent to rebuild it, the agent’s build replaces your edits with no warning and no prompt to confirm. Make your hand edits after the agent’s final pass, or tell the agent what to keep so it rebuilds around them.

Verify like an expert would

Annotation Quality Assurance requires quality criteria and LLM review: LLM Only or Hybrid on Generation, LLM Only on Quorum. Without LLM review, use View to preview the form. Open Annotation Quality Assurance on the node and add a case. Enter sample values in Task Input, then click Annotate with UI. Complete the form and submit it. The check validates your submission against the output fields and fills Task Output. Click Run to review the annotation against the node’s quality criteria. You can also enter Task Output as JSON, or ask the agent to prepare and run the case. After editing the interface, use Reannotate with UI and rerun the check. See Self-check for test results and deployment requirements.

When editing is locked

Both tabs stop accepting edits once the pipeline has an active run. Deploying locks the pipeline against every edit, including the interface (see One pipeline, one run). You can still open View to look at the form, but you cannot fill it, and Edit is disabled. After deploy, the agent refuses to change the interface and tells you to clone the pipeline into a new one to keep iterating. A failed deploy is the one exception. It frees the same pipeline to fix and deploy again.
  • Self-check — Annotation Quality Assurance, automatic lints, and the Issues gate.
  • Generation node — the node’s cards, its fields, and the Display name and instructions the interface sits beside.
  • Quorum node — the multi-expert labeling node that also carries a UI for Experts card, where each expert submits their own entry.
  • Pipeline errors and how to fix them — the sample-data and video-duration errors the interface can raise at deploy, verbatim, each with its cause and fix.