Invia il tuo primo agente

Cosa costruirai

Alla fine di questo tutorial avrai:

Un agente che hai creato e configurato da te
Uno spazio in cui tu e quell’agente parlate
Un’esecuzione completata, con lavoro committato in un worktree isolato e una riga nel log di esecuzione dell’agente

Prerequisiti: Il tuo primo spazio di lavoro completato, così questo spazio di lavoro ha un repo registrato e almeno un fornitore di modelli collegato.

Passaggio 1: crea un agente

Vai su Impostazioni → Spazio di lavoro → Agenti
Fai clic su Nuovo agente. Un agente chiamato «Agente senza nome» viene creato immediatamente e selezionato nel roster — non c’è alcuna finestra di creazione e nulla da confermare. Lo configuri sul posto.
Nella scheda Impostazioni, compila:
- Nome: qualcosa di breve e memorabile, come alice. È ciò che digiti dopo @.
- Titolo: cosa fa, es. «Ingegnere backend»
- Adattatore: Control Center (built-in). Scegli proprio questo — solo l’harness integrato può essere guidato a metà esecuzione e messo in pausa a un confine di turno, e non richiede alcuna CLI installata sull’host del server.
- Modello: scegli dall’elenco servito dal fornitore collegato
- Competenze: collega quelle che fanno al caso tuo, es. testing o architecture
Premi Salva modifiche

Checkpoint. La riga del roster mostra il nome del tuo agente e un anello di stato vuoto.

Passaggio 2: avvia uno spazio

Nella barra laterale, trova la sezione Spazi e fai clic sul pulsante +
Dai un nome allo spazio
Sotto Aggiungi agenti, seleziona l’agente che hai appena creato
Se lo spazio di lavoro ha dei repo, scegli su quali questo spazio deve lavorare
Fai clic su Crea

Lo spazio si apre. In background Control Center predispone un worktree copy-on-write dei repo selezionati per questa conversazione, sul suo branch. Il tuo checkout di origine non viene mai modificato.

Passaggio 3: invia un compito

Scrivi un compito concreto e piccolo sul repo che hai registrato. Qualcosa con un esito verificabile funziona meglio — aggiungi un test, correggi un lint, rinomina un simbolo.

Premi Invio. Non devi menzionare nessuno con @: con un solo agente nello spazio, un semplice messaggio lo risveglia. In uno spazio con più agenti, @name ne sceglie uno.

Control Center compone il prompt dalle istruzioni, dalla persona e dalle skill dell’agente e dal contesto dello spazio, poi invia l’esecuzione.

Checkpoint. Il pulsante di invio del composer diventa un pulsante di arresto — un agente sta lavorando in questa conversazione — e il testo inizia ad arrivare.

Passaggio 4: guardalo lavorare

La conversazione mostra l’esecuzione mentre accade:

Ragionamento, mostrato inline mentre l’agente pensa
Chiamate agli strumenti: letture e scritture di file, ricerche, comandi shell, ciascuna con il suo risultato
Testo: riepiloghi, spiegazioni e domande per te

Se l’agente chiede qualcosa, rispondi nella conversazione e riprende.

Per le metriche di un’esecuzione e i suoi controlli di pausa, ripresa e arresto, trova l’agente in esecuzione nella sezione Agenti del pannello Generale dello spazio e scegli Apri attività.

Nel pannello delle attività, il badge di stato mostra In esecuzione, poi Completato quando l’esecuzione termina. Un’esecuzione che si blocca o entra in loop mostra Bloccato; una che va in errore mostra Non riuscito. Nel registro degli agenti l’anello del roster è vuoto prima della prima esecuzione e pieno quando l’agente è di nuovo inattivo.

Che cosa delimita l’esecuzione: il suo worktree copy-on-write, le credenziali mediate al suo avvio e revocate alla dismissione, un ambiente ripulito, la superficie degli strumenti che la sua modalità consente e i guardrail delle azioni. Effetti come il push di un branch o l’apertura di una pull request sono controllati separatamente — vedi Guardrail.

Passaggio 5: controlla il risultato

Apri Impostazioni → Spazio di lavoro → Agenti e seleziona il tuo agente
Apri la scheda Log

Checkpoint. Una riga di esecuzione, che mostra stato, durata, ora di avvio e di completamento e l’adattatore su cui è stata eseguita.

Le modifiche dell’agente sono committate sul branch della conversazione, nel suo worktree. I commit sono attribuiti all’agente, con te accreditato in un trailer Co-Authored-By:.

Ottenere una pull request

Niente apre una pull request da solo. Se ne vuoi una, chiedila nella stessa conversazione:

Esegui il push di questo branch e apri una pull request verso il branch predefinito.

Il push (gitPush) e la creazione di PR (prCreate) richiedono entrambi la tua approvazione per impostazione predefinita, quindi aspettati una conferma prima di ciascuno. Se quando parte la richiesta non è collegato alcun approvatore, l’azione viene negata anziché consentita — i guardrail sono fail-closed.

La PR viene aperta con l’identità GitHub il cui token ha usato l’esecuzione — la tua, se hai salvato un token personale — non con il nome dell’agente. La paternità dell’agente si vede sui commit.

Puoi anche aprirla da solo: il pannello Controllo del codice dello spazio ha un pulsante Crea pull request che porta il branch della conversazione nella schermata di composizione, e Pull request → Nuova PR apre la stessa schermata vuota. È da lì che riprende il prossimo tutorial.

Riepilogo

Hai creato un agente, ne hai configurato l’adattatore e il modello, gli hai dato uno spazio e un compito e hai osservato un’esecuzione reale concludersi in un worktree isolato senza toccare il tuo checkout.

Prossimo: Revisiona la tua prima pull request per imparare il flusso di revisione.

Per saperne di più sugli agenti: Il modello degli agenti. Per i dettagli sull’invio: Ciclo di vita dell’invio degli agenti.