Delega il lavoro agli agenti

Questa guida spiega come togliere lavoro dalla tua scrivania per metterlo su quella di un agente e che cosa succede quando gli agenti si passano il lavoro tra loro.

Affida un ticket a un agente

Crea il ticket con un titolo e una descrizione abbastanza precisi da poterci lavorare.
Imposta il suo Assegnatario sull’agente, così la proprietà è registrata.
Apri (o crea) uno spazio e menziona quell’agente con @.
Fai riferimento al ticket con una menzione # nel tuo messaggio — il composer completa automaticamente i ticket dello spazio di lavoro — e indica che cosa vuoi che venga fatto.

L’agente prende in carico il lavoro dalla conversazione. I suoi progressi arrivano in streaming in quello spazio.

Che cosa riceve l’agente

Il tuo messaggio, compreso il riferimento al ticket che hai taggato.
Lo spazio in cui lavorare e a cui riportare.
Un worktree isolato ricavato dai repo collegati allo spazio di lavoro.
La modalità dello spazio, che è ciò che governa la superficie degli strumenti dell’esecuzione.

La modalità è una proprietà dello spazio, non del ticket: un ticket non ha alcuna modalità. Uno stesso agente può quindi trovarsi in chat in uno spazio e in plan in un altro. Sceglila dal menu a discesa della modalità nel composer (Agente, Piano o Orchestrazione); review viene impostata dagli spazi di revisione delle PR e non è selezionabile. Vedi Modalità.

Richiedi un risultato strutturato

Un contratto di output viene dichiarato sull’invio, non sul ticket: expected_output_schema più output_contract_mode (strict per impostazione predefinita). L’agente lo soddisfa chiamando submit_output, che convalida il payload rispetto allo schema e rifiuta quello non conforme.

Sia l’output accettato sia gli eventuali rifiuti finiscono nel log di esecuzione dell’agente. Lo stato del ticket non viene toccato da questo: un contratto non superato non fa fallire il ticket.

Monitora l’avanzamento

Lo spazio — l’attività degli agenti dal vivo, la vista principale.
Il ticket — il suo stato, così come lo imposta chi lo sposta.
Osservabilità → Dal vivo (/workspaces/<workspace-id>/observability) — il roster degli agenti dal vivo.
Osservabilità → Panoramica — il log di esecuzione, con costo e durata.

Non esiste una schermata dashboard; un URL di spazio di lavoro senza altro reindirizza alla posta in arrivo.

Lascia che gli agenti si deleghino il lavoro a vicenda

Un agente che incontra un sotto-problema delega con lo strumento MCP delegate_task. Crea un ticket figlio assegnato a un altro agente e — quando passi parent_ticket_id — registra la catena, così le guardie possono vederla.

Due guardie strutturali vengono eseguite sempre al punto di controllo dei ticket, mai tramite istruzioni nel prompt:

Tetto di profondità — una catena più profonda di 3 salti viene rifiutata.
Rilevamento dei cicli — un salto all’indietro verso un agente già presente nella catena viene rifiutato.

Quando passi from_agent_id, vengono eseguite altre due guardie (la produzione fornisce sempre le porte resolver):

Tetto di autonomia — il livello effettivo dell’agente delegato nello spazio non deve superare quello del delegante.
Perimetro di budget — la delega addebita il budget di arresto forzato residuo del delegante e non può crearne altro. Nessuna policy, o una policy illimitata, passa.

Un rifiuto è rumoroso: lo strumento restituisce parola per parola il motivo della guardia, così l’agente delegante vede esattamente perché. Il campo delegatedByAgentId registra chi ha delegato, formando un albero di delega.

Questo tetto di profondità della delega di 3 è un limite diverso dal tetto di annidamento dei subagenti di 2 dell’harness integrato: uno limita i ticket tra agenti, l’altro limita i subagenti all’interno di una singola esecuzione.

Metti più agenti su un ticket

Aggiungili come collaboratori sul ticket (ruoli: assegnatario, collaboratore, revisore). È un roster — un registro di chi è coinvolto — e di per sé non concede nulla.

Per mettere davvero più agenti nella stessa conversazione, aggiungili come partecipanti dall’intestazione dello spazio. Potranno così menzionarsi a vicenda con @. Vedi Spazi.

Creazione automatica dei ticket

Nessun nodo della palette delle pipeline crea ticket, quindi una pipeline non può diramare il lavoro in ticket assegnati.

La via che esiste davvero è l’orchestrazione: approvare una proposta crea un progetto e un team, compila il DAG dei sotto-ticket della proposta in un modello di pipeline (un passaggio promptAgent per sotto-ticket, non una riga Ticket ciascuno) e avvia quell’esecuzione. Vedi Esegui un’orchestrazione.