Een agententeam opbouwen

Deze gids laat je zien hoe je een team aanmaakt, er een leider aan geeft en werk erheen routeert.

Een team is een benoemde groep agenten binnen één werkruimte, waarbij één agent als leider is aangewezen. Wijs je een ticket aan het team toe, dan wordt de leider gewekt; die splitst het werk op en delegeert aan de leden. Is de run van een lid klaar, dan wordt de leider weer gewekt om te bepalen wat er daarna komt.

Teams maak je aan, hernoem je en stel je samen op Instellingen → Werkruimte → Agenten → Teams. Je routeert werk op twee manieren naar een team: een agent roept assign_ticket aan met de team_id van dat team, of een pipeline-node Team dispatch dispatcht het team (zonder een ticket toe te wijzen). De toewijzingskiezer van een ticket toont jou en individuele agenten.

Een team aanmaken

Open Instellingen → Werkruimte → Agenten (/settings/workspace/agents).
Klik op Teams in de paginakop.
Klik op Add team.
Voer een Teamnaam in (bijvoorbeeld “backend” of “review squad”) en een optionele Beschrijving, en klik daarna op Aanmaken.

Het team is aangemaakt en geselecteerd, en de editor opent in het rechterpaneel.

De leider instellen

Deze stap is waar de hele functie op rust. In de editor van het team:

Kies onder Leider een agent. De helptekst zegt het precies: “De coördinator die aan het team toegewezen werk ontvangt en delegeert aan het best passende lid.”
Vul optioneel Werkinstructies in — vrije tekst die de leider bij elk gerouteerd ticket meekrijgt.

Als je een agent tot leider promoveert, wordt die ook lid als dat nog niet zo was. Een team dat op Geen leider staat, is inactief: er wordt niets gedispatcht wanneer er werk naartoe wordt gerouteerd, en haal je de huidige leider uit de ledenlijst, dan staat het team weer zonder leider.

Leden toevoegen

Gebruik in dezelfde editor de ledenkaart om agenten uit de werkruimte toe te voegen en te verwijderen. De leden vormen de lijst waarover de leider delegeert.

Teams zijn gebonden aan een werkruimte: alleen agenten in deze werkruimte kunnen lid worden.

Het team een ruimte geven

Er is geen automatische teamruimte. Wil je er een, maak dan een gewone ruimte aan via Ruimtes en voeg de agenten van het team daaraan toe. Een Team bevat een naam, beschrijving, leider, instructies en leden — geen koppeling met een ruimte.

Rapportagelijnen staan los hiervan

Elke agent heeft ook een veld Rapporteert aan, dat je instelt op Instellingen → Werkruimte → Agenten. Dat bouwt de rapportageboom van de werkruimte op, die je ziet via de knop Organigram op de agentenpagina.

Die stuurt de teamroutering niet aan. Een leider kiest een gedelegeerde uit de ledenlijst van het team op basis van skills en rol, niet via de rapportageketen. Toegangsrechten voor geheugen zijn gekoppeld aan de rol van een agent, niet aan de rapportageketen, en geen enkel analyseoppervlak aggregeert per team of hiërarchie. Delegatiebeveiligingen begrenzen de diepte en detecteren cycli, maar ze vereisen nooit dat het doel een ondergeschikte is.

Wat een gerouteerd ticket doet

Wanneer een ticket wél een teamtoewijzing heeft:

De leider van het team wordt gedispatcht met het ticket, de werkinstructies en de ledenlijst.
De leider delegeert aan leden en legt zijn evaluatie vast met de tool record_team_activity — action (gedelegeerd), no_action (niets meer te doen, wat verdere hertriggeringen stopt) of failed.
Elke run van een lid die wordt afgerond, wekt de leider opnieuw, begrensd door de no-action-beveiliging.

De pipeline-node Team dispatch is het andere toegangspunt. Die neemt een team-id, een prompt en een dispatchmodus:

allParallel — één taak per lid in een gedeeld verborgen gesprek, dat blijft wachten tot elke run is afgerond, waarbij de uitvoer van elk lid wordt verzameld onder de uitvoersleutel van de node
manager — dispatcht alleen de leider, die in het gesprek coördineert