O que um agente de IA deve fazer quando precisa de uma decisão humana no meio da execução?

Um agente de IA que chega a uma decisão que não deveria tomar sozinho deve deixar uma pergunta específica na tarefa e seguir com outro trabalho, sem parar a execução inteira e sem adivinhar. No Done isso é a ferramenta ask_decision: ela publica uma única pergunta com a recomendação do agente, tira a tarefa da fila dele como needs_input, e o agente assume a próxima. Quando você responde, a tarefa volta para em andamento e é retomada numa execução posterior.

Por que não simplesmente parar e esperar, ou adivinhar?

As duas opções óbvias falham num agente que roda sem supervisão de madrugada. Parar significa que as outras onze tarefas da fila ficam intactas porque uma tinha uma bifurcação. Adivinhar significa que o agente escolhe resposta para uma pergunta cara de errar, e você descobre de manhã. Deixar a pergunta na tarefa mantém a execução produtiva e a decisão com você.

O que o ask_decision realmente faz?

• question: uma frase. Ela é publicada na tarefa, então você a lê onde o trabalho vive.
• recommendation: obrigatória. O agente precisa dizer o que faria sem resposta e por quê, para que responder seja um toque e não um ensaio.
• kind e options: uma pergunta, uma permissão ou um dado que só você tem, com opcionalmente de 2 a 4 escolhas concretas; sem options, a resposta é texto livre.
• blocking: true por padrão; a tarefa fica em needs_input e sai da fila do agente. Com blocking:false a tarefa continua na fila, o agente segue trabalhando e pega sua resposta depois.

Quando um agente deve perguntar em vez de decidir?

A orientação da própria ferramenta é estreita de propósito, porque perguntar a cada ambiguidade transforma o quadro no feed de comentários que ele veio substituir. O agente deve perguntar nestes casos e, no resto, decidir e dizer o que decidiu no resumo da execução:

• Gastar dinheiro.
• Qualquer coisa voltada para fora: um e-mail, uma publicação, uma resposta a um cliente.
• Qualquer coisa irreversível, ou uma bifurcação real em que errar sai caro.

O que acontece quando eu respondo?

Sua resposta fica registrada como comentário na tarefa, e uma tarefa parada por uma pergunta bloqueante volta para em andamento. O agente a encontra chamando list_open_decisions no início de uma execução, ou simplesmente next_task, que prioriza tarefas recém-respondidas porque o contexto delas já está escrito. Se duas pessoas respondem ao mesmo tempo, só uma resposta é registrada e a outra é avisada de que a pergunta já foi encerrada. Se o agente resolve a dúvida sozinho, withdraw_decision libera a tarefa. Só pode haver uma pergunta bloqueante aberta por tarefa.

Em que isso difere da aprovação?

A aprovação guarda o fim do trabalho: uma tarefa que não está marcada como auto-OK não chega a concluída até você aprovar. O ask_decision acontece no meio e não é uma aprovação: responder nunca conclui nada. Os dois não colidem: uma pergunta bloqueante não pode reabrir uma tarefa já concluída ou aguardando seu aval, então nelas o agente pergunta com blocking:false e o pedido original não se perde.