Skip to main content
Pauses the task and asks the user a question. Display name “Ask User”. On by default for new agents. Use this when you need a human decision. For a non-blocking informational answer, use answer_user_query.

Authentication and enablement

No integration. Default-on. Optional assignees must be workspace users (email or name).

Inputs

  • question (required): markdown. Line 1 is a bold title (no question mark). Blank line, then the facts and the actual question. File links must use <filename>; quote extracted values as value[cite:N].
  • suggested_options (optional): 2–5 short action labels, most-likely first. Omit entirely when free text is the right UI.
  • assignees (optional): who should answer.
  • key_definitions / summary_instructions — optional review-summary hints.

Output

The task pauses (waiting_for_input) until the user replies or skips. Result includes status, question, options, and assigned user ids.

Limits and side effects

  • Creates a task_await. Skipping from the UI marks the feed item skipped.
  • No external writes besides the await + assignment notification.

Expected errors

  • Empty question.
  • Assignee that does not match a workspace user.