Crea e configura un agente

Questa guida mostra come aggiungere un agente a uno spazio di lavoro e configurarlo finché non riesce davvero a essere eseguito.

Ogni spazio di lavoro viene popolato inizialmente con cinque agenti — un CEO più qa, architect, engineer e librarian — quindi di solito disponi già di agenti prima di averne configurato alcuno. I passaggi che seguono valgono allo stesso modo per un agente del popolamento iniziale e per uno nuovo.

Prima di iniziare

Ti trovi dentro uno spazio di lavoro. L’intera superficie vive in Impostazioni → Spazio di lavoro → Agenti (/settings/workspace/agents).
L’agente avrà bisogno di un backend. Collega un fornitore per l’harness integrato in Impostazioni → Server → Fornitori di modelli, oppure installa la CLI di Claude Code sulla macchina che ospita cc_server.
Se vuoi che l’agente porti con sé delle skill, installale prima in Impostazioni → Spazio di lavoro → Competenze. Il modulo dell’agente ti consente solo di attivare o disattivare skill già esistenti nello spazio di lavoro.

Aggiungi l’agente

Apri Impostazioni → Spazio di lavoro → Agenti.
Fai clic su Nuovo agente.

Non c’è nessuna finestra di dialogo e nessun selettore di ruolo. Un agente chiamato «Agente senza nome» viene creato immediatamente e selezionato nel pannello dei dettagli a destra.

Ora dovresti vedere «Agente senza nome» nell’elenco a sinistra, con la scheda Impostazioni del suo pannello dei dettagli aperta e un campo Nome contenente «Agente senza nome».

Assegna un nome

Nome — l’identificatore breve usato nelle @-menzioni, per esempio alice. L’analisi delle menzioni individua una @ seguita da caratteri di parola, quindi un nome che contiene un trattino, un punto o uno spazio non può mai essere menzionato.
Titolo — l’etichetta leggibile da una persona, per esempio «sviluppatore senior».
Prompt di sistema — istruzioni aggiuntive facoltative, iniettate come sezione «Istruzioni per l’agente»; non sostituiscono il resto del prompt assemblato.

Fai clic su Salva modifiche in fondo al modulo. Ogni campo di questa pagina viene salvato da quell’unico pulsante.

Assegna un adattatore e un modello

Il menu a discesa Adattatore elenca i runner che la macchina del server ha davvero. L’adattatore integrato si trova sempre (è il server). Claude Code compare solo quando la sua CLI è stata rilevata su quella macchina:

Adattatore	Backend
Control Center (built-in)	Il loop dell’agente in-process — nessuna CLI esterna
Claude Code	`claude -p --output-format stream-json`

Solo l’adattatore integrato applica le modalità, la guida durante l’esecuzione, la pausa e la ripresa, i contratti di completamento e i sottoagenti. Claude Code non offre nulla di tutto questo. Cursor, Codex e gli altri fornitori di modelli si agganciano all’adattatore integrato, non come runner separati.

Il menu a discesa Modello è guidato dall’adattatore che hai scelto. Per l’adattatore integrato l’elenco arriva in tempo reale dai fornitori che hai collegato in Impostazioni → Server → Fornitori di modelli, quindi un fornitore senza credenziale memorizzata contribuisce con zero modelli.

Aggiungi skill

Competenze è un selettore a chip sui bundle di skill installati in questo spazio di lavoro. Tocca un chip per attivarlo o disattivarlo; il glifo di spunta contrassegna quelli selezionati. Se lo spazio di lavoro non ha skill, il campo mostra «No skills available. Create skills in Settings → Skills first.»

Non scegli qui le skill di un repository. Un repository che le fornisce (in .agents/skills/, .claude/skills/ o .opencode/skills/) le aggiunge automaticamente all’agente che sta lavorando in quel repository, e vengono scambiate quando passa a un altro — vedi Skill con ambito di repository.

Imposta la linea di riporto e la persona

Riferisce a — scegli un altro agente per nome. Questo costruisce l’albero di riporto mostrato dal pulsante Organigramma nell’intestazione della pagina. Non è l’elenco che un capo team usa quando delega — quello deriva dai membri del team e dalle loro skill.
Persona — testo libero che ne plasma il tono e il comportamento, per esempio: «Predilige soluzioni semplici e leggibili. Scrive test per tutto il codice nuovo.»

Regola l’esecuzione

Sforzo di ragionamento — le opzioni provengono dai livelli pubblicati dal modello selezionato: Low / Medium / High, più Extra High sui modelli in stile OpenAI e Extra High + Max su quelli in stile Claude. Il campo è del tutto nascosto quando il modello selezionato non dichiara livelli di pensiero e assume il valore predefinito del modello stesso.
Dimensione della finestra di contesto — precompilata dalla finestra di contesto del modello ogni volta che cambi modello, con chip selezionabili con un tocco per il valore predefinito del modello, 200k, 500k e 1M. Un valore che digiti dopo aver scelto il modello prevale fino al successivo cambio di modello.
Timeout di silenzio (minuti) — termina un’esecuzione dopo tutto questo tempo senza output. Lascialo vuoto per usare il valore predefinito della modalità.

Concedi i permessi

Un agente non ha interruttori di permesso propri. Cosa può inviare, aprire, unire o raggiungere lo stabiliscono le regole delle azioni in Impostazioni → Spazio di lavoro → Autorizzazioni degli agenti, dove una regola può essere limitata a questo agente. Di serie, un push, una pull request, una revisione o un merge e una scrittura su un tracker ti chiedono prima ciascuno conferma, e l’accesso alla rete è consentito.

Il token GitHub dell’agente è sempre di sola lettura. Un push passa da Control Center, che interroga la regola Eseguire il push a un remoto prima di inoltrarlo. Vedi Configura le policy del sandbox per come ogni regola raggiunge un’esecuzione.

Verifica che venga eseguito

Apri Impostazioni → Server → Fornitori di modelli e verifica che l’adattatore scelto riporti una versione installata invece di «Non trovato». Fai clic su Aggiorna per rilevarla di nuovo — la rilevazione viene eseguita sulla macchina che ospita cc_server, non su quella che stai guardando.
Apri uno spazio con l’agente e inviagli un messaggio, oppure @-menzionalo in uno spazio esistente.
Torna in Impostazioni → Spazio di lavoro → Agenti, seleziona l’agente e apri la sua scheda Log. Dovrebbe comparire un’esecuzione con un badge di stato, una durata, un’ora di avvio e l’adattatore usato. Visualizza apre il flusso di eventi di quell’esecuzione.

Se non compare alcuna esecuzione, segui Diagnostica un agente.

Elimina un agente

Selezionalo nell’elenco. Nella scheda Impostazioni, scorri fino alla Zona pericolosa in fondo al modulo e fai clic su Elimina.