1
edfreitas
2 min de leitura ·

Apresentando agentes de revisão de código com IA personalizados para Pull Requests

Recentemente, lançamos na Kodus os Custom Review Agents (Beta), um recurso que permite criar agentes especializados para trabalhar junto com a Kody durante o code review.

A ideia é que, em vez de depender apenas de um agente generalista, você possa configurar revisores com responsabilidades específicas. Por exemplo, um agente focado em arquitetura, outro em segurança, cobertura de testes ou identificação de código duplicado.

Como funciona?

Você pode criar um agente a partir de um dos templates disponíveis ou aproveitar uma skill que já existe no seu repositório e transformá-la em um revisor.

Cada agente pode:

  • Analisar arquivos específicos, seguindo as instruções, skills e documentação do projeto.
  • Utilizar ferramentas externas, como plugins, CLIs do próprio time e buscas estruturais com ast-grep.
  • Executar reviews sob demanda, quando você precisar de uma análise mais específica em uma PR.

Isso permite, por exemplo, criar um agente que verifica se uma mudança respeita as decisões arquiteturais do projeto ou que utiliza um linter interno para identificar problemas que um review genérico poderia deixar passar.

Testando antes de ativar

Uma preocupação que tivemos durante o desenvolvimento foi como permitir que os times validassem o comportamento desses agentes antes de colocá-los para rodar nas PRs.

Por isso, criamos o Try it.

Com ele, você consegue executar um agente em uma PR real, visualizar quais sugestões ele faria e ajustar suas instruções sem publicar nenhum comentário.

Assim, dá para testar diferentes configurações antes de ativar o agente no fluxo de review do time.

Ainda estamos em beta

Os Custom Review Agents estão em beta, e queremos entender como outros times utilizariam esse tipo de recurso no dia a dia.

A documentação explica como criar e configurar os agentes:

Documentação dos Custom Review Agents

Fiquei curioso para saber: vocês já utilizam agentes especializados no processo de code review ou preferem manter tudo concentrado em um único agente?

Carregando publicação patrocinada...
1

Acho que especializado faz sentido pra coisa que tem regra clara, tipo segurança ou decisão de arquitetura que tá documentada. O que me preocuparia com vários agentes na mesma PR é dois deles apontando o mesmo problema na mesma linha com palavras diferentes, aí o dev começa a ignorar tudo. Vocês juntam as sugestões repetidas antes de publicar? O Try it já ajuda nisso, dá pra ver o volume de comentário antes de ligar pro time.

1

Faz sentido

Sobre os comentários duplicados, a gente já tem uma etapa de deduplicação antes de publicar as sugestões. No caso das Kody Rules (regras personalizadas que o time configura para o code review), isso é feito de forma determinística. Já os achados dos agentes, incluindo os customizados, passam por uma análise que identifica sugestões sobre o mesmo problema, mesmo quando estão escritas de formas diferentes.

A gente também toma cuidado pra não juntar problemas distintos. Se não houver confiança suficiente de que dois achados são duplicados, mantemos os dois.

Sobre o volume de comentários, também dá pra definir um limite de sugestões por agente em cada PR e o nível de severidade, o que ajuda a evitar excesso de comentários.

E sobre o Try it, hoje você consegue testar cada agente individualmente em uma PR real e ver quais comentários ele faria, sem publicar nada.

2

Valeu pela resposta. Manter os dois quando a confiança é baixa acho a escolha certa, comentário repetido incomoda bem menos que um problema real sumindo da PR. O limite de sugestões por agente eu não tinha visto, com isso dá pra começar com pouco e ir abrindo conforme o time se acostuma.