Gli ordini permanenti conferiscono al tuo agente autorità operativa permanente per programmi definiti. Invece di impartire istruzioni all’agente per ogni attività, definisci programmi con ambito, trigger e regole di escalation chiari, e l’agente opera autonomamente entro tali limiti: “Sei responsabile del rapporto settimanale. Compilalo ogni venerdì, invialo e avvia un’escalation solo se qualcosa non sembra corretto.”
Perché usare gli ordini permanenti
Senza ordini permanenti: devi impartire istruzioni all’agente per ogni attività, il lavoro di routine viene dimenticato o ritardato e tu diventi il collo di bottiglia.
Con gli ordini permanenti: l’agente opera autonomamente entro limiti definiti, il lavoro di routine viene svolto nei tempi previsti e tu intervieni solo per eccezioni e approvazioni.
Come funzionano
Gli ordini permanenti sono definiti nei file del tuo workspace dell’agente. L’approccio consigliato consiste nell’includerli direttamente in AGENTS.md (che viene inserito automaticamente in ogni sessione), affinché l’agente li abbia sempre nel contesto. Per configurazioni più grandi, puoi anche inserirli in un file dedicato come standing-orders.md e farvi riferimento da AGENTS.md.
Ogni programma specifica:
- Ambito - ciò che l’agente è autorizzato a fare
- Trigger - quando eseguire il programma (pianificazione, evento o condizione)
- Punti di approvazione - ciò che richiede l’autorizzazione umana prima di procedere
- Regole di escalation - quando fermarsi e chiedere aiuto
L’agente carica queste istruzioni a ogni sessione tramite i file di bootstrap del workspace (consulta Workspace dell’agente per l’elenco completo dei file inseriti automaticamente) e le esegue, in combinazione con i processi Cron per garantirne l’applicazione in base al tempo.
Inserisci gli ordini permanenti in AGENTS.md per garantirne il caricamento a ogni sessione. Il bootstrap del workspace inserisce automaticamente AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md e MEMORY.md, ma non file arbitrari presenti nelle sottodirectory.
Anatomia di un ordine permanente
Ordini permanenti e processi Cron
Gli ordini permanenti definiscono cosa l’agente è autorizzato a fare. I processi Cron definiscono quando avviene. Operano insieme:
Il prompt del processo Cron deve fare riferimento all’ordine permanente anziché duplicarlo:
Esempi
Esempio 2: operazioni finanziarie (attivate da eventi)
Esempio 3: monitoraggio e avvisi (continuo)
Schema esecuzione-verifica-resoconto
Gli ordini permanenti funzionano meglio se associati a una rigorosa disciplina di esecuzione. Ogni attività di un ordine permanente deve seguire questo ciclo:
- Esecuzione - Svolgere effettivamente il lavoro (non limitarsi a confermare l’istruzione)
- Verifica - Confermare che il risultato sia corretto (il file esiste, il messaggio è stato consegnato, i dati sono stati analizzati)
- Resoconto - Comunicare al proprietario cosa è stato fatto e cosa è stato verificato
Questo schema previene la modalità di errore più comune degli agenti: confermare un’attività senza completarla.
Architettura multiprogramma
Per gli agenti che gestiscono più ambiti, organizza gli ordini permanenti come programmi separati con limiti chiari:
Ogni programma deve avere:
- Una propria cadenza di attivazione (settimanale, mensile, basata su eventi, continua)
- Propri punti di approvazione (alcuni programmi richiedono una supervisione maggiore rispetto ad altri)
- Limiti chiari (l’agente deve sapere dove termina un programma e ne inizia un altro)
Procedure consigliate
Da fare
- Iniziare con un’autorità limitata ed estenderla man mano che aumenta la fiducia
- Definire punti di approvazione espliciti per le azioni ad alto rischio
- Includere sezioni “Cosa NON fare”: i limiti sono importanti quanto le autorizzazioni
- Combinare gli ordini con processi Cron per un’esecuzione affidabile basata sul tempo
- Esaminare settimanalmente i registri dell’agente per verificare che gli ordini permanenti vengano rispettati
- Aggiornare gli ordini permanenti in base all’evoluzione delle esigenze: sono documenti dinamici
Da evitare
- Concedere un’autorità ampia fin dal primo giorno (“fai ciò che ritieni migliore”)
- Omettere le regole di escalation: ogni programma necessita di una clausola che definisca “quando fermarsi e chiedere”
- Presumere che l’agente ricordi le istruzioni verbali: inserire tutto nel file
- Mescolare ambiti in un singolo programma: utilizzare programmi separati per ambiti separati
- Dimenticare di applicarli tramite processi Cron: gli ordini permanenti senza trigger diventano suggerimenti
Argomenti correlati
- Automazione: panoramica di tutti i meccanismi di automazione.
- Processi Cron: applicazione della pianificazione per gli ordini permanenti.
- Hook: script basati su eventi per gli eventi del ciclo di vita dell’agente.
- Webhook: trigger di eventi HTTP in entrata.
- Workspace dell’agente: dove risiedono gli ordini permanenti, incluso l’elenco completo dei file di bootstrap inseriti automaticamente (
AGENTS.md, SOUL.md, ecc.).
