Aller au contenu

Parler à Control Center depuis une PR GitHub

Ce guide explique comment travailler avec Control Center sans quitter GitHub : demandez une revue par IA depuis la page de la PR, posez une question au bot dans un commentaire, et poursuivez la conversation dans ses fils de revue.

Les réponses passent par la voie GitHub de l’espace de travail : la GitHub App propre à votre serveur, ou l’App partagée de Control Center via Connect. Rien de nouveau n’est enregistré, et rien n’a besoin d’être joignable depuis Internet : le serveur découvre ce qui a été dit sur GitHub par sondage, si bien qu’un ordinateur portable derrière un NAT se comporte exactement comme un déploiement public.

  • L’espace de travail dispose d’une voie GitHub : la GitHub App propre au serveur ou Connect, avec l’application installée sur le compte propriétaire du dépôt. Une application propre a besoin de Pull requests et Issues en lecture et écriture, ce que Créer mon application GitHub accorde déjà
  • Le dépôt est lié à un espace de travail dans Control Center
  • Vous êtes connecté à GitHub sur ce serveur, et vous pouvez pousser vers le dépôt
  • Ni URL de webhook, ni tunnel, ni callback — il n’y a rien à configurer côté réseau

Mentionnez @usectrl, le compte GitHub dédié à Control Center. C’est le seul déclencheur : mentionner l’identifiant de connexion propre à l’App n’a aucun effet. La voie GitHub de votre espace de travail traite toujours la demande et publie les réponses. Vous n’avez pas besoin des identifiants du compte usectrl.

Deux moyens, qui lancent tous deux le même pipeline pr_review amorcé que le bouton Ask AI :

  • Ajoutez l’étiquette ai-review à la PR. C’est ce que GitHub propose de plus proche d’une affectation du bot comme relecteur — les comptes d’application ne peuvent pas occuper le créneau natif de relecteur demandé. Votre compte réagit à la PR avec 👀 et la revue démarre dans Control Center ; aucun commentaire n’est publié
  • Commentez @usectrl review (ou simplement @usectrl) dans la conversation de la PR. Un 👀 apparaît sur votre commentaire, puis une réponse indique que la revue a démarré (ou qu’une revue est déjà en cours)

Les relecteurs travaillent dans l’espace de revue de la PR ; lisez et publiez les constats comme dans Utiliser la revue assistée par IA. La publication vers GitHub reste une décision que vous prenez dans Control Center — lancer une revue depuis GitHub ne publie rien sur GitHub de lui-même.

L’étiquette ne se déclenche qu’une fois par PR : l’ajouter constitue la demande, et elle n’est pas réarmée lorsqu’on la retire puis la rajoute. Pour relancer une revue — après un push, par exemple — mentionnez le bot.

Commentez dans la conversation de la PR :

@usectrl why does the flaky test in runner_test.dart fail on CI but not locally?

Ce qui se passe, dans l’ordre :

  1. Un 👀 apparaît sur votre commentaire, depuis votre propre compte, pour vous montrer que le commentaire a été vu
  2. La question est publiée dans l’espace de revue de la PR en votre nom — même attribution que si vous l’aviez saisie dans Control Center
  3. Un agent répond dans l’espace, et la réponse est renvoyée sur la PR. Chaque réponse commence par **Control Center** (for @your-login):

Une question sur une PR qui n’a pas encore de revue réveille l’agent CEO de l’espace de travail ; une fois qu’une revue a tourné, c’est l’agent qui a parlé en dernier qui répond, donc les relances aboutissent chez qui détient le contexte.

Répondez à l’intérieur d’un fil de revue en ligne auquel le bot participe — un commentaire sur le diff qu’il a laissé, ou une réponse qu’il a publiée dans ce fil. Aucune mention n’est nécessaire ; le fil est l’adressage :

> @usectrl the retry loop looks O(n²) to me
what would the complexity be with the bounded queue instead?

Les échanges à plusieurs tours fonctionnent de la même façon : chaque réponse est une nouvelle question dans la même conversation, avec l’espace de revue pour contexte, et la réponse revient dans le fil.

Une relance dans la chronologie de la conversation de la PR constitue un nouveau commentaire de premier niveau, elle nécessite donc toujours une @mention.

Le serveur résout l’auteur d’un commentaire, ou la personne qui a ajouté l’étiquette ai-review, avant de faire quoi que ce soit :

  • Le compte GitHub doit être connecté sur ce serveur. La correspondance se fait sur l’identifiant numérique du compte GitHub, jamais sur l’identifiant de connexion. Connectez-vous depuis Paramètres → Vous → Profil → Hébergement de code
  • La personne doit être membre avec un rôle d’écriture (member, admin ou owner) dans l’espace de travail qui lie le dépôt
  • Elle doit pouvoir pousser vers le dépôt sur GitHub. Les réponses utilisent un jeton limité à l’accès de cette personne, si bien que quelqu’un qui ne peut que lire n’obtient aucune réponse

Toute autre personne est ignorée en silence : rien n’est publié, et ses propos n’entrent jamais dans l’espace de travail. Les commentaires des bots, et les propres réponses de Control Center, ne sont jamais traités comme des questions.

Le 👀 est aussi la façon dont les serveurs s’accordent sur celui qui répond. Il est ajouté avec la connexion propre à l’auteur, et GitHub indique au serveur si cette réaction est nouvelle. Si vous êtes connecté sur deux serveurs Control Center qui lient tous deux le dépôt, le premier à réagir répond et l’autre reste silencieux. Il en va de même pour l’étiquette.

Élément Comportement
Accusé de réception 👀 depuis votre compte sur le commentaire (ou sur la PR, pour l’étiquette), en l’espace d’un balayage
Réponses Publiées dans le fil où la question a été posée, en commençant par **Control Center** (for @your-login):. Rédigées par le bot de l’application : sur l’application Connect partagée, une réponse dans un fil de revue est rédigée par votre propre compte, sauf si l’opérateur de Connect a listé cette installation
Attribution dans l’espace La question est la vôtre ; l’agent s’exécute en votre nom, selon les réglages d’autonomie de l’espace
Revues Les constats arrivent dans l’espace de revue ; la publication vers GitHub est manuelle

Un balayage a lieu toutes les minutes avec une application propre et examine jusqu’à 25 pull requests ; via Connect, il a lieu toutes les deux minutes et en examine jusqu’à 10, car ces appels partagent le quota GitHub propre à chaque membre. Un espace de travail dont le quota GitHub est inférieur à 15 % est ignoré jusqu’à ce qu’il se rétablisse. Cette latence est le prix à payer pour n’avoir besoin d’aucun accès réseau entrant. Rien n’est perdu pendant que le serveur est hors ligne — un commentaire qui arrive pendant une interruption est rattrapé au balayage suivant.

Rien ne se passe pour un commentaire qui mentionne le bot.

  • L’application est-elle installée sur le compte qui possède le dépôt, et le dépôt lié à un espace de travail ? Un dépôt non lié est ignoré avant que quoi que ce soit ne soit enregistré, donc le lier plus tard livre quand même le commentaire
  • Êtes-vous connecté à GitHub sur ce serveur, membre avec un rôle d’écriture et en mesure de pousser vers le dépôt ? Le serveur ignore toute autre personne sans répondre
  • Toujours rien ? Le journal du serveur nomme le balayage et la PR en cas d’échec ; cherchez pr_conversation: (l’interrogateur) et github_pr_conversation: (la passerelle)

L’étiquette ne lance pas de revue.

Elle ne se déclenche qu’une fois par PR, et la personne qui l’a ajoutée passe les mêmes contrôles que l’auteur d’un commentaire. Si une revue a déjà tourné, ou si l’étiquette a été ajoutée avant que le serveur n’ait jamais vu la PR (le premier balayage enregistre l’arriéré en silence au lieu de le traiter en rafale), mentionnez plutôt le bot — @usectrl review en lance toujours une, sauf si une revue est déjà en cours.

La réponse du bot n’est jamais arrivée sur GitHub.

La réponse elle-même n’est jamais perdue — elle se trouve dans l’espace de revue de la PR, dans Control Center. Un échec de publication (GitHub indisponible, autorisations modifiées) est journalisé et la réponse n’est pas réessayée ; reposez la question dans le fil si cela compte.