Aller au contenu

Constituer une équipe d’agents

Ce guide explique comment créer une équipe, lui donner un responsable et acheminer du travail vers elle.

Une équipe est un groupe nommé d’agents au sein d’un même espace de travail, dont un agent est désigné comme son responsable. Attribuer un ticket à l’équipe réveille le responsable, qui décompose le travail et le délègue aux membres ; lorsqu’une exécution de membre se termine, le responsable est réveillé de nouveau pour décider de la suite.

Créez des équipes, renommez-les et affectez-leur des membres dans Paramètres → Espace de travail → Agents → Équipes. Acheminez du travail vers une équipe de deux façons : un agent appelle assign_ticket avec le team_id de cette équipe, ou un nœud Team dispatch d’un pipeline lance l’équipe (sans attribuer de ticket). Le sélecteur de personne assignée d’un ticket vous propose, vous et les agents pris individuellement.

  1. Ouvrez Paramètres → Espace de travail → Agents (/settings/workspace/agents).
  2. Cliquez sur Équipes dans l’en-tête de la page.
  3. Cliquez sur Ajouter une équipe.
  4. Saisissez un nom (par exemple « backend » ou « review squad ») et une description facultative, puis cliquez sur Créer.

L’équipe est créée et sélectionnée, et son éditeur s’ouvre dans le volet de droite.

C’est l’étape dont dépend toute la fonctionnalité. Dans l’éditeur de l’équipe :

  1. Sous Responsable, choisissez un agent. Le texte d’aide le décrit exactement : « Le coordinateur qui reçoit le travail assigné à l’équipe et le délègue au membre le plus adapté. »
  2. Remplissez au besoin Instructions de fonctionnement — du texte libre remis au responsable avec chaque ticket acheminé.

Promouvoir un agent au rang de responsable en fait aussi un membre s’il ne l’était pas déjà. Une équipe laissée sur Aucun responsable est inerte : rien n’est lancé lorsque du travail lui est acheminé, et retirer le responsable actuel de la liste des membres laisse de nouveau l’équipe sans responsable.

Dans le même éditeur, utilisez la carte des membres pour ajouter des agents de l’espace de travail et pour les retirer. Les membres forment l’effectif parmi lequel le responsable délègue.

Les équipes sont limitées à un espace de travail : seuls les agents de cet espace de travail peuvent s’y joindre.

Il n’existe aucun espace d’équipe automatique. Si vous en voulez un, créez un espace ordinaire à partir de Espaces et ajoutez-y les agents de l’équipe. Un Team porte un nom, une description, un responsable, des instructions et des membres — aucune association à un espace.

Chaque agent possède aussi un champ Rapporte à, défini dans Paramètres → Espace de travail → Agents. Cela construit l’arbre hiérarchique de l’espace de travail, que vous pouvez consulter avec le bouton Organigramme de la page des agents.

Cela ne régit pas l’acheminement du travail vers les équipes. Un responsable choisit un délégué dans l’effectif de l’équipe selon les compétences et le rôle, et non en suivant la chaîne hiérarchique. Les droits d’accès à la mémoire reposent sur le rôle de l’agent, et non sur la chaîne hiérarchique, et aucune surface d’analyse n’agrège les données par équipe ni par hiérarchie. Les garde-fous de délégation limitent la profondeur et détectent les cycles, mais ils n’exigent jamais que la cible soit un subordonné.

Lorsqu’un ticket porte effectivement une affectation à une équipe :

  1. Le responsable de l’équipe est lancé avec le ticket, ses instructions de fonctionnement et l’effectif des membres.
  2. Le responsable délègue aux membres et consigne son évaluation avec l’outil record_team_activity — action (délégué), no_action (rien de plus à faire, ce qui met fin aux redéclenchements) ou failed.
  3. Chaque exécution de membre qui se termine réveille de nouveau le responsable, dans les limites du garde-fou de non-action.

Le nœud Team dispatch d’un pipeline est l’autre point d’entrée. Il prend un identifiant d’équipe, un prompt et un mode de lancement :

  • allParallel — une tâche par membre dans une conversation cachée partagée, avec suspension jusqu’à ce que chaque exécution se termine, la sortie de chaque membre étant recueillie sous la clé de sortie du nœud
  • manager — lance uniquement le responsable, qui coordonne dans la conversation