User Interaction

These tools let agents pause their work and interact with the user when they need input or help.

ask_user_question

Presents the user with a question and a set of options to choose from.

ask_user_question(
  question: "Which format do you want the report in?",
  options: ["PDF", "CSV", "Markdown"]
)

Parameters

Parameter	Type	Required	Description
question	string	yes	The question to ask
options	array of strings	yes	Available answer options

The agent pauses and waits for the user to select an option. Once the user responds, the agent continues with their choice.

request_user_takeover

Asks the user to take over the browser session manually. This is useful when the agent hits something it can’t handle on its own, like a CAPTCHA, two-factor authentication, or a complex login flow.

request_user_takeover(
  reason: "A CAPTCHA appeared on the login page"
)

Parameters

Parameter	Type	Required	Description
reason	string	yes	Why user intervention is needed

The user gets a link to the browser’s debugger interface where they can interact with the page directly. Once done, the agent resumes control.