Sviluppo ottimizzato per gli agenti

Cloud Workstations fornisce un ambiente di runtime ottimizzato per agenti di codifica AI autonomi e interattivi, come Antigravity CLI e Claude Code. Quando esegui workflow di sviluppo agentici, gli agenti eseguono spesso attività asincrone a lunga esecuzione (come la generazione di codice, il refactoring approfondito e l'esecuzione dei test) o si mettono in pausa in attesa dell'input e della revisione da parte dell'utente.

I timeout di inattività standard delle workstation possono arrestare ed eliminare le VM delle workstation effimere durante lunghi periodi di inattività, terminando il container e richiedendo la reinizializzazione del contesto dell'agente. Lo sviluppo ottimizzato per gli agenti risolve questo problema combinando due funzionalità chiave:

1. Sospensione della workstation (IdleAction.SUSPEND): questa funzionalità sospende automaticamente la VM della workstation quando raggiunge il timeout di inattività anziché arrestarla. La sospensione della workstation salva la RAM, i processi in esecuzione, i file aperti e il contesto dell'agente attivo della macchina virtuale nello spazio di archiviazione permanente, interrompendo al contempo i costi di calcolo di vCPU e memoria.
2. Hook keep-alive del ciclo di vita: questi hook consentono agli agenti AI di eseguire uno script keep-alive in background (/google/scripts/keep_alive.sh) durante l'elaborazione attiva per evitare timeout e di terminare lo script quando sono in attesa dell'input utente o dopo aver completato le attività, consentendo alla workstation di entrare in uno stato di inattività e di sospendersi.

Come funziona l'ottimizzazione degli agenti

L'ottimizzazione degli agenti garantisce uno stato persistente, l'efficienza dei costi e un funzionamento senza interruzioni durante le attività a lunga esecuzione:

• Elaborazione attiva: quando un agente inizia a eseguire le istruzioni dell'utente, un hook del ciclo di vita avvia /google/scripts/keep_alive.sh in background. Questo script invia segnali keep-alive periodici che impediscono a Cloud Workstations di contrassegnare la workstation come inattiva.
• In attesa dell'input utente o del completamento dell'attività: quando l'agente completa il suo lavoro o si mette in pausa per chiedere allo sviluppatore di eseguire una revisione o fornire input aggiuntivi, un hook di evento termina il processo keep-alive in background.
• Sospensione automatica: senza segnali keep-alive attivi o traffico in entrata, il timer di inattività della workstation esegue il conto alla rovescia fino alla soglia di timeout di inattività configurata. Al raggiungimento del timeout, Cloud Workstations imposta la workstation su STATE_SUSPENDED anziché arrestarla.
• Ripresa immediata: quando lo sviluppatore torna e si riconnette (tramite la Google Cloud console, un IDE o SSH), la workstation riprende immediatamente dallo spazio di archiviazione permanente con lo stato completo dell'agente, le sessioni del terminale e il contesto dello spazio di lavoro intatti.

Configurare la sospensione della workstation

Per abilitare la sospensione della workstation, aggiorna la configurazione della workstation con un idleAction impostato su SUSPEND e una durata idleTimeout in secondi, ad esempio 1800s per 30 minuti.

Seleziona la scheda relativa alla modalità di utilizzo degli esempi in questa pagina:

gcloud workstations configs create CONFIG_NAME \
  --cluster=CLUSTER_NAME \
  --region=LOCATION \
  --idle-timeout=1800 \
  --idle-action=suspend