Questionnaire docs
Question types
Pick answer controls that match the decision pressure.
Answer types are rendering hints and pressure tools. The agent still decides what question should come next.
Supported types
- freeform: use when premature options would hide important context.
- single_choice: use when one direction must win.
- multi_choice: use when several constraints or concerns can apply.
- ranked_choice: use when options need explicit ordering.
- scale: use for confidence, urgency, severity, or fit.
- yes_no: use for binary gates that truly branch the run.
- file_upload: use for browser-side file metadata, not filesystem writes.
- matrix: use when multiple options need the same criteria.
- branching: use shallow declarative rules for existing next questions.
Recommended answer rule
Every question must include a recommended answer. The recommendation gives the user something concrete to accept, edit, or reject, and it exposes the agent's current interpretation.
Branching rule
Branching should stay shallow. A browser route may choose an existing next_question_id, but the agent remains responsible for creating new questions and keeping state coherent.