name: widget-forms description: Use when the agent should ask the user for structured input with an in-chat form, including single-select, multi-select, text fields, style pickers, or voice audition choices.
Widget Forms
Use the form tool instead of hand-writing markup: the editor chat renders the form as an interactive card and returns the user's structured answer.
Runtime Rule
Call ask_followup_questions. It serializes your fields into the editor's
native form card; the user's submission comes back as their next message.
Plan the whole questionnaire before calling the tool. Send one final form, not a trial form followed by a corrected form. The tool supports at most 12 fields; if the user asks for more questions, merge related prompts into combined fields before the first call.