Il tuo primo spazio di lavoro

Cosa costruirai

Al termine di questo tutorial avrai:

• Uno spazio di lavoro intitolato al tuo progetto
• Un repository Git registrato al suo interno
• Cinque agenti inizializzati, uno dei quali configurato abbastanza bene da poter essere eseguito
• Un secondo spazio di lavoro vuoto che dimostra il confine di isolamento

L’onboarding ha già creato uno spazio di lavoro per te. Questo tutorial ne crea uno nuovo di proposito, così vedrai ogni parte del processo.

Prima di iniziare, scegli un checkout Git che soddisfi tutte e tre queste condizioni: il passaggio di registrazione rifiuta qualsiasi altro caso:

• si trova dentro un work tree git
• ha un remote origin
• quel remote punta a github.com, gitlab.com o bitbucket.org

Passaggio 1: crea uno spazio di lavoro

1. Fai clic sul chip dello spazio di lavoro nella barra del titolo
2. Scegli Aggiungi spazio di lavoro…
3. Inserisci un nome che identifichi il progetto, come “api-service” o “frontend-v2”
4. Facoltativamente, scegli un logo
5. Fai clic su Aggiungi spazio di lavoro

Control Center passa al nuovo spazio di lavoro e si apre sulla sua posta in arrivo (/workspaces/<id>/inbox).

Dietro le quinte, il server pubblica un evento WorkspaceCreated e inizializza lo spazio di lavoro con:

• un agente CEO, la cui persona è il coordinamento e la delega
• quattro specialisti — qa, architect, engineer e librarian — ciascuno con le proprie istruzioni e skill
• i modelli di pipeline integrati e le relative righe di trigger

Ogni spazio di lavoro che crei riceve tutto questo, non solo il primo.

Verifica: apri Impostazioni → Spazio di lavoro → Agenti. Nell’elenco ci sono cinque agenti, ciascuno con un anello di stato vuoto.

Passaggio 2: registra un repository

1. Vai su Impostazioni → Spazio di lavoro → Repository
2. Fai clic su Aggiungi repository
3. Sfoglia fino al tuo checkout. La finestra di dialogo esplora le cartelle sulla macchina che esegue cc_server — non sul tuo client — e resta all’interno delle radici che quel server espone (la home del suo utente per impostazione predefinita). Un checkout git riceve un’icona di cartella distinta e una casella di controllo; una cartella semplice non riceve né l’una né l’altra, quindi si possono selezionare solo i checkout.
4. Spunta uno o più checkout e registra il batch. Le selezioni sopravvivono mentre navighi, così puoi raccoglierne diversi in un solo passaggio e una scelta sbagliata non fa mai cadere le altre.

Control Center legge il remote origin di ogni checkout, risolve owner e repository e crea la riga del repository dentro questo spazio di lavoro. Non c’è un secondo passaggio per collegarlo: è la registrazione che gli assegna l’ambito.

Registrare lo stesso checkout in un altro spazio di lavoro in un secondo momento crea una seconda riga di repository indipendente, con un id proprio. Tra spazi di lavoro un checkout è identificato dal suo percorso nel filesystem, mai dall’id.

Verifica: il repository compare nell’elenco con il suo owner/repo e il branch corrente.

Passaggio 3: rendi eseguibile un agente

I cinque agenti appena inizializzati in questo spazio di lavoro non hanno adattatore né modello. L’invio li esegue su Control Center (built-in) e, non essendo impostato alcun modello, chiede ad Anthropic il suo valore predefinito: funzionano quindi solo se hai collegato un account Anthropic, e su un modello che non hai scelto se lo hai fatto. L’onboarding alla prima esecuzione imprime la propria scelta su ogni agente del primo spazio di lavoro, una sola volta; uno spazio di lavoro creato in seguito parte con tutti e cinque privi di impostazioni. Impostane uno adesso.

1. Apri Impostazioni → Spazio di lavoro → Agenti
2. Seleziona engineer nell’elenco
3. Nella scheda Impostazioni, imposta Adattatore su Control Center (built-in) e scegli un Modello da un fornitore che hai collegato in Impostazioni → Server → Fornitori di modelli
4. Premi Salva modifiche

Verifica: riapri l’agente e i due campi conservano le tue scelte.

Ogni agente porta con sé il proprio adattatore e il proprio modello, quindi ripeti l’operazione per qualsiasi altro agente che intendi usare. Crea e configura un agente copre il resto del modulo.

Passaggio 4: osserva il confine di isolamento

Crea un secondo spazio di lavoro dal chip nella barra del titolo, esattamente come nel passaggio 1. Poi osservalo:

• Impostazioni → Spazio di lavoro → Repository è vuoto. Il repository che hai registrato un minuto fa non c’è.
• Impostazioni → Spazio di lavoro → Agenti contiene cinque agenti, ma sono righe diverse: l’adattatore che hai impostato nel passaggio 3 non c’è più.
• L’elenco degli spazi, i ticket e la memoria sono tutti vuoti.

Non è trapelato nulla, perché non c’è nulla da cui trapelare: le righe di ogni spazio di lavoro vivono nel file di database di quello spazio di lavoro. Una lettura tra spazi di lavoro non è una query che viene filtrata, è una query che non ha dove essere eseguita. Eliminare uno spazio di lavoro equivale a scollegare un file.

Torna indietro con il chip nella barra del titolo, oppure apri Gestisci spazi di lavoro per vederli affiancati.

Per il modello completo, leggi Spazi di lavoro e isolamento.

Riepilogo

Hai creato uno spazio di lavoro, l’hai visto inizializzare un CEO e quattro specialisti, hai registrato un repository al suo interno, hai assegnato a un agente un adattatore e un modello e hai verificato che un secondo spazio di lavoro non ne condivida nulla.

Prossimo passo: Invia il tuo primo agente per mettere al lavoro lo spazio di lavoro.