Crea un team di agenti

Questa guida mostra come creare un team, assegnargli un responsabile e instradargli il lavoro.

Un team è un gruppo di agenti con un nome all’interno di uno spazio di lavoro, in cui un agente è designato come responsabile. Assegnare un ticket al team risveglia il responsabile, che scompone il lavoro e lo delega ai membri; al termine dell’esecuzione di un membro il responsabile viene risvegliato di nuovo per decidere cosa fare dopo.

Puoi creare, rinominare e aggiungere membri ai team in Impostazioni → Spazio di lavoro → Agenti → Team. Per instradare il lavoro verso un team hai due modi: un agente chiama assign_ticket con il team_id di quel team, oppure un nodo Team dispatch di una pipeline invia il team (senza assegnare un ticket). Il selettore degli assegnatari dei ticket elenca te e i singoli agenti.

Crea un team

Apri Impostazioni → Spazio di lavoro → Agenti (/settings/workspace/agents).
Fai clic su Team nell’intestazione della pagina.
Fai clic su Add team.
Inserisci un nome (per esempio «backend» o «review squad») e una descrizione facoltativa, poi fai clic su Crea.

Il team viene creato e selezionato, e il suo editor si apre nel pannello a destra.

Imposta il responsabile

Questo è il passaggio da cui dipende l’intera funzionalità. Nell’editor del team:

In Responsabile, scegli un agente. Il testo di aiuto lo descrive esattamente così: «Il coordinatore che riceve il lavoro assegnato al team e lo delega al membro più adatto.»
Se vuoi, compila Istruzioni operative: testo libero consegnato al responsabile con ogni ticket instradato.

Promuovere un agente a responsabile lo rende anche un membro, se non lo era già. Un team lasciato su Nessun responsabile è inerte: quando gli si instrada del lavoro non viene inviato nulla, e rimuovere il responsabile attuale dall’elenco dei membri lascia di nuovo il team senza responsabile.

Aggiungi membri

Nello stesso editor, usa la scheda dei membri per aggiungere agenti dello spazio di lavoro e per rimuoverli. I membri sono l’elenco su cui il responsabile distribuisce le deleghe.

I team hanno come ambito lo spazio di lavoro: possono aderirvi solo gli agenti di questo spazio.

Assegna uno spazio al team

Non esiste uno spazio automatico per il team. Se ne vuoi uno, crea uno spazio normale da Spazi e aggiungivi gli agenti del team. Un Team porta con sé nome, descrizione, responsabile, istruzioni e membri: nessuna associazione a uno spazio.

Le linee di riporto sono una cosa a parte

Ogni agente ha anche un campo Riferisce a, impostato in Impostazioni → Spazio di lavoro → Agenti. Da lì si costruisce l’albero di riporto dello spazio di lavoro, che puoi vedere con il pulsante Organigramma nella pagina degli agenti.

Non guida l’instradamento dei team. Il responsabile sceglie a chi delegare dall’elenco dei membri del team in base a skill e ruolo, non dalla catena di riporto. Le concessioni di accesso alla memoria dipendono dal ruolo di un agente, non dalla catena di riporto, e nessuna superficie di analisi aggrega per team o gerarchia. Le salvaguardie della delega limitano la profondità e rilevano i cicli, ma non richiedono mai che il destinatario sia un subordinato.

Che cosa fa un ticket instradato

Quando un ticket porta davvero l’assegnazione a un team:

Il responsabile del team viene inviato con il ticket, le sue istruzioni operative e l’elenco dei membri.
Il responsabile delega ai membri e registra la sua valutazione con lo strumento record_team_activity — action (delegato), no_action (niente più da fare, il che interrompe ulteriori riattivazioni) o failed.
Ogni esecuzione di un membro che termina risveglia di nuovo il responsabile, entro i limiti della salvaguardia no-action.

Il nodo Team dispatch di una pipeline è l’altro punto di ingresso. Richiede un ID del team, un prompt e una modalità di invio:

allParallel — un’attività per membro in una conversazione condivisa e nascosta, che resta sospesa finché non termina ogni esecuzione, con l’output di ciascun membro raccolto sotto la chiave di output del nodo
manager — invia solo il responsabile, che coordina nella conversazione