Como paro um agente de IA preso em um loop?

Pause no nível mais estreito que couber. No Done, um agente preso chama pause_task para tirar uma tarefa de jogo, ou pause_board para parar toda a execução, e precisa dizer por quê. O trabalho pausado fica fora da fila de todos os agentes até uma pessoa retomá-lo no app; o agente que pausou não consegue reiniciá-lo. Você também pode pausar pelo app.

Por que um comentário, ou devolver a tarefa, não basta?

Porque a tarefa continua podendo ser reivindicada. Se um agente comenta e segue em frente, o próximo agente reivindica a mesma tarefa e bate no mesmo muro; se chama decline_task, a tarefa volta para a fila para outro bater nela. pause_task é a única ferramenta que impede o trabalho de ser retomado na hora, que é o que você quer quando um agente anda em círculos durante a noite.

Qual a diferença entre pause_task e pause_board?

• pause_task recebe um id e um motivo. Ele solta o claim do agente, mantém todos os agentes longe dessa tarefa (inclusive o que pausou, na próxima execução) e o agente segue com o resto da fila. Escritas de agentes em uma tarefa pausada são recusadas com um erro paused.
• pause_board recebe um motivo, mais um workspace_id se você pertence a mais de um espaço de trabalho. Nenhum agente desse quadro recebe trabalho: list_my_tasks e next_task recusam e devolvem o motivo em vez de uma fila vazia, de modo que a execução que encontra o quadro parado registra por quê, em vez de «nada a fazer». O trabalho que o agente já tem não fica encalhado: ele ainda pode comentar, marcar e fechar uma tarefa em andamento.

Por que o agente não pode retomar o que pausou?

Retomar é uma ação humana no app, de propósito. Um agente que se pausou por estar em loop poderia voltar direto ao loop, e um agente que pudesse reiniciar o quadro poderia desfazer a parada de uma pessoa. Se tentar, recebe uma recusa approval_required que o encaminha para ask_decision. É o mesmo raciocínio da porta de aprovação: o agente pode parar o trabalho, mas a decisão de continuar é sua.

O motivo é obrigatório para um agente e opcional para uma pessoa, que talvez só queira dizer «hoje não». Uma pausa sem motivo pareceria a tarefa sumindo em silêncio, então o Done a recusa com um erro reason_required. Pessoas nunca ficam bloqueadas por uma pausa: você ainda pode abrir, editar e mover uma tarefa pausada.

O agente deve pausar, perguntar ou recusar?

• ask_decision, quando você tem uma pergunta real que uma pessoa resolve em uma linha. Mantém a tarefa viva e respondível.
• decline_task, quando a tarefa está boa e simplesmente não é desse agente.
• pause_task, quando está preso e não tem pergunta: anda em círculos, falta uma credencial ou acesso, a tarefa como escrita não dá para fazer, ou ele se vê prestes a gastar muito à toa.
• pause_board, quando o muro não é de uma tarefa: as credenciais da conta sumiram, toda tarefa falha do mesmo jeito, ou o agente gira entre tarefas em vez de dentro de uma.

O que vejo quando volto?

O motivo do agente é publicado no thread da tarefa e exibido no quadro, então você lê no que ele esbarrou e o que já tinha tentado. Em uma pausa de quadro, o motivo aparece no espaço de trabalho e é devolvido a cada chamada posterior à fila. Corrija a causa, ou responda à pergunta que ele não resolveu, retome no app e o trabalho volta a poder ser reivindicado.