AgentBase

O que é AgentBase?

AgentBase é um workspace de review de PR que consolida múltiplas ferramentas em uma única página para revisar pull requests. Ele combina o diff do GitHub com a intenção e contexto do PR, incluindo uma nota do autor e um painel de Q&A no estilo “Pergunte-me qualquer coisa” para ajudar os revisores a entenderem o que mudou e por quê.

O propósito principal é reduzir a troca de abas durante o review de PR, reunindo os materiais que os revisores geralmente precisam — diff, contexto da thread, ticket/intenção e navegação no código — em um único fluxo de trabalho, além de adicionar uma forma de responder perguntas de acompanhamento diretamente no mesmo painel.

Principais Recursos

• Superfície de review de PR em uma página (em vez de múltiplas abas): Consolida diff, contexto de discussão/thread, visualização de blame/histórico, contexto de ticket/por quê e um painel de Q&A com IA em um único workspace.
• Pings de revisores baseados no Slack com intenção estruturada: Envia uma mensagem no Slack que inclui a intenção do PR, escopo, lógica de código relevante alterada e tempo estimado de leitura para que os revisores se orientem rapidamente antes de abrir o PR.
• Nota do “autor” do PR vinculada ao diff: Exibe uma nota do autor (incluindo link para ticket referenciado) ao lado das linhas relevantes do diff, capturando o raciocínio para a mudança.
• Carregamento de contexto para perguntas aprofundadas: Quando um revisor faz perguntas (ex.: onde uma função é chamada ou qual o raio de explosão), o AgentBase carrega o PR e padrões de review do codebase relevante para que as respostas apareçam sem trocar de branch.
• Manipulação de transcrições com redação: Remove segredos antes de salvar transcrições (ex.: chaves/tokens/senhas/chaves privadas são substituídas por [REDACTED]) e não armazena outras informações além do descrito.
• Escopo focado em privacidade do que é capturado: Captura apenas a conversa feita com a IA para aquele PR, junto com metadados básicos do PR (repo, branch, commit), quando o revisor abre um PR.

Como Usar o AgentBase

• Instale e abra durante o beta: O site mostra a instalação via npx useagentbase@latest install.
• Comece a revisar um PR: Ao abrir um pull request, o AgentBase apresenta uma página de review consolidada com o diff, intenção do autor e contexto de suporte.
• Faça perguntas de acompanhamento no painel: Use a interface “Pergunte-me qualquer coisa” (rotulada como Sprig na página) para solicitar detalhes como “onde uma função é chamada” ou “o que mais essa mudança afeta”, com citações vinculadas ao que está disponível no PR e codebase.
• Use o ping do Slack como ponto de entrada: O AgentBase pode enviar mensagem ao revisor certo no Slack com intenção, escopo, lógica principal alterada e tempo de leitura para ajudar a decidir o foco.

Casos de Uso

• Refatores de auth em edge/middleware: Se um PR move lógica de autenticação/limitação de taxa de manipuladores por rota para middleware de edge, revisores podem usar o painel para verificar escopo (ex.: arquivos/pacotes), raciocínio fixado no diff e se todos os pontos de chamada foram migrados.
• Review de “raio de explosão” durante migrações: Quando a mudança substitui uma função (ex.: fetchSession por leituras baseadas em header), o revisor pode perguntar o impacto no repositório e se há pontos de chamada órfãos.
• Determinar rapidamente o que mudou e por quê: Para PRs que incluem diffs de código e notas de intenção (link de ticket, raciocínio do autor), revisores podem ler a “nota do autor” ao lado das linhas explicadas, em vez de buscar em abas.
• Responder perguntas de consistência durante o review: Se um revisor quer saber se um padrão de refactor similar foi enviado antes (ex.: refactor anterior de middleware de sessão), pode solicitar essa comparação diretamente no painel de Q&A.
• Triagem de fila de review da equipe: Quando PRs ficam na fila, pings do Slack fornecem o resumo estruturado necessário para iniciar o review de forma eficiente, incluindo tempo estimado de leitura.

FAQ

• O que o AgentBase coleta quando abro um PR? Captura a conversa que você teve com a IA sobre aquela mudança, mais detalhes básicos do PR (repo, branch, commit). Não monitora você enquanto codifica ou lê outro conteúdo no laptop.

• O AgentBase armazena segredos da minha conversa com IA? A transcrição passa por um limpador antes de salvar. Chaves de API, tokens, senhas e chaves privadas são substituídas por [REDACTED] automaticamente.

• Posso fazer perguntas além da visualização do diff? Sim. A interface suporta perguntas de acompanhamento (ex.: onde uma função é chamada, qual o raio de explosão), e o painel cita informações relevantes carregadas do PR e codebase.

• Como funcionam as notificações? O site descreve mensagens do Slack enviadas ao revisor certo, incluindo intenção do PR, escopo, lógica principal alterada e tempo estimado de leitura.

• Como instalo o AgentBase? A página mostra instalação com npx useagentbase@latest install (notado como disponível durante o beta).

Alternativas

• Revisão manual de PR com UI padrão do GitHub + anotações separadas: Revisores podem abrir o diff, verificar a conversa e usar busca/blame diretamente. Isso geralmente exige mais trocas de contexto do que um workspace consolidado em uma única página.
• Assistentes de código com IA usados em paralelo com abas de PR: Ferramentas que geram explicações ou respostas podem ser usadas junto ao GitHub, mas podem não centralizar automaticamente o contexto do diff, blame e ticket/intenção em uma única superfície de revisão.
• Sistemas de workflow que roteiam PRs por função e enviam notificações no Slack: Algumas equipes usam automação para notificar revisores, mas sem a mesma consolidação de “diff + intenção + Q&A” em um só lugar.
• Checklists e templates de code review: Equipes podem reduzir contexto perdido com checklists padronizados e templates de PR; isso ajuda na consistência, mas não fornece Q&A específica de PR vinculada ao diff e codebase da mesma forma.