Ask the user questions or present choices via an interactive form. Use when you need to gather preferences, clarify ambiguous instructions, get decisions on implementation choices, or present a list of options for the user to select from. Never write options or questions as plain text — always use this tool.
Ask the user questions or present choices via an interactive form. Use when you need to gather preferences, clarify ambiguous instructions, get decisions on implementation choices, or present a list of options for the user to select from. Never write options or questions as plain text — always use this tool.
You now have access to the interactive_form_question tool. Use it to ask the user questions during execution.
When to Use
Gather user preferences or requirements — before starting or when more detail is needed
Clarify ambiguous instructions — when the request could be interpreted multiple ways
Get decisions on implementation choices as you work — when a fork in the road requires user input
Offer choices on direction — let the user steer when multiple valid paths exist
Present any list of options to the user — whenever you would naturally write a numbered/bulleted list of choices for the user to pick from, use interactive_form_question instead
Never write options, choices, or questions as plain text or markdown lists — always call the tool.
Usage Notes
Users can always select "Other" to provide custom text input, even on choice questions — you don't need to add it manually
Use multi_select: true to allow multiple answers to be selected
If you recommend a specific option, set "recommended": true on that option — the frontend will display the recommended badge automatically. NEVER add "(Recommended)", "(推荐)" or any similar text to the label field — the badge is rendered by the frontend, not by text in the label
Always pass questions via questions=[...]. A single-question form is just a one-item questions array.
After receiving answers, call interactive_form_question again if follow-up questions arise — never ask in plain text
Behavior
interactive_form_question displays an interactive form and returns immediately . The current task ends silently and resumes when the user submits their answer as a new message.
Tool Parameters
questions (list, required): The full list of questions to render
interactive_form_question(
questions=[
{
"id": "cache_strategy",
"question": "I found two approaches for the caching layer. Which do you prefer?",
"input_type": "choice",
"options": [
{"label": "Option A — simple in-memory cache", "value": "simple", "recommended": true},
{"label": "Option B — Redis with TTL control", "value": "redis"}
]
}
]
)
