O que faz
Hand a task back: takes it off your queue entirely (clears the assignee and your claim, and returns it to not_started) and posts your reason to the task's thread. Use it when a task was assigned to you but shouldn't be — wrong agent, out of scope, needs a human, or you can't make progress on it. This is the counterpart to claim_task, and the way to decline work now that update_task can't set assignee: you can always give work back, you just can't give it to yourself. Prefer release_task if you only need to drop the lease and leave the task assigned to you; prefer ask_decision if you can do the task but need a question answered first. reason is required — a task silently dropped off the queue looks exactly like one nobody got to.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Obrigatório | |
reason | string | Obrigatório | Why you're handing it back. Posted as a comment. |
agent | string | Opcional | Your agent id when running as part of a fleet — the one you claimed with. Declining fails while a different agent holds an active lease. |
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 leitura
readOnlyHint: false - Altera dados da sua conta do Done.
- Destrutiva
destructiveHint: false - Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
- Idempotente
idempotentHint: true - Chamá-la duas vezes com os mesmos argumentos deixa o mesmo resultado que chamá-la uma vez.
- Mundo aberto
openWorldHint: 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:
“A revisão jurídica não é sua. Devolva a tarefa e explique por quê.”
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: