Come fermo un agente IA bloccato in un loop?

Mettilo in pausa al livello più stretto possibile. In Done, un agente bloccato chiama pause_task per togliere di mezzo un'attività, o pause_board per fermare l'intera esecuzione, e deve dire perché. Il lavoro in pausa resta fuori dalla coda di tutti gli agenti finché una persona non lo riprende nell'app; l'agente che l'ha messo in pausa non può riavviarlo. Puoi mettere in pausa anche tu dall'app.

Perché non basta un commento, o restituire l'attività?

Perché l'attività resta rivendicabile. Se un agente commenta e va avanti, l'agente successivo rivendica la stessa attività e sbatte contro lo stesso muro; se chiama decline_task, l'attività torna in coda perché ci sbatta qualcun altro. pause_task è l'unico strumento che impedisce al lavoro di essere ripreso subito, ed è ciò che vuoi quando un agente gira in tondo di notte.

Che differenza c'è tra pause_task e pause_board?

• pause_task prende un id e un motivo. Rilascia il claim dell'agente, tiene tutti gli agenti lontani da quell'attività (compreso quello che l'ha messa in pausa, alla prossima esecuzione) e l'agente prosegue con il resto della coda. Le scritture degli agenti su un'attività in pausa vengono rifiutate con un errore paused.
• pause_board prende un motivo, più un workspace_id se appartieni a più di uno spazio di lavoro. Nessun agente di quella bacheca riceve più lavoro: list_my_tasks e next_task rifiutano e restituiscono il motivo invece di una coda vuota, così l'esecuzione che trova la bacheca ferma registra perché, anziché «niente da fare». Il lavoro che un agente ha già in mano non resta bloccato: può ancora commentare, spuntare e chiudere un'attività in corso.

Perché l'agente non può riprendere ciò che ha messo in pausa?

Riprendere è un'azione umana nell'app, di proposito. Un agente che si è messo in pausa perché girava in loop potrebbe altrimenti rimettersi subito nel loop, e uno che potesse riavviare la bacheca potrebbe annullare lo stop di una persona. Se ci prova, riceve un rifiuto approval_required che lo rimanda a ask_decision. È lo stesso ragionamento della porta di approvazione: l'agente può fermare il lavoro, ma la decisione di continuare resta tua.

Il motivo è obbligatorio per un agente e facoltativo per una persona, che magari intende solo «non stanotte». Una pausa senza motivo sembrerebbe un'attività sparita in silenzio, quindi Done la rifiuta con un errore reason_required. Le persone non sono mai bloccate da una pausa: puoi ancora aprire, modificare e spostare un'attività in pausa.

L'agente deve mettere in pausa, chiedere o rifiutare?

• ask_decision, quando hai una domanda vera che una persona può chiudere in una riga. Tiene l'attività viva e rispondibile.
• decline_task, quando l'attività va bene e semplicemente non è di quell'agente.
• pause_task, quando è bloccato e non ha una domanda: gira in tondo, manca una credenziale o un accesso, l'attività così com'è scritta non si può fare, o si vede sul punto di spendere molto per nulla.
• pause_board, quando il muro non è di una sola attività: le credenziali dell'account sono sparite, ogni attività fallisce allo stesso modo, o l'agente gira tra le attività invece che dentro una.

Cosa vedo quando torno?

Il motivo dell'agente viene pubblicato nel thread dell'attività e mostrato sulla bacheca, così leggi su cosa è andato a sbattere e cosa aveva già provato. Per una pausa della bacheca, il motivo compare sullo spazio di lavoro e viene restituito a ogni successiva chiamata alla coda. Risolvi la causa, o rispondi alla domanda che non ha potuto chiudere, riprendi nell'app e il lavoro torna rivendicabile.