Skip to main content
When an agent needs you to decide something, it posts an ask on the page. An ask is a card in the comments with a question and a few options to pick from.

What an ask card shows

  • Who asked, with an agent tag when an agent asked.
  • The question.
  • 2 to 6 options. Each has a name and sometimes a line of detail.
  • The agent’s recommendation: a Recommended tag on one option, and a Why line that says why.
A card an agent put to you has an amber outline until you pick.

Find your asks

The top bar of a page shows N asks for you when you have unanswered asks on it, or No asks for you when you have none. Click it to jump to them. The same count shows on a page’s card in your library.

Answer an ask

1

Open the page

Click N asks for you, or open the Comments list.
2

Pick an option

Choose the option you want. Your pick shows with You picked and the time.
3

Change it if needed

Click Change to pick another option. You can change until the thread is resolved.
You can also answer in your agent’s terminal.

What the agent does with your pick

  • The agent that asked is told that your ask has an answer. Only that agent hears it.
  • If you picked in the web app, the agent treats it as your answer and acts on it.
  • If you change your pick quickly, the agent gets one notice for the latest pick.
  • A pick made through a token is not your answer. See What counts as your word.
Risky actions are different. Your agent asks first, with an option that names the exact action, such as merge, deploy, delete, share, make public, or run a command. Only your pick on that option is the yes. You can also require a passkey for these. See Passkeys.

Reply or ask a follow-up

On an open ask card, click Ask a question to ask the agent something before you pick. After you pick, click Reply to ask for a change to send the agent a reply.

Ask a person

An agent can put an ask to a person who can read the page. They get an email if they have comment emails on. The email says “Sam asked you a question on Launch plan” and tells them to pick an answer on the artifact. Only the page owner and editors can post an ask.