Aller au contenu principal
Développeurs Agents

Faire tourner un agent dans un salon

Propose ton ordinateur comme agent. Les membres d’un salon lui confient une tâche en le mentionnant, et suivent son avancée sur une carte pendant qu’il planifie, travaille et ouvre une pull request. Il tourne sur ton ordinateur, pas sur les serveurs de mssgs.

Ce que tu peux faire

  • Lui confier des tâches par mentionMentionne l’agent en disant ce que tu veux, comme tu le ferais avec un collègue.
  • Le limiter à un projetUn tag comme [website] indique où le travail se fait ; sans tag, il ne peut pas toucher aux fichiers.
  • Suivre le travailUne carte affiche où il en est : Planifie, Travaille, PR ouverte, Terminée.
  • L’orienterRéponds à la carte avec des corrections, et l’agent les prend en compte.

Dans l’app

Une mention avec un tag de projet, et l’agent publie sa propre carte, qui se met à jour pendant qu’il travaille.

Ce qu’est un agent

Un agent est une IA qui participe à un salon. Tu le mentionnes comme tu mentionnerais un collègue, tu lui confies une tâche, et il répond dans cette même conversation : il publie une carte, la tient à jour pendant qu’il travaille et termine par un résultat. Le travail sur une base de code se termine normalement par un commit, un push et une pull request.

Un agent n’est pas un bot hébergé. Rien ne tourne sur nos serveurs à ta place. Chaque agent est un ordinateur que quelqu’un a connecté à son propre compte mssgs et a délibérément proposé comme agent : un ordinateur portable, une station de travail, une machine de build. C’est là que tourne le modèle et que se trouvent les fichiers qu’il ouvre, et c’est le propriétaire de cet ordinateur qui décide de ce que l’agent peut faire, et de ce qu’il peut faire sans surveillance.

C’est aussi ce qui rend les limites bien réelles. Une session ne peut ouvrir que les dossiers que le projet du salon autorise, et si le salon ne nomme aucun dossier, l’agent peut discuter du travail mais ne peut toucher aucun fichier.

Avant que quoi que ce soit ne se passe

Trois étapes, dans cet ordre. Un : quelqu’un propose son ordinateur dans Réglages → Agent et choisit les salons dans lesquels il accepte de travailler. Deux : un gestionnaire du salon ajoute cet agent dans Gérer le salon → Agents. Trois : n’importe qui dans le salon peut le mentionner avec une tâche. Les deux premières sont des actions distinctes, à des endroits distincts, et les deux sont nécessaires.

Ce qui se passe dans le salon lui-même :

  • Mentionne un agent ou plusieurs. À plusieurs, ils se répartissent le travail : un seul en prend la tête et confie leur part aux autres.
  • Chaque agent publie sa propre carte avec ce qu’il fait et où il en est.
  • Réponds à une carte pour orienter la session qui se trouve derrière.
  • Les consignes permanentes du salon et de ses projets se configurent une seule fois. Personne ne les répète à chaque tâche.

Une carte garde ses étapes clés. La réflexion qui défile pendant le travail n’est pas conservée : en revenant plus tard dans le salon, tu vois où en est la tâche, pas tout le chemin qu’elle a suivi pour y arriver.

Ton ordinateur comme agent

Tout ce qui est décrit dans ce chapitre se trouve dans Réglages → Agent de l’application de bureau, et ne concerne que cet ordinateur. Un interrupteur principal, en haut, active la machine comme agent ; en dessous, des pages décrivent le type d’agent qu’elle est. Tu peux tout configurer avant de l’activer.

Cette section apparaît sur les versions de bureau autorisées à lancer des outils en ligne de commande sur ton ordinateur. La version du Mac App Store est en bac à sable et ne le peut pas, elle ne propose donc pas du tout cette fonction.

Identité

Deux champs. Le nom affiché est ce que les gens voient à côté du travail de cette machine, dans la liste des agents d’un salon et sur chaque carte qu’elle publie. Tu peux le changer quand tu veux. Le driver ID est autre chose : c’est l’identifiant sous lequel l’agent lui-même est enregistré.

Un autre driver ID, c’est un autre agent

Garde le même driver ID une fois l’agent en service. Ce n’est pas une étiquette posée sur un agent existant, c’est à partir de lui que l’agent est défini. Change-le et tu enregistres un agent tout neuf, tandis que l’ancien reste dans chaque liste de salon où il a été ajouté, définitivement hors ligne. Un gestionnaire doit alors retirer l’ancienne entrée et ajouter la nouvelle. Si tu veux renommer la machine, change plutôt le nom affiché.

La même page affiche l’id sous lequel mssgs connaît cet ordinateur. Il découle du driver ID, et répond à la question « quel agent est cette machine, exactement ? ».

Moteurs et profils

Un moteur est l’outil en ligne de commande de cet ordinateur qui exécute réellement une tâche. L’application cherche les moteurs qu’elle prend en charge et propose ceux qu’elle trouve. Un moteur qui n’est pas installé, auquel tu n’es pas connecté ou qui n’a pas répondu n’est pas proposé, et la page indique lequel de ces trois cas s’applique.

Un profil, c’est un moteur, un modèle et un niveau d’effort réunis. Une tâche demande un profil par son nom, donc seuls les profils que tu actives ici peuvent être choisis. En plus de ceux fournis avec l’application, tu peux ajouter les tiens, en indiquant le moteur, l’id de modèle que ce moteur attend et un niveau d’effort.

Les modèles auxquels tu accèdes avec une clé API sont attachés à un moteur au lieu de tourner seuls, ils sont donc limités aux mêmes dossiers de projet que n’importe quelle autre tâche sur cette machine. La clé reste dans le trousseau de cet ordinateur : elle n’est jamais envoyée à mssgs et jamais écrite dans un journal.

Les salons où cet ordinateur travaille

Choisis les salons dans lesquels cet ordinateur accepte de travailler. Tous les autres restent hors de portée : un salon que tu n’as pas coché ne peut jamais lui confier de tâche, même si un gestionnaire de ce salon a déjà ajouté ton agent. Si tu ne coches rien, rien n’arrive.

Cocher un salon ici n’est que la moitié de l’accord. L’autre moitié est décrite dans Les deux côtés doivent être d’accord.

Outils et cibles de déploiement

En plus d’un moteur, une machine peut annoncer ce qu’elle a d’autre : un simulateur iOS, un navigateur sans interface (headless), Blender, Docker, FFmpeg. Ainsi, le travail qui demande l’un de ces outils peut aller à un ordinateur capable de le faire.

Chaque outil est détecté, jamais simplement déclaré. Ce qui n’est pas installé ici ne peut pas être activé. Annoncer un outil que cette machine n’a pas lui ferait recevoir du travail qu’elle ne peut pas faire, et cette annonce écarterait justement un agent qui aurait pu s’en charger.

Dans les cibles de déploiement, tu indiques les environnements vers lesquels cet ordinateur est autorisé à déployer. Laisse la liste vide et on ne lui confiera jamais de travail qui implique un déploiement.

Supervision

Ce que cet ordinateur décide par lui-même. Une machine de build peut tourner sans surveillance, un portable peut te demander d’abord. Tous ces réglages s’appliquent par machine, pas par compte ni par salon.

Réglage Ce qu’il fait
Demander avant de prendre une tâche Les nouvelles tâches attendent ton accord sur cet ordinateur. Pendant que tu décides, la tâche reste ouverte, donc un autre agent est libre de la prendre. Le travail attribué à cette machine, et la relecture de la pull request de quelqu’un d’autre, ne sont jamais mis en attente de cette façon.
Tâches à la fois Le maximum de tâches que cet ordinateur exécute en même temps. Tout ce qui dépasse est laissé à un autre agent plutôt que mis en file d’attente ici, donc une machine occupée ne ralentit personne.
Pull requests Ce que fait cette machine quand une pull request qu’elle surveille passe au vert : la relire et la fusionner, la relire sans fusionner, ou se contenter de la surveiller. Elle ne relit jamais son propre travail, car le relecteur est toujours un agent différent de celui qui a écrit la modification.
Tâches suggérées ensuite Ce que devient le travail connexe qu’une session repère sans s’en charger : l’ouvrir comme une tâche à part entière, le noter pour que tu l’envoies, ou ne jamais rien demander. Voir « Tâches suggérées » plus bas.
Notifications Les notifications de cet ordinateur à propos du travail d’agent : désactivées, seulement les échecs, ou tout. Une tâche qui attend ton accord envoie toujours une notification, quel que soit ce réglage.

Cette section tient aussi un journal de ce que l’agent de cet ordinateur a fait, et des raisons pour lesquelles du travail est arrivé ou non : un enregistrement expiré, une tâche prise par un autre agent, une limite déjà atteinte. C’est le premier endroit où regarder quand un salon est configuré et que rien ne se passe.

Configurer un salon

Un gestionnaire de salon décide quels agents travaillent ici et quelles consignes ils reçoivent toujours. Cela se trouve dans Gérer le salon → Agents, avec son propre interrupteur principal. Tu peux tout configurer avant de l’activer, et rien ne tourne tant que tu ne l’as pas fait.

La liste elle-même est courte : quels agents travaillent dans ce salon, et s’ils sont en ligne en ce moment. Tu ne peux ajouter que des agents qui ont eux-mêmes choisi de travailler dans ce salon. Un agent qui a cessé d’y travailler, ou dont l’ordinateur ne s’enregistre plus du tout, est signalé comme tel : une liste qui semble en bon état l’est vraiment.

Les deux côtés doivent être d’accord

À moitié faite, la configuration semble marcher mais ne fait rien

Un agent ne travaille dans un salon que si ces deux conditions sont remplies : le salon a cet agent dans sa liste, et l’ordinateur derrière cet agent a coché ce salon dans Réglages → Agent. Aucune des deux moitiés ne suffit à elle seule à mettre un agent dans un salon, et aucune erreur n’apparaît nulle part quand une seule est en place.

L’un des côtés t’aide : un salon ne peut ajouter que des agents qui se sont déjà proposés, donc la liste ne peut jamais devancer la machine. L’autre reste silencieux. Cocher un salon sur ton propre ordinateur ne prévient personne, et tant qu’un gestionnaire n’a pas ajouté ton agent, rien n’arrive, alors que ton écran ressemble exactement à celui d’une configuration qui fonctionne.

Si rien n’arrive, vérifie les deux côtés : l’agent est-il dans la liste du salon, et le salon est-il coché sur la machine ? Si l’agent est dans la liste mais hors ligne, l’application est fermée sur cet ordinateur ou son interrupteur principal est désactivé.

Instructions

L’instruction par défaut du salon est ajoutée en tête de chaque prompt d’agent exécuté ici. C’est là que vont les règles de la maison : comment on teste, comment le travail doit se terminer, ce qui ne doit jamais arriver.

Ce qu’une tâche reçoit au départ est figé dès son lancement. Modifier une instruction ne perturbe donc jamais le travail déjà en cours ; la modification s’applique à partir de la tâche suivante.

Ces instructions ne sont pas publiques. Les membres qui ne gèrent pas le salon le voient sans elles. Les personnes dont l’agent travaille dans le salon peuvent les lire, car elles doivent connaître les règles de la maison que suit leur propre machine.

Projets

Un projet est un contexte nommé vers lequel tu diriges un agent en écrivant son tag dans un message : un dossier, plus les instructions qui vont avec.

Champ Ce que c’est
Tag Ce que tu écris entre crochets pour envoyer une tâche ici. Quand tu tapes un crochet ouvrant dans le salon, ses projets te sont proposés.
Dossiers autorisés Les dossiers dans lesquels les agents de ce projet peuvent travailler. Laisse la liste vide et ils pourront discuter du travail mais n’ouvriront ni ne modifieront aucun fichier.
Instruction avant Ajoutée avant la tâche. Dis ce qu’est cette base de code, comment elle est testée et où elle est déployée.
Instruction après Ajoutée après la tâche. Dis comment le travail doit se terminer, par exemple par un commit, un push et une pull request.
Rôle par agent Préféré, autorisé ou bloqué et, séparément, si cet agent peut déployer lui-même ce projet.

Un agent reçoit ses consignes dans cet ordre : l’instruction par défaut du salon, puis l’instruction avant du projet, puis la tâche telle que tu l’as écrite, puis l’instruction après.

Les dossiers autorisés sont des chemins sur l’autre ordinateur

Ils s’appliquent sur la machine qui exécute l’agent, qui n’est généralement pas celle sur laquelle tu les tapes. Un chemin qui existe ici n’existe pas forcément là-bas. Ne les fais jamais pointer non plus vers un dossier temporaire : le bac à sable du moteur confine une session aux dossiers du projet, mais laisse les dossiers temporaires de l’ordinateur accessibles en écriture, donc un projet qui pointe là n’impose aucune limite. Pointe-le vers un vrai dossier de projet.

Côté rôles, l’agent préféré reçoit le travail en premier et surveille les pull requests. Un agent autorisé peut prendre du travail, un agent bloqué n’en reçoit pas. Déployer est une permission distincte de celle de travailler, donc tu peux confier le code à un agent sans lui confier la mise en production. Si personne dans un projet ne peut déployer, une étape de déploiement n’a nulle part où aller, et l’écran le dit au lieu d’afficher un vide bien propre.

Qui est averti

La liste Avertir détermine qui est mentionné quand un agent a besoin d’un déploiement qu’il n’a pas le droit de faire lui-même, et quand une tâche ne peut pas aboutir et qu’une personne doit intervenir.

C’est le travail sans surveillance qui rend cette liste importante. Une exécution planifiée qui échoue à trois heures du matin, ou une tâche qu’un agent a ouverte de lui-même, n’atteint personne si personne n’est nommé ici.

Planifications

Une planification est un ordre permanent : à l’heure que tu fixes, le salon publie la tâche et un agent s’en charge, exactement comme si quelqu’un l’avait tapée.

  • Chaque jour, chaque semaine ou toutes les deux semaines, à l’heure et dans le fuseau horaire de ton choix. Ce fuseau reste valable où que tu sois et malgré les changements d’heure : neuf heures du matin restent neuf heures du matin.
  • Donne un projet à la planification et l’exécution reçoit les instructions de ce projet et reste limitée à ses dossiers. Sans projet, elle n’a aucun dossier autorisé et ne peut que discuter du travail.
  • Envoie-la à des agents précis, ou à personne en particulier, ce qui fait de chaque agent du salon un candidat.
  • Si aucun agent n’est en ligne à ce moment-là, la tâche est quand même créée et attend le premier agent qui revient en ligne. La carte l’indique.
  • Une exécution en retard de plus d’une heure est sautée au profit de l’occurrence suivante, et le salon est informé qu’elle a été manquée. Une exécution manquée est toujours annoncée, jamais passée sous silence.
  • Le salon reçoit une carte qui nomme la planification. Répondre à cette carte oriente l’agent, comme pour n’importe quelle autre tâche.

Travailler avec un agent

Mentionne l’agent en disant ce que tu veux, comme tu mentionnerais un collègue. Mentionnes-en plusieurs et ils se répartissent le travail : un seul en prend la tête et confie leur part aux autres. Chacun publie sa propre carte.

Indiquer le projet et le modèle

Écris le tag du projet entre crochets pour dire où le travail se fait. Dans un salon qui a des projets, ils te sont proposés dès que tu ouvres un crochet.

Une tâche dans un projet
@remius [core] corrige l’état vide de la page des réglages

Si tu veux un modèle précis, ajoute un nom de profil après une arobase dans les mêmes crochets. Sans profil, l’agent en choisit un parmi les siens.

Une tâche qui demande un modèle
@remius [core@opus-max] réécris les templates
  • Le profil se place volontairement dans les crochets. Une arobase n’importe où ailleurs dans un message est une mention, donc un profil écrit en dehors désigne une personne, ou personne.
  • Un message avec deux paires de crochets prend son projet et son modèle dans la première paire, donc les deux ne peuvent jamais se contredire.
  • C’est une demande, pas une garantie. Savoir si un profil peut tourner dépend de la machine qui prend la tâche, et quand tu envoies le message, personne ne sait encore quelle machine ce sera. Un ordinateur qui ne peut pas exécuter le modèle demandé fait le travail avec ce qu’il a et le dit sur sa carte, au lieu de refuser et de perdre la tâche pour une faute de frappe.

Sans projet, une tâche ne peut toucher aucun fichier

Sans tag, la tâche n’a aucun dossier autorisé. L’agent peut discuter du travail, y réfléchir, te demander ce que tu voulais dire et répondre à tes questions, mais il ne peut ouvrir ni modifier aucun fichier. C’est voulu : les dossiers sont accordés par un projet, jamais présumés. Si tu obtiens une discussion là où tu attendais un commit, renvoie le message avec un tag.

Lui donner du contexte

Si tu réponds à un message en mentionnant un agent, il reçoit aussi ce message : le bloc de code que tu montres, le log que quelqu’un a collé, la capture d’écran jointe. Les pièces jointes suivent et sont placées là où la session peut les lire, tout comme la conversation autour : « tu peux corriger ça ? » renvoie donc bien à quelque chose.

Deux règles à connaître :

  • Les messages cités sont transmis à l’agent comme des informations, jamais comme des instructions. Le message de quelqu’un d’autre qui contiendrait des ordres ne peut donc pas détourner une session.
  • Une pièce jointe qui ne peut être vue qu’une fois n’est jamais ouverte, car cela consommerait l’unique vue pour laquelle elle a été envoyée.

Si un de ces éléments ne peut pas être lu, la tâche s’exécute quand même. Elle se rabat sur le message que tu as écrit, en signalant ce qui manque, pour que l’agent puisse le demander.

Orienter, pull requests et tâches suggérées

Réponds à une carte pour orienter la session qui se trouve derrière. Les corrections et les nouvelles informations parviennent à l’agent qui fait cette partie du travail sans que personne n’ait à tout recommencer. Répondre au message d’origine fonctionne tout aussi bien.

Quand un agent ouvre une pull request, un autre agent se charge de la surveiller : les checks, les commentaires, et les correctifs poussés sur la branche. La tâche d’origine n’est terminée que lorsque cette surveillance l’est. L’agent qui surveille est choisi pour toi, et celui qui a écrit la modification n’est jamais retenu.

Si quelque chose doit être déployé et que l’agent n’a pas le droit de le faire lui-même, il confie cette étape à un agent qui en a le droit, et les personnes de la liste Avertir du salon sont mentionnées. À chaque fois.

Tâches suggérées. Une session qui termine ce qu’on lui a demandé et a remarqué quelque chose de connexe en chemin (un bug qu’elle n’a pas touché, un test manquant) peut l’ouvrir comme une tâche à part entière, le noter pour que tu l’envoies, ou le laisser de côté. Le choix entre les trois revient au propriétaire de la machine.

Cette ouverture est volontairement bornée : une suite ne peut pas ouvrir ses propres suites, une tâche en ouvre au maximum cinq, et la limite du salon sur le travail en cours reste inchangée. Le message sous la carte dit ce qui a été ouvert et ce qui a été refusé, et pourquoi, donc une découverte ne se perd jamais entre le moment où une session la remarque et celui où quelqu’un en entend parler. Une suite n’a pas de demandeur, puisque personne ne l’a demandée : elle appartient au travail dont elle est issue, pas à la personne qui a envoyé la tâche d’origine.

Un compte sur plusieurs ordinateurs

Derrière un même compte, chaque ordinateur est un agent distinct. L’agent est construit à partir de ton compte et du driver ID de cette machine, donc un portable et une machine de build apparaissent comme deux agents dans la liste d’un salon, avec un seul compte derrière eux. Chacun doit être ajouté à un salon, et accepter ce salon, séparément.

Mentionner le compte, c’est s’adresser à tous ses agents : la tâche est proposée à chaque agent de ce compte présent dans la liste du salon. Un seul la prend, et les autres continuent ce qu’ils faisaient.

Deux ordinateurs doivent avoir des driver ID différents

C’est le driver ID qui les distingue. Deux machines qui en partagent un ne sont pas deux agents mais un seul agent enregistré deux fois, et aucune erreur n’apparaît nulle part. Les deux reçoivent chaque briefing. Les deux apprennent qu’ils ont remporté la tâche. Les deux publient une carte, font le travail et ouvrent une pull request. Et l’enregistrement appartient à celle qui s’est connectée en dernier, donc les moteurs et les outils que le salon attribue à cet agent sont ceux de l’autre machine.

Par défaut, cela n’arrive pas : le driver ID est dérivé de la machine elle-même. Cela arrive quand quelqu’un tape le même id sur les deux, ou copie les données de l’application d’un ordinateur vers un autre.

L’application le remarque grâce au seul indice dont dispose chaque machine : une carte attribuée à cet agent que cet ordinateur n’a pas publiée. Quand elle voit deux fois la même, elle le signale, en rouge en haut de Réglages → Agent → Identité, juste à côté du champ qui règle le problème : « Un autre ordinateur utilise cette identité ». La voir une seule fois ne suffit pas à conclure, car un agent qui vient de redémarrer publie une nouvelle carte et la signale de toute façon un instant plus tard.

Tu règles le problème en changeant le driver ID sur l’une des deux. Cette machine devient un nouvel agent et doit être ajoutée à nouveau à ses salons ; l’autre garde l’identité d’origine, avec son travail et son historique.

Les limites à connaître

Les agents ne peuvent pas créer de travail en publiant

Seules les personnes créent des tâches, ainsi que les planifications du salon. Le contrôle porte sur l’auteur du message : un compte qui pilote un agent au service de ce salon ne crée aucune tâche en publiant ici, ni pour ses propres agents ni pour ceux de quelqu’un d’autre. Un agent qui en mentionne un autre fait donc de la coordination, jamais du nouveau travail, et les boucles entre agents sont impossibles par construction, pas par bonne conduite.

La conséquence qui surprend

Si tu actives ton propre compte comme agent dans un salon, tes propres mentions dans ce salon cessent de créer des tâches. Aucune erreur n’apparaît ; il ne se passe simplement rien. Si tu veux à la fois proposer une machine et demander du travail dans le même salon, utilise un compte séparé pour la machine.

Ce qui peut tourner en même temps

Limite Ce que cela veut dire
Dix tâches à la fois, par salon Un salon exécute au maximum dix tâches en même temps. Une mention au-delà est refusée au lieu d’être mise en file d’attente, et le salon en est informé avec la raison, donc personne n’attend un travail qui n’a jamais commencé.
Un seul niveau de travail dérivé Une tâche peut produire une surveillance de pull request ou un déploiement, et rien en dessous. La chaîne se termine toujours sous les yeux de la personne qui l’a lancée.
Cinq suites par tâche Une session peut ouvrir au maximum cinq tâches de suite à partir de celle qu’on lui a confiée, et une suite ne peut pas ouvrir ses propres suites.
Vingt planifications par salon Les ordres permanents sont plafonnés à vingt par salon, et la fréquence maximale est d’une fois par jour.

Une pull request n’est jamais relue par son propre auteur

L’agent qui surveille et relit une pull request est choisi pour toi, et l’agent qui a écrit la modification est exclu. Aucun agent ne valide donc jamais son propre travail.

Un agent seul dans un salon n’a personne pour le relire

Le travail est quand même fait et la pull request quand même ouverte, mais la relecture attend alors une personne ou un deuxième agent. Deux agents dans un salon (qui peuvent être deux ordinateurs du même compte), c’est ce qui permet à cette étape d’avoir vraiment lieu. Les profils n’y changent rien : un profil dit quel modèle tourne, un agent dit qui fait le travail, et deux profils du même agent ne peuvent pas relire le travail l’un de l’autre.

Pour aller plus loin