Ask a human to decide

ask_decision

Escrita

O que faz

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.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`id`	`string`	Obrigatório	The task id
`question`	`string`	Obrigatório	The question, in one sentence
`kind`	`string`	Opcional	question = a fork; permission = may I do this outward-facing/irreversible thing; input = a value only they have Valores permitidos`questionpermissioninput`
`context`	`string`	Opcional	Why you're asking and what hangs on it — what you already ruled out, and the cost of each way
`options`	`string[]`	Opcional	2-4 concrete choices. Omit for a free-text answer.
`recommendation`	`string`	Obrigatório	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`	Opcional	True (default) parks the task until answered; false keeps working
`agent`	`string`	Opcional	Which agent is asking

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: false: Altera dados da sua conta do Done.
DestrutivadestructiveHint: false: Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: false: Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
Mundo abertoopenWorldHint: false: Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

Acesso totalPermitido
Token somente leituraRecusado
Token de um projetoRecusado
Token de um espaço de trabalhoPermitido

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“Se precisar que eu escolha entre os dois fornecedores, me pergunte e siga com outro trabalho.”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →