Blog

Come pongo un limite a un agente IA che lavora di notte?

Due limiti impediscono a un agente non sorvegliato di bruciare tutta la tua coda: un budget per attività che Done applica a start_run e un tetto per l’intera notte che l’agente consulta tra un’attività e l’altra. Cosa applica ciascuno e cosa no.

Di Alejandro Rioja6 min di lettura

Usa due limiti, perché fermano cose diverse. Un budget per attività (chiamate di strumenti, minuti o entrambi) limita quanto può consumare una singola attività, e Done lo applica: start_run viene rifiutato quando l’attività ha speso tutto il budget. Un tetto notturno (attività, minuti, chiamate di strumenti) limita l’intera sessione, e deve essere l’agente a chiederlo: chiama check_night_budget tra un’attività e l’altra e si ferma quando la risposta dice stop. Nessuno dei due interrompe un processo a metà di una chiamata. Done non esegue il tuo modello: un limite è qualcosa che viene detto all’agente e di cui il registro gli chiede conto, non un interruttore di spegnimento.

Perché un solo limite non basta?

Un budget su una singola attività non vede le altre undici. Un agente che gestisce ogni attività entro il suo budget può comunque lavorarle tutte in una notte. Anche il contrario fallisce: un tetto notturno senza budget per attività lascia che un’attività ostinata si mangi l’intera dotazione. Il limite per attività contiene la peggiore singola attività; quello notturno contiene la somma.

Come funziona il budget per attività?

Una persona imposta budget_tool_calls e/o budget_minutes su un’attività. Un agente non può impostare né alzare il proprio: create_task e update_task rifiutano quei campi, e la sua via per averne di più è ask_decision, che lo chiede a te.

  • start_run apre un’esecuzione sull’attività e restituisce il budget e l’uso cumulato finora, così l’agente può regolarsi. Se l’attività ha già speso tutto il budget nelle esecuzioni precedenti, start_run viene rifiutato con budget_exceeded, e una persona deve alzare il budget o prendere in carico l’attività.
  • check_budget legge il budget residuo senza aprire un’esecuzione. A metà attività, over_budget: true significa fermarsi e restituire il controllo.
  • end_run registra quanto ha speso l’esecuzione. Un’esecuzione che supera il budget può comunque essere chiusa; viene registrata come over_budget. Lo stop deciso sta quindi all’inizio di un’esecuzione, non nel mezzo.

Come funziona il tetto per l’intera notte?

In Account e impostazioni → Dove lavorano gli agenti → Routine notturna scegli quando un’esecuzione deve fermarsi: dopo un certo numero di attività, minuti o chiamate di strumenti. L’agente chiama check_night_budget tra un’attività e l’altra. Restituisce tetto, usato e residuo per ogni dimensione, più stop e un motivo. La finestra predefinita sono le ultime 12 ore, così la spesa della notte scorsa non conta contro quella di stanotte.

I totali sono contati dalle esecuzioni registrate sul tuo account, non da un contatore nella memoria dell’agente. Se la routine si blocca e riparte a metà notte, ritrova gli stessi totali invece di ripartire da zero e raddoppiare la notte senza che nessuno se ne accorga. Contano contro i tuoi tetti solo le tue esecuzioni; quelle di un collega in uno spazio condiviso no.

Quando stop è true, l’istruzione all’agente è: end_run con un riepilogo, release_task perché la presa in carico non lasci l’attività bloccata, e lasciare il resto in coda. Il riepilogo conta. Una notte fermatasi a quattro attività su otto sembra «tutto gestito» se l’agente non dice cosa ha lasciato.

Done ferma davvero l’agente al tetto notturno?

No. check_night_budget è consultivo: è una lettura che dice all’agente di fermarsi. Un agente che non lo chiama mai non viene mai fermato da esso. Il pulsante Copia il prompt del runner in Dove lavorano gli agenti (l’istruzione che segue la tua esecuzione pianificata) dice all’agente di chiamare start_run all’inizio, check_night_budget prima di ogni attività e end_run alla fine; un’esecuzione costruita su di esso lo fa. Se scrivi un tuo runner, inserisci quelle tre chiamate.

Ciò che vale comunque, qualunque cosa faccia l’agente: il gate di approvazione. Qualunque cosa spenda, un’attività non contrassegnata agent_ok arriva a «fatto» solo con la tua approvazione; una notte fuori controllo produce quindi una coda di revisione più lunga, non un mucchio di attività chiuse. E pause_board, o la pausa nell’app, smette di assegnare lavoro a tutti gli agenti della bacheca finché non riprendi. Può chiamarla anche l’agente, se vede che l’intera esecuzione sta andando male.

Come vedo quanto è costata davvero una notte?

Ogni esecuzione lascia una traccia nell’attività del task, con chiamate di strumenti, minuti e, se l’agente li riporta, token, più un trace_url facoltativo alla trascrizione della sessione. get_agent_economics riporta esecuzioni, chiamate di strumenti e minuti per agente e il tasso di approvazione di quel lavoro, solo in unità. Done non memorizza alcuna cifra in valuta, quindi non ti darà dollari.

Una configurazione iniziale ragionevole

  • Lascia girare senza sorveglianza solo attività con criteri di accettazione, così l’agente sa cosa significa «fatto».
  • Imposta un budget di chiamate di strumenti per attività su tutto ciò che è aperto; lascia senza tetto le attività brevi.
  • Imposta un tetto notturno che si fermi ben prima di darti fastidio: poche attività e un limite di tempo, poi alzalo dopo qualche notte andata bene.
  • Usa il prompt del runner, oppure assicurati che il tuo runner chiami start_run, check_night_budget e end_run.
  • Leggi Needs you al mattino: cosa è stato consegnato, cosa attende approvazione, cosa attende una risposta.

Domande frequenti

Un agente IA può alzare il proprio budget?

No. create_task e update_task rifiutano budget_tool_calls e budget_minutes. Per chiedere di più, l’agente chiama ask_decision e decide una persona.

Cosa succede quando un’attività finisce il budget?

start_run viene rifiutato con budget_exceeded, quindi nessuna nuova esecuzione può iniziare su quell’attività finché una persona non alza il budget o la prende in carico. Un’esecuzione già in corso non viene interrotta; se supera il budget, end_run la registra come over_budget.

Done applica il tetto notturno?

No, è consultivo. check_night_budget riporta tetti, uso e un flag stop, e l’agente deve fermarsi quando lo indica. Il prompt del runner che ti dà Done include quel controllo; un runner personalizzato deve chiamarlo.

Il tetto notturno si azzera se la mia routine si blocca e riparte?

No. L’uso viene sommato dalle esecuzioni registrate sul tuo account nella finestra (12 ore per impostazione predefinita), quindi un riavvio vede gli stessi totali invece di ripartire da zero.

Come fermo tutti gli agenti insieme?

Metti in pausa la bacheca. Nessun agente riceve lavoro finché non riprendi. Vedi l’articolo sulla pausa di un agente bloccato in un ciclo per la differenza tra mettere in pausa un’attività e la bacheca.

Continua a leggere

Fai completare all’IA la tua lista di cose da fare.

Gratis per iniziare. Senza carta.