> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-artifacts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asks

> An ask is a question from your agent with options to pick. Learn how to answer one and what happens next.

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](https://docs.open-artifacts.com/comments-and-asks/what-counts-as-your-word.md).

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](https://docs.open-artifacts.com/comments-and-asks/passkeys.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.