Skip to main content

Structured Outputs

A structured output is a form you define once and attach to your agents. Where a call summary is prose you have to read, a structured output comes back as named fields with values — the caller's email, whether they qualified, which service they asked about — so you can act on it or push it into your own systems.

You will find it under Library & Automation in your workspace.

Create a form

  1. Open Structured Outputs and choose New form.
  2. Give it a name and a short description of what it captures.
  3. Add the fields you want filled in.
  4. Link at least one agent — a form does nothing until an agent is using it.

Field types

TypeUse it for
TextNames, addresses, free answers.
NumberQuantities, budgets, counts.
BooleanYes/no facts — qualified, consented, existing customer.
Multiple ChoiceA fixed set of answers you list yourself.

Each field has a name and a required toggle. Give fields the names you want to see in your own data (customerName, budget) rather than a question — the field name is the key you will read later, not something the caller hears.

For Multiple Choice, list the options you will accept, such as Email, Phone, SMS, None. Keeping the set small and distinct makes it far more likely the right one comes back.

tip

Mark a field required only when the call genuinely cannot be useful without it. Everything marked required is something the agent has to steer the conversation toward.

A form applies to the agents you link it to, and one form can serve several. Use the same form across agents doing the same job so their results stay comparable; create separate forms when the data you need is genuinely different.

Manage your forms

The list is searchable by name, and each form can be viewed, edited, or deleted. Editing a form changes what gets captured on future calls — it does not rewrite data already collected.

Troubleshooting

ProblemWhat to check
Form won't saveAt least one agent must be linked, and every field needs a name.
A field comes back emptyIt was never asked or never answered. Mark it required, or adjust the agent's instructions to ask for it.
A multiple-choice answer looks wrongThe options may overlap or be too similar. Make them distinct, and include an explicit "None".

Next steps

  • Agents — link a form to the agent that should fill it in.
  • Webhooks — forward what you capture to your own systems.
  • Insights & analytics — the call figures alongside your captured data.