Retour à l’aperçu

Ajouter des agents à l'espace de travail

Je veux …

… donner à un outil comme Claude Code, ChatGPT ou Cursor son propre nom dans l'espace de travail, pour lui assigner des tâches et voir ce qu'il a modifié.

Avant de commencer

  • Un agent est un outil qui travaille sur les tâches via une clé API de cet espace de travail. Ce n'est pas une personne et il ne se connecte pas.
  • Seuls Propriétaire et Admin ajoutent, modifient et retirent des agents. Chaque membre voit les agents et peut leur assigner des tâches.
  • Ajouter et modifier des agents nécessite votre propre forfait Ultra. Sans lui, la section affiche Ajouter et modifier des agents nécessite Ultra. Retirer fonctionne avec tous les forfaits.
  • Un espace de travail compte au plus 10 agents actifs. Les agents retirés ne comptent pas.
  • Les agents n'occupent pas de place. Ils ne comptent ni dans les places de votre forfait, ni dans les adhésions Pro gratuites d'Ultra.

Voici comment

  1. Ouvrez Réglages dans l'espace de travail et touchez Membres. Sous les membres et les invitations se trouve Agents, avec la ligne Des outils comme Claude qui travaillent sur les tâches via une clé API. Les agents n’occupent pas de place.
  2. Chaque ligne d'agent affiche son avatar, son nom, son type et N’occupe pas de place. Tant qu'il n'y en a aucun, la section indique Pas encore d’agents. Les membres ne voient la section qu'une fois qu'un agent existe.
  3. Touchez Ajouter un agent. Avec 10 agents, le bouton est grisé et Cet espace de travail a 10 agents. Retirez-en un d’abord. s'affiche en dessous.
  4. Sous Nom, saisissez 40 caractères au maximum. Le champ propose p. ex. Claude · BeCoach. Majuscules et minuscules ne comptent pas : le nom doit différer de celui de tout autre agent actif (Un autre agent porte déjà ce nom.) et de celui de tout membre (Un membre porte ce nom. Choisissez-en un autre pour éviter toute confusion.).
  5. Sous Type, choisissez Claude, ChatGPT, Cursor ou Autre.
  6. Sous Avatar, choisissez l'un des six avatars façon circuit imprimé. Ils sont réservés aux agents. Partout où un agent apparaît, son avatar porte un petit badge robot en bas à droite, pour que personne ne le prenne pour une personne.
  7. Touchez Enregistrer. L'agent apparaît dans la liste. Sous la liste, les propriétaires et les admins voient Pour qu’un agent travaille, créez une clé API qui agit en son nom, ou attribuez-lui une clé existante dans Réglages, Clés API.
  8. Pour que l'agent travaille, donnez-lui une clé API : en créant une clé dans Réglages, Clés API, choisissez l'agent sous Agit en tant que. Ou touchez une clé existante que vous avez créée, touchez Changer en tant que qui elle agit, choisissez l'agent et touchez Enregistrer. La clé garde son secret, donc .mcp.json et ZEITLICHT_API_KEY ne changent pas. Changer en tant que qui elle agit n'apparaît que tant que l'espace de travail a des agents actifs, ou quand la clé agit déjà en tant qu'agent. Voir Créer et révoquer des clés API.
  9. Pour modifier un agent, touchez le menu à trois points (Plus) de sa ligne et choisissez Modifier l’agent. Changez le nom, le type ou l'avatar et touchez Enregistrer.
  10. Pour retirer un agent, choisissez Retirer l’agent dans le même menu. La boîte de dialogue Retirer … ? explique ce qui se passe. Confirmez avec Retirer l’agent. Agent retiré. le confirme.
  11. Assignez des tâches à l'agent comme à une personne : dans le menu d'assignation d'une tâche, les agents ont leur propre groupe Agents, sous les personnes. Il en va de même pour le choix des testeurs et pour Filtrer par personne sur le tableau. Un agent peut aussi être testeur. Voir Assigner une tâche et ajouter des observateurs et Tester une tâche et signaler des bogues.

Le résultat

L'agent a son propre nom et son propre avatar dans l'espace de travail. Une clé qui agit en tant que lui écrit en tant qu'agent : l'historique, les commentaires, les bogues et Activité affichent le nom et l'avatar de l'agent avec au nom de … et via la clé API « … », par exemple « au nom de Mia · via la clé API « Claude » ». Dans l'historique et dans Activité, l'avatar de l'agent porte son badge robot au lieu de la petite clé qui signale les autres modifications faites via une clé. Quand quelqu'un d'autre assigne une tâche à l'agent ou lui demande de tester, les personnes dont les clés agissent en tant que cet agent voient dans Activité … a attribué une tâche à votre agent … ou … a demandé à votre agent … de tester une tâche. Tant qu'aucune clé active n'agit en tant que l'agent, personne ne reçoit cette notification. Personne ne la reçoit non plus pour une modification faite par soi-même.

Questions fréquentes

Pourquoi ne puis-je pas ajouter d'agent ?

Vous êtes Membre, votre forfait n'est pas Ultra, ou l'espace a déjà 10 agents actifs. Les membres ne voient pas du tout Ajouter un agent. Sans Ultra, Ajouter un agent est grisé et Modifier l’agent manque dans le menu.

Un agent occupe-t-il une place ?

Non. Les agents n'occupent pas de place et ne comptent ni pour les invitations, ni pour les places, ni pour les adhésions Pro gratuites.

Que deviennent les tâches quand je retire un agent ?

Le retrait est définitif et irréversible. Chaque clé API qui agit en tant que l'agent est révoquée aussitôt et affiche L’agent … a été retiré sous Révoquées et expirées. Les tâches gardent l'agent, grisé sous la forme « … (Agent retiré) », jusqu'à ce que quelqu'un d'autre les reprenne. Un agent retiré peut seulement être enlevé d'une tâche, jamais réassigné. Le filtre par personne du tableau le liste toujours, pour retrouver ses anciennes tâches.

Pourquoi un autre admin ne peut-il pas changer l'agent de ma clé ?

Une clé travaille toujours au nom de la personne qui l'a créée. Seule cette personne voit donc Changer en tant que qui elle agit. Les autres admins voient Seule la personne qui a créé cette clé, …, peut changer en tant que qui elle agit. Ils peuvent tout de même révoquer la clé.

Un agent peut-il observer une tâche ?

Non. Les agents ne lisent pas Activité : ils n'apparaissent donc pas dans Observateurs, et personne ne peut les mentionner avec @. Ils peuvent être assignés et tester.

Une clé qui agit en tant qu'agent a-t-elle besoin d'autre chose ?

De la même chose que toute clé : la personne qui l'a créée doit rester Propriétaire ou Admin et garder Ultra. Sinon, la clé cesse de fonctionner, comme décrit dans Créer et révoquer des clés API.

Sujets liés