Automazioni

Come funzionano le esecuzioni di Letaido per te secondo una pianificazione. Due tipi: una esegue un piccolo programma che l'agente ha creato per te; l'altra risveglia l'agente e gli permette di fare il lavoro da solo.

Descrivi cosa vuoi fare e quando. L'agente scrive l'automazione, sceglie una pianificazione, chiede l'approvazione una volta e la esegue da quel momento in poi. L'output di ogni esecuzione (stdout, stderr, codice di uscita) viene memorizzato in modo che tu possa rivederlo in seguito.

Due tipi di automazioni

1. Automazione tramite script

L'agente scrive un piccolo programma una volta sola, poi lo esegue per te secondo una pianificazione. Veloce, economico e prevedibile: i passaggi non cambiano tra un'esecuzione e l'altra. Usalo quando l'attività è meccanica e l'output ha lo stesso aspetto ogni settimana.

Example asks:

• "Ogni lunedì alle 9, recupera i delta delle parole chiave della settimana scorsa e inviami un messaggio su Slack."
• "Il primo giorno di ogni mese, archivia i dati del mese scorso nell'archivio dei report."
• "Ogni ora, aggiorna la cache di Brand Radar in modo che la dashboard si carichi istantaneamente."

2. Automazione degli agenti

Invece di eseguire un programma salvato, la pianificazione risveglia l'agente con un'istruzione scritta (il prompt). L'agente la legge da zero ogni volta, guarda cosa c'è nella tua area di lavoro in quel momento e decide come agire, nello stesso modo in cui farebbe in una chat con te.

Usalo quando il lavoro richiede valutazione, quando la situazione cambia tra un'esecuzione e l'altra, o quando vuoi che l'agente apporti piccoli miglioramenti a ogni ciclo e che questi miglioramenti si accumulino nel tempo.

Example asks:

• "Ogni giorno alle 9 UTC, controlla cosa è cambiato nell'area di lavoro e aggiorna il wiki del team." (Questa è l'automazione Sincronizzazione wiki nell'elenco sopra, trattata nella sezione successiva.)
• "Ogni venerdì pomeriggio, controlla i dati dei concorrenti della settimana e dimmi cosa merita la mia attenzione lunedì."
• "Ogni lunedì, controlla questa bozza di landing page, trova il singolo miglioramento più importante e applicalo." Eseguilo per alcune settimane e la pagina si riscrive da sola: guarda cosa succede dopo molti cicli.

Automazioni gestite (preinstallate da Letaido)

Alcune automazioni vengono fornite preinstallate in ogni Area di lavoro e si aggiornano automaticamente man mano che Letaido le migliora. La prima automazione gestita è Wiki sync, un'automazione Agent che viene eseguita quotidianamente e mantiene aggiornata la memoria a lungo termine della tua Area di lavoro in ~/workspace/wiki/ distillando nuove sessioni di chat, modifiche ai file e caricamenti.

La cartella wiki/ è una prova di concetto per la memoria a lungo termine dell'area di lavoro: un posto dove l'agente registra decisioni, entità nominate, convenzioni e lavoro recente in modo che le chat future possano riprendere da dove si erano interrotte quelle passate. La sincronizzazione wiki è ciò che la mantiene aggiornata senza che tu debba ricordarti di aggiornarla.

Le automazioni gestite sono contrassegnate come preinstallate nella scheda Automazioni e sono di sola lettura per impostazione predefinita. Se vuoi personalizzarne una, fai clic su Personalizza per creare una copia modificabile. La tua copia rimane nella tua Area di lavoro; l'originale continua a funzionare con gli aggiornamenti di Letaido.

Trigger (in arrivo)

Oggi tutte le automazioni vengono attivate da cron. La prossima ondata aggiungerà trigger basati su eventi in modo che un'automazione possa attivarsi quando succede qualcosa in un'app connessa: viene aperta una nuova PR su GitHub, un'opportunità di HubSpot passa a Closed-Won, viene pubblicato un messaggio Slack in un canale specifico.

Questo sblocca pattern come:

• "Ogni volta che viene aperta una nuova PR nel nostro repository principale, avvia Claude Code e Codex per eseguire una revisione della sicurezza, quindi pubblica il riepilogo congiunto in #engineering."
• "Ogni volta che qualcuno pubblica in #incoming-leads su Slack, cerca l'azienda in Ahrefs e rispondi con un riepilogo del contesto di 4 righe."

Fino ad allora, puoi già agire sugli eventi di terze parti oggi combinando un'automazione Scripted che interroga la coda dei webhook con le sottoscrizioni descritte in Webhooks & triggers. Slack, GitHub, HubSpot, Linear, Notion, Webflow e una dozzina di altri provider consegnano già eventi in quella coda; lo script pianificato con cron li preleva semplicemente e agisce.

Quando richiedere un'automazione invece di un'intervento singolo

La forma della richiesta ti dice quale vuoi.

• Se dici "ogni lunedì", "ogni trimestre", "ogni volta che succede X": automazione.
• Se dici "questo lunedì", "adesso", "per questo URL specifico": esecuzione singola via chat.

Un'operazione singola, al contrario, è qualsiasi cosa tu voglia fare una sola volta in questo momento:

• "Estrai i dati della scorsa settimana e dammi il riepilogo."
• "Controlla questa lista di 100 URL e dimmi quali restituiscono un errore 404."

Come si presenta l'approvazione

La prima volta che viene registrata un'automazione, vedi una scheda di approvazione con:

• Il nome e la descrizione di una riga.
• La pianificazione (espressione cron).
• Il tipo (Scripted o Agent).
• Il modello e il limite di contesto (per le automazioni Agent).
• Il corpo dello script o il corpo del prompt.

Il proprietario o l'amministratore fa clic una volta. Dopodiché, l'automazione viene eseguita secondo la pianificazione. Puoi metterla in pausa, riprenderla, attivarla manualmente (Esegui ora), personalizzarla o eliminarla dalla scheda Automazioni.

Pianificazioni comuni

Gli orari cron sono in UTC su questo host. Se hai bisogno di un fuso orario locale, l'agente sceglierà un orario UTC che corrisponde al tuo orario locale tutto l'anno, oppure aggiungerà una protezione zoneinfo nello script che agisce solo quando l'orario locale è nella finestra giusta. L'ora legale è fastidiosa; l'agente ti avvisa quando crea problemi.

Dipendenze

Se un'automazione richiede un pacchetto Python o un connettore non ancora approvato, l'agente:

1. Verifica se la dipendenza esiste.
2. In caso contrario, richiedi l'installazione o l'approvazione del connettore tramite il flusso di approvazione standard.
3. Attendi che il proprietario/amministratore approvi.
4. Quindi registra l'automazione.

Puoi vedere una scheda di approvazione per la dipendenza, una per l'automazione. L'agente di solito raggruppa le richieste correlate in modo che tu faccia clic una volta per l'intero flusso anziché tre volte.

Quali automazioni sono in esecuzione in quest'area di lavoro

Puoi elencarli dalla scheda Automations nella tua Area di lavoro. Il sito della documentazione che stai leggendo è gestito da tre di essi:

• Sincronizzazione wiki (giornaliera, gestita da Letaido): un'automazione Agent che legge le nuove sessioni di chat, le modifiche ai file e i caricamenti, e li sintetizza nella wiki dell'area di lavoro in ~/workspace/wiki/. Questa è la memoria a lungo termine su cui si basano le due automazioni successive.
• Sincronizzazione documentazione (ogni 30 minuti): un'automazione Scripted che legge il markdown da ~/workspace/docs/, lo converte in HTML e lo pubblica sul sito pubblico in modo che i visitatori vedano l'ultima versione entro mezz'ora.
• Suggerimenti di aggiornamento automatico della documentazione (lunedì alle 10:00 Europe/Bucharest): un'automazione Agent che legge la wiki, elenca le modifiche apportate all'area di lavoro nell'ultima settimana e propone modifiche specifiche per capitolo che Andrei può rivedere. Solo suggerimenti; nessuna pubblicazione automatica.

Limiti

• L'esecuzione di un'automazione scade dopo 1 ora. I lavori più lunghi dovrebbero essere suddivisi in fasi e scrivere lo stato intermedio nel database.
• stdout e stderr sono limitati a 50 KB per esecuzione. Qualsiasi cosa più grande dovrebbe andare in un file o in una riga del database.
• Le pianificazioni sono gestite dalla piattaforma dopo l'approvazione. Per modificare una pianificazione, l'agente registra una nuova automazione e rimuove quella vecchia; non modifica silenziosamente il cron.

Sotto il cofano. Ogni automazione è una riga nella tabella delle automazioni della piattaforma più una voce crontab. Il runner esegue lo script tramite shell (Scripted) o avvia una nuova chat dell'agente con il prompt salvato (Agent) con stdin/stdout/stderr acquisiti, imposta una variabile d'ambiente per l'ID di esecuzione e scrive il record di esecuzione. Se uno script importa qualcosa che non è installato a livello di sistema, l'esecuzione fallisce rapidamente con un errore chiaro nella cronologia delle esecuzioni.