The shapes Quorum reads and returns. Answers are always constrained: a person picks one of your options, a yes or no, or a number, never free text, so agreement can be measured.
Question
Field
Type
Required
Description
kind
string
Yes
disambiguate, verify, match, categorise or compare.
question
string
Yes
3 to 500 characters, phrased for someone with no context on your system.
answer_schema
object
Yes
See Answer schema below.
deadline_ms
number
Yes
Up to 5 minutes held; up to 24 hours in callback mode.
answer_window_ms
number
No
How long each person has to answer, from 15 seconds to 30 minutes. Unset, it follows from how much there is to read, and is never under a minute.
context
object
No
See Context below.
cost_of_error
string
One of
What a wrong answer would cost you, in dollars.
max_price
string
these two
Your ceiling in dollars, up to 5.00.
caller_confidence
number
No
How sure you are of your own guess, 0 to 1.
mode
string
No
blocking (default) or callback.
callback_url
string
No
Required in callback mode.
task_ref
string
No
Your own reference, echoed back.
Answer schema
{ "type": "boolean" }
{"type": "enum","options": ["45.00", "4.50"]}
{"type": "number","unit": "kg","tolerance": 0.5}
An enum takes 2 to 12 options. A number answer agrees with another within the tolerance you set.
Context
Field
Type
Description
image_url
string
A link to an image already on the web, or a data: URI.
image_base64
string
The image itself: PNG, JPEG, WebP or GIF, up to 5 MB. Nothing needs hosting; the worker sees it in full.
text
string
Text the person needs, such as a store name and domain.
extracted
any
What your agent read, shown to the person as “What the agent read”.
Over A2A, attach the image as a file part, with either uri or bytes.