Agenti AI

Un agente è una macchina con l'automator che prende un ticket e lo porta avanti da sola, un passaggio per volta. Quello che non fa da sola è decidere: i passaggi che contano restano a una persona. Di ogni lavoro resta scritto quale macchina ha fatto cosa, quando e com'è finita.

Dare il via libera a una macchina

Una macchina si registra da sola quando l'automator parte con il token dell'organizzazione. Appena collegata non lavora.

1. Apri Agenti e scegli la macchina.
2. Premi Certifica host. Da qui prende i lavori dei progetti che segue.

Revoca certificazione la ferma: non riceve più lavori nuovi, ma resta collegata. Non cancella niente di quello che ha fatto. Un lavoro già iniziato non le viene tolto: se non lo consegna, risulta interrotto.

In Dettagli e impostazioni scegli Chi fa il lavoro (Claude, Codex od OpenCode) e Chi rilegge il lavoro prima della consegna. Con due motori conviene che rilegga l'altro.

Quali ticket prendono

Un agente prende un ticket solo se una persona ha detto che può. Nel riquadro Agenti del ticket, alla voce Chi lo lavora, scegli Agenti oppure Una persona.

• Finché nessuno decide, il ticket è Da valutare e nessun agente lo prende.
• L'AI dà un parere («lo lascerei fare a un agente» o «lo terrei a una persona»). È solo un consiglio: decide comunque una persona.
• Torna alla valutazione automatica cancella la decisione e il ticket torna da valutare.

Dal terminale (serve il permesso di modificare i ticket):

cyi tickets eligibility ACME-12 --project acme-api --allow
cyi tickets eligibility ACME-12 --project acme-api --block --reason "tocca dati di produzione"
cyi tickets eligibility ACME-12 --project acme-api --auto

Anche con il via libera, un agente aspetta se il ticket dipende da un altro lavoro non ancora finito, o se ha una domanda aperta che blocca il lavoro.

Uno alla volta su ogni ticket

Quando una macchina prende un ticket, lo tiene in carico per un tempo limitato. Nel frattempo nessun altro, persona o agente, può cominciare lo stesso ticket. Mentre lavora la macchina rinnova la presa. Se si spegne, la presa scade e il ticket torna libero.

Anche una persona può prendere in carico un ticket dal terminale, così nessun agente lo comincia:

cyi tickets lease claim ACME-12 --project acme-api     # di base per 8 ore
cyi tickets lease renew ACME-12 --project acme-api
cyi tickets lease release ACME-12 --project acme-api

Il giro di un lavoro

Sempre nello stesso ordine: triage, piano, lavorazione, staging, produzione. Il passaggio dopo parte solo quando quello prima è chiuso.

Ogni passaggio consegna un pacchetto scritto, che leggi prima di decidere:

• Il piano: cosa cambia e perché, i rischi, i punti ancora aperti, le fonti, gli scenari da provare e quando il lavoro si potrà dire finito. In cima c'è una scheda breve in parole semplici con il livello di rischio. CloseYourIt alza il rischio da solo se il piano tocca il database, il deploy o la CI.
• Il resoconto del lavoro: cosa è stato fatto, quali file sono cambiati, quali test sono girati e con che esito, cosa è andato diversamente dal piano.
• Il blocco: quando la macchina si ferma, scrive perché e cosa serve da una persona.
• La rilettura: il giudizio di chi ha riletto il lavoro, con i problemi trovati in ordine di gravità.

Dove decidi tu

Il piano. Nessuna lavorazione parte prima che il piano sia approvato. Decide il CTO del progetto oppure, se il progetto non ne ha uno, il CTO dell'organizzazione. Si imposta in CTO del progetto e CTO dell'organizzazione.

• Approva il piano: la lavorazione parte. Le note che aggiungi finiscono nella discussione del ticket.
• Respingi: il motivo è obbligatorio. Il piano torna indietro e ne nasce una versione nuova.
• Chiedi precisazioni: la domanda va nella discussione del ticket e la richiesta resta in coda.
• Rivaluta: per i ticket vecchi. L'agente rilegge il codice di oggi. Se il lavoro è già fatto chiude il ticket, altrimenti riscrive il piano.

Il lavoro consegnato. Se i controlli automatici del codice passano, chi ha riletto lo accetta e la proposta non è cambiata, il lavoro va avanti da solo. Altrimenti si ferma e aspetta Approva il lavoro o Respingi.

La produzione. Dopo lo staging il rilascio aspetta 2 ore. Se in staging non compaiono errori nuovi, va in produzione da solo. Se compare un errore nuovo si ferma, e riparte quando l'errore viene risolto o ignorato (vedi Errori). Su ogni repository esce un rilascio alla volta.

Chi decide può premere Ferma sul rilascio che aspetta. Finché resta fermo, nessun rilascio di quel repository va in produzione. Sul ticket compare Ferma — serve una decisione: Sblocca e riprova lo fa ripartire, Chiudi la lavorazione lo ferma per sempre e il ticket torna alle persone.

Le richieste in Approvazioni non scadono. Se non rispondi, quel lavoro resta fermo e nessuno lo porta avanti al posto tuo.

Le Approvazioni

Aprendo CloseYourIt, la schermata iniziale ti mostra una sola decisione: quella ferma da più tempo. Decidi, e compare la successiva. Salta la rimette in coda per oggi, Rimanda a domani la toglie fino a domani mattina. Nessuna delle due decide niente.

Per vedere tutto l'arretrato apri Approvazioni dal menu, oppure premi g e poi a. Ci trovi piani, lavori consegnati, ticket in revisione, domande degli agenti e richieste di modifica ai segreti. Vedi solo quello che tocca a te.

1. Filtra per tipo, progetto o agente.
2. Premi Valuta sulla riga per leggerla tutta e decidere.
3. Per approvarne tante insieme, spunta le caselle a sinistra e premi Approva. In blocco non si respinge e non si scrivono note.

Le lavorazioni che riprovano da sole stanno a parte, in In corso, non serve te.

Le domande di un agente

Quando non capisce qualcosa, l'agente chiede invece di tirare a indovinare. La domanda compare nella scheda Domande del ticket e in Approvazioni.

• Rispondi sotto la domanda, non nella discussione.
• A volte l'agente propone da 2 a 4 risposte, una segnata Consigliata: un clic risponde. Puoi anche scrivere una risposta tua.
• Una domanda segnata Senza risposta il lavoro non prosegue ferma il ticket: nessun agente lo prende finché resta aperta. Appena rispondi riparte da solo.
• Se la domanda non serve più, premi Ritira.

Come si misura una macchina

Nell'elenco Agenti ogni macchina è Online, Offline o Fermo. Fermo vuol dire che non si fa sentire da troppo tempo: quasi sempre è bloccata, o spenta e dimenticata. Se risultano aperti lavori che la macchina non segnala, la pagina lo scrive.

Nella pagina della macchina, Rendimento mostra su 7, 30 o 90 giorni, oppure da sempre:

Tempi per passaggio divide ogni passaggio in approvati, respinti, falliti e interrotti. Respinto è un tuo giudizio. Fallito è un guasto. Interrotto vuol dire che la macchina si è spenta o ha perso il collegamento: non conta come sbaglio. Confronta mette più macchine una accanto all'altra sullo stesso periodo.