AgentBase

Qu'est-ce qu'AgentBase ?

AgentBase est un espace de travail de revue de PR qui regroupe plusieurs outils sur une seule page pour examiner les pull requests. Il associe le diff GitHub à l'intention et au contexte de la PR, incluant une note de l'auteur et un panneau de type Q&R (« Ask me anything ») pour aider les relecteurs à comprendre ce qui a changé et pourquoi.

L'objectif principal est de réduire le jonglage d'onglets lors de la revue de PR en regroupant les éléments habituellement nécessaires aux relecteurs — diff, contexte du thread, ticket/intention et navigation dans le code — dans un seul flux de travail, tout en ajoutant un moyen de répondre aux questions de suivi directement dans le même panneau.

Fonctionnalités clés

• Surface de revue de PR sur une seule page (au lieu de plusieurs onglets) : Regroupe le diff, le contexte de discussion/thread, la vue blame/historique, le contexte ticket/pourquoi, et un panneau Q&R IA dans un seul espace de travail.
• Alertes Slack pour relecteurs avec intention structurée : Envoie un message Slack incluant l'intention de la PR, la portée, la logique de code modifiée pertinente, et un temps de lecture estimé pour que les relecteurs s'orientent rapidement avant d'ouvrir la PR.
• Note de l'auteur liée au diff : Affiche une note de l'auteur (incluant le lien vers le ticket référencé) à côté des lignes de diff concernées, capturant le raisonnement du changement.
• Chargement de contexte pour questions approfondies : Quand un relecteur pose des questions (ex. : où une fonction est appelée ou quel est le rayon d'impact), AgentBase charge la PR et les patterns de revue du codebase pertinent pour que les réponses apparaissent sans changer de branche.
• Gestion des transcripts avec masquage : Nettoie les secrets avant de sauvegarder les transcripts (ex. : clés API/tokens/mots de passe/clés privées remplacés par [REDACTED]) et ne stocke pas d'autres informations au-delà de ce qui est décrit.
• Portée axée sur la confidentialité de ce qui est capturé : Ne capture que la conversation avec l'IA pour cette PR, avec les métadonnées de base de la PR (repo, branche, commit), quand le relecteur ouvre une PR.

Comment utiliser AgentBase

• Installer et l'ouvrir en bêta : Le site affiche l'installation via npx useagentbase@latest install.
• Commencer la revue d'une PR : Quand vous ouvrez une pull request, AgentBase présente une page de revue consolidée avec le diff, l'intention de l'auteur et le contexte de support.
• Poser des questions de suivi dans le panneau : Utilisez l'interface « Ask me anything » (labellisée Sprig sur la page) pour demander des détails comme « où une fonction est appelée » ou « ce que ce changement affecte d'autre », avec citations liées au contenu disponible dans la PR et le codebase.
• Utiliser l'alerte Slack comme point d'entrée : AgentBase peut envoyer un message au bon relecteur dans Slack avec l'intention, la portée, la logique principale modifiée et le temps de lecture pour vous aider à décider sur quoi vous concentrer.

Cas d'usage

• Refactorisations d'authentification edge/middleware : Si une PR déplace la logique d'authentification/limitation de taux des handlers par route vers un middleware edge, les relecteurs peuvent utiliser le panneau pour vérifier la portée (ex. : fichiers/paquets), le raisonnement épinglé au diff, et si tous les sites d'appel ont été migrés.
• Revue du « rayon d'impact » lors de migrations : Quand le changement remplace une fonction (ex. : fetchSession par des lectures basées sur en-tête), le relecteur peut demander l'impact dans tout le dépôt et s'il y a des sites d'appel orphelins.
• Déterminer rapidement ce qui a changé et pourquoi : Pour les PR incluant diffs de code et notes d'intention (lien ticket, raisonnement auteur), les relecteurs peuvent lire la « note de l'auteur » à côté des lignes expliquées plutôt que de chercher dans plusieurs onglets.
• Répondre à des questions de cohérence en revue : Si un relecteur veut savoir si un pattern de refactor similaire a été déployé avant (ex. : refactor middleware de session précédent), il peut demander cette comparaison directement dans le panneau Q&R.
• Triage de file d'attente de revue d'équipe : Quand les PR attendent en file, les alertes Slack fournissent le résumé structuré nécessaire pour démarrer la revue efficacement, incluant un temps de lecture estimé.

FAQ

• Que collecte AgentBase quand j'ouvre une PR ? Il capture la conversation que vous avez eue avec l'IA sur ce changement, plus les détails de base de la PR (repo, branche, commit). Il ne vous surveille pas pendant que vous codez ou lisez d'autres contenus sur votre ordinateur.

• AgentBase stocke-t-il les secrets de ma conversation IA ? Le transcript passe par un nettoyeur avant sauvegarde. Les clés API, tokens, mots de passe et clés privées sont automatiquement remplacés par [REDACTED].

• Puis-je poser des questions au-delà de la vue diff ? Oui. L'interface supporte les questions de suivi (ex. : où une fonction est appelée, quel est le rayon d'impact), et le panneau cite les informations pertinentes chargées depuis la PR et le codebase.

• Comment fonctionnent les notifications ? Le site décrit les messages Slack envoyés au bon relecteur, incluant l'intention de la PR, la portée, la logique principale modifiée et le temps de lecture estimé.

• Comment installer AgentBase ? La page montre l'installation avec npx useagentbase@latest install (noté comme disponible en bêta).

Alternatives

• Examen manuel des PR avec l’interface GitHub standard + notes séparées : Les examinateurs peuvent ouvrir le diff, consulter la conversation et utiliser la recherche/blame directement. Cela nécessite généralement plus de changements de contexte qu’un espace de travail consolidé sur une seule page.
• Assistants IA pour code utilisés en parallèle avec les onglets PR : Des outils qui génèrent des explications ou réponses peuvent être utilisés avec GitHub, mais ils ne centralisent pas automatiquement le contexte du diff, le blame et le ticket/intention sur une seule surface d’examen.
• Systèmes de workflow qui routent les PR par rôle et envoient des notifications Slack : Certaines équipes utilisent l’automatisation pour notifier les examinateurs, mais sans la même consolidation « diff + intention + Q&R » en un seul endroit.
• Listes de vérification et modèles pour code review : Les équipes peuvent réduire les contextes manqués via des listes standardisées et des modèles PR ; cela favorise la cohérence mais ne fournit pas de Q&R spécifique aux PR lié au diff et au codebase de la même manière.