Cosa fa
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.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
id | string | Obbligatorio | |
reason | string | Obbligatorio | Why you're handing it back. Posted as a comment. |
agent | string | Facoltativo | 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. |
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 lettura
readOnlyHint: false - Modifica dati nel tuo account Done.
- Distruttivo
destructiveHint: false - Aggiunge o legge soltanto; nulla di ciò che esiste viene rimosso o sovrascritto.
- Idempotente
idempotentHint: true - Chiamarlo due volte con gli stessi argomenti lascia lo stesso risultato di una sola chiamata.
- Mondo aperto
openWorldHint: 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:
“La revisione legale non spetta a te. Restituiscila e spiega perché.”
Collega Done al tuo assistente
Un endpoint MCP per account, con OAuth o con un token. La configurazione passo passo per ogni client: