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.
Prérequis
Section intitulée « Prérequis »- 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
Trouver le nom de votre bot
Section intitulée « Trouver le nom de votre bot »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.
Demander une revue depuis GitHub
Section intitulée « Demander une revue depuis GitHub »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.
Poser une question
Section intitulée « Poser une question »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 :
- Un 👀 apparaît sur votre commentaire, depuis votre propre compte, pour vous montrer que le commentaire a été vu
- 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
- 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.
Poursuivre dans un fil de revue
Section intitulée « Poursuivre dans un fil de revue »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.
À qui le bot s’adresse
Section intitulée « À qui le bot s’adresse »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,adminouowner) 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.
Deux serveurs, une PR
Section intitulée « Deux serveurs, une PR »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.
Ce à quoi vous attendre
Section intitulée « Ce à quoi vous attendre »| É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.
Dépannage
Section intitulée « Dépannage »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) etgithub_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.
Guides connexes
Section intitulée « Guides connexes »- Créer la GitHub App : l’enregistrement dont naît le bot
- Utiliser la revue assistée par IA : lire les constats que produit une revue lancée par une mention
- Configurer l’intégration GitHub : lier votre propre compte GitHub, sur lequel le bot s’appuie pour vous identifier
- Utiliser les espaces : le lieu où tout cela aboutit