Ask a human to decide

ask_decision

Scrittura

Cosa fa

Park a question for the human and MOVE ON — the one way to involve them without ending your run. Use this the moment you hit something you shouldn't decide alone: spending money, anything outward-facing (an email, a post, a reply to a customer), anything irreversible, or a genuine fork where guessing wrong is expensive. Everywhere else, decide it yourself and say what you decided in your run summary — an ask for every ambiguity turns this into the comment feed it replaced. recommendation is REQUIRED: say what you'd do absent an answer, so answering is one keystroke rather than an essay. Give 2-4 options when the answer is a choice; omit them for free text. blocking:true (the default) parks the task as needs_input and drops it out of your queue — go work something else, and read the answer next run via list_open_decisions or get_task. blocking:false leaves the task in your queue so you keep working and pick the answer up later. Only ONE open blocking question per task. This is NOT an approval and never completes anything.

Parametri

Nome	Tipo	Obbligatorio	Descrizione
`id`	`string`	Obbligatorio	The task id
`question`	`string`	Obbligatorio	The question, in one sentence
`kind`	`string`	Facoltativo	question = a fork; permission = may I do this outward-facing/irreversible thing; input = a value only they have Valori ammessi`questionpermissioninput`
`context`	`string`	Facoltativo	Why you're asking and what hangs on it — what you already ruled out, and the cost of each way
`options`	`string[]`	Facoltativo	2-4 concrete choices. Omit for a free-text answer.
`recommendation`	`string`	Obbligatorio	Required, and the most useful field here — a bare label is not enough. Name the option you'd take AND why, in a sentence or two: what tipped it, and what the cost of the other way is. "Reuse existing ID — a new one re-triggers install review for every connected workspace, and the payload flag is backward compatible." beats "Reuse existing ID". Lead with the option's exact wording so the UI can highlight it.
`blocking`	`boolean`	Facoltativo	True (default) parks the task until answered; false keeps working
`agent`	`string`	Facoltativo	Which agent is asking

Annotazioni

Le indicazioni che il server invia con questo strumento. Un client le legge per decidere se chiederti il permesso prima di una chiamata.

Sola letturareadOnlyHint: false: Modifica dati nel tuo account Done.
DistruttivodestructiveHint: false: Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
IdempotenteidempotentHint: false: Ogni chiamata può aggiungere qualcosa di nuovo, come un commento, un’esecuzione o un’attività.
Mondo apertoopenWorldHint: false: Tocca solo il tuo account Done.

Quali token possono chiamarlo

Una connessione fatta con OAuth ha accesso completo. Un token creato in Impostazioni → Accesso degli agenti → Token MCP aggiuntivi si può restringere, e un token ristretto non vede mai oltre il suo progetto o spazio di lavoro.

Accesso completoConsentito
Token di sola letturaRifiutato
Token per un progettoRifiutato
Token per uno spazio di lavoroConsentito

Provalo

Con Done collegato, chiedi al tuo assistente qualcosa come:

“Se hai bisogno che scelga tra i due fornitori, chiedimelo e continua con altro.”

Collega Done al tuo assistente

Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client:

Panoramica della configurazione MCP →