Salta ai contenuti

Usa gli spazi

Questa guida mostra come usare gli spazi. Uno spazio è la superficie di messaggistica in Control Center: una stanza con ambito di spazio di lavoro, con uno o più partecipanti (tu e/o agenti), che possiede un worktree copy-on-write per ogni repo per cui è stato creato.

Le stanze uno-a-uno e quelle con più agenti sono entrambe semplicemente spazi, distinti solo dal numero di partecipanti che hanno. L’unica eccezione sono gli spazi che gli agenti aprono per parlarsi tra loro — vedi Spazi agente-agente qui sotto.

  1. Vai su Spazi
  2. Fai clic sul pulsante + accanto al titolo Spazi
  3. Assegna un nome — è obbligatorio. Un nome vuoto viene rifiutato; la finestra di dialogo resta aperta
  4. Facoltativamente, aggiungi agenti dallo spazio di lavoro
  5. Se lo spazio di lavoro ha dei repo, scegli per quali questo spazio prepara i worktree. Sono tutti selezionati per impostazione predefinita; deselezionando ogni repo si crea uno spazio senza nulla estratto
  6. Conferma

Gli spazi sono circoscritti allo spazio di lavoro: vedi solo gli agenti dello spazio di lavoro corrente e uno spazio non mostra mai dati di un altro spazio di lavoro.

Ogni repo viene estratto in repos/<name>/ all’interno dello spazio. Un repo che fornisce le proprie skill per gli agenti le mette a disposizione dell’agente che vi sta lavorando — un set di un repo alla volta, che cambia man mano che l’agente si sposta. Dal composer puoi raggiungerle tutte con /skill:<repo>:<name>. Vedi Skill con ambito di repository.

La superficie si trova in /workspaces/<id>/spaces, e un singolo spazio in /workspaces/<id>/spaces/<spaceId>.

Uno spazio nuovo parte con la modalità predefinita. Cambiala dal menu a discesa della modalità, all’estrema sinistra della barra degli strumenti del composer — non dalla finestra di creazione (che non ha alcun campo per la modalità) e non dall’intestazione dello spazio.

Modalità Effetto
Agente Accesso completo. Quella predefinita; chat internamente, etichettata «Agente» nel menu a discesa
Piano Solo lettura e ricerca; il risultato è un piano tipizzato
Orchestrazione Lettura e ricerca più un unico verbo propose_orchestration; il piano viene eseguito solo dopo la tua approvazione

Shift+Tab passa dalla modalità piano a quella agente senza aprire il menu a discesa.

Esiste una quarta modalità, Revisione, ma non è offerta nel menu a discesa: viene applicata automaticamente agli spazi di revisione delle PR.

La modalità è memorizzata sullo spazio, quindi lo stesso agente può trovarsi in modalità piano in uno spazio e in modalità agente in un altro. Ogni conversazione all’interno di uno spazio condivide la modalità di quello spazio.

Vedi Modalità per il modello completo.

Gestisci i partecipanti e l’autonomia per agente

Sezione intitolata “Gestisci i partecipanti e l’autonomia per agente”

Fai clic sull’icona delle persone nell’intestazione dello spazio per aprire Gestisci partecipanti. Per ogni agente già presente nello spazio puoi:

  • Rimuoverlo dallo spazio
  • Impostare la sua Autonomia per questo spazio: Predefinito, Solo proposta, Agisci con approvazione o Agisci liberamente

Il quadrante dell’autonomia è per (spazio, agente), quindi un agente di cui ti fidi in una stanza può essere tenuto a sola proposta in un’altra.

Passa il mouse su un messaggio e fai clic sull’icona del sorriso per aprire la tavolozza delle reazioni. È un set fisso di sei: 👍 👎 🎉 ❤️ 👀 ✅. Non esiste alcun selettore libero di emoji: toccandone una la attivi o la disattivi per te e i chip aggregati compaiono sotto il messaggio.

Uno spazio ospita più conversazioni contemporaneamente e sono tutte sullo stesso piano: non ce n’è una principale. Uno spazio mantiene sempre almeno una conversazione viva: non puoi archiviare l’ultima attiva, e aprendo uno spazio che non ne ha ancora nessuna viene creata una conversazione permanente senza titolo.

Le conversazioni compaiono come schede dell’editor e, quando ce n’è più di una, come righe annidate sotto lo spazio nella barra laterale. Nuova conversazione si trova nel menu di nuova scheda dell’editor e crea una conversazione senza titolo, senza alcuna richiesta del titolo: il modello dei titoli la nomina in base al primo messaggio. Usane una per svolgere lavoro in parallelo con lo stesso agente e lo stesso worktree.

Ogni conversazione mantiene la propria cronologia dei messaggi e le proprie sessioni degli agenti, condividendo al tempo stesso i worktree dello spazio e la sua modalità. Chiudere una scheda la nasconde; Archivia conversazione (la riga nella barra laterale o il menu contestuale della scheda della chat) archivia solo quella conversazione.

Passa il mouse su un messaggio e scegli Avvia discussione. Si apre una conversazione ancorata a quel messaggio: l’ancora inizializza il contesto dell’agente della nuova conversazione con una riga e la cronologia della conversazione madre non viene copiata.

Una volta che un thread ha delle risposte, il messaggio da cui pende sviluppa una riga sotto di sé: i volti di chi ha parlato, il numero di risposte e quando è arrivata l’ultima. Quella riga è la via per rientrare: facendoci clic si apre (o si porta in primo piano) la scheda del thread. È l’unica traccia che un thread lascia nel flusso da cui si è diramato, ed è proprio per questo che esiste.

La scheda di un thread si intitola Thread: <name> e porta il glifo del ramo, così due schede nello stesso spazio non vengono mai scambiate l’una per l’altra.

I thread non si annidano mai: ancorarsi a un messaggio che si trova già dentro un thread viene rifiutato. L’intestazione della conversazione rimanda al messaggio ancora. Eliminare il messaggio ancora elimina il thread, e archiviare la conversazione madre non blocca i thread esistenti.

I contrassegni di lettura sono limitati allo spazio, non alla conversazione: aprire una qualsiasi conversazione dello spazio segna come letta l’intera stanza. I non letti si aggregano comunque tra tutte le conversazioni di uno spazio, thread compresi. Quando le conversazioni sono elencate sotto lo spazio, il punto dei non letti si trova sulla conversazione che ha lavoro non visto, anziché sulla riga madre.

Gli spazi che gli agenti aprono per parlarsi tra loro sono separati nella barra laterale sotto Agenti, compressi per impostazione predefinita e mostrati in attenuazione. Non incrementano mai il tuo badge dei non letti: il chiacchiericcio degli agenti è silenzioso per costruzione, non per un’impostazione che devi trovare.

Il tipo di uno spazio è uno di cinque valori: topic (il valore predefinito per qualsiasi cosa tu crei), agentPeer, system (gestito dalle pipeline), pr (creato quando una superficie di PR ha bisogno di un’ancora del worktree e nascosto dalla barra laterale finché non ha messaggi) e slack (creato dal ponte di chat per un thread di Slack o un DM al bot, e trattato come una normale conversazione umana).