Última atualização: 16 de abril de 2026

Documentação

Este guia cobre tudo o que você precisa para começar a usar o BlueAI Akira, entender como as revisões funcionam e aproveitar ao máximo o Console. Se algo aqui não estiver claro ou faltar, é só falar com a gente.

1. Visão geral

O Akira revisa seus Pull Requests automaticamente e aponta vulnerabilidades direto no GitHub — onde o seu time já trabalha.

Sempre que alguém abre um Pull Request (ou faz um novo push em um PR já aberto), o Akira recebe o evento via webhook, analisa o diff com IA e publica comentários diretamente no próprio PR. Cada comentário traz nível de severidade, o código CWE da vulnerabilidade encontrada e uma sugestão de correção.

O foco é segurança real, baseada no OWASP Top 10 — SQL Injection, XSS, exposição de segredos, quebra de controle de acesso e o resto da lista. O Akira roda em paralelo ao seu CI (nunca no caminho crítico): não bloqueia merge, não atrasa deploy e devolve a análise tipicamente em poucos segundos.

2. Primeiros passos

São três passos até a primeira revisão acontecer sozinha.

3. Como funcionam as revisões

Toda revisão dispara por webhook, roda em paralelo ao seu CI e publica comentários direto na linha do código.

Quando a revisão dispara

• Na abertura de um Pull Request.
• A cada novo push em um PR já aberto — cada push gera uma nova revisão e consome 1 unidade da cota mensal.

O que é analisado

• O diff do PR contra a branch-alvo (só as mudanças, nunca o repositório inteiro).
• Vulnerabilidades do OWASP Top 10 — SQL Injection, XSS, exposição de segredos, controle de acesso quebrado, entre outras.
• Padrões de código relacionados a segurança, performance e boas práticas.

Onde os comentários aparecem

Direto na aba Files changed do Pull Request no GitHub, na linha exata do problema. Cada comentário inclui tipo, severidade, código CWE (quando aplicável) e uma sugestão de correção — não é só "isso está errado", é "troque por isso aqui".

Os 8 tipos de comentário

• Bug — erro funcional no código.
• Typo — erro de digitação.
• Code Smell — código que funciona, mas indica má estrutura.
• Best Practice — divergência das boas práticas da linguagem ou framework.
• Security — questão geral de segurança.
• Vulnerability — vulnerabilidade conhecida, com classificação CWE.
• Performance — impacto em desempenho.
• Architecture — questão estrutural ou arquitetural.

4. O Console

É o painel web onde você acompanha métricas, gerencia repositórios, licenças e plano.

• Home: métricas principais — PRs revisados nos últimos 7 dias, total de comentários, média de comentários por PR, uso da cota mensal, gráfico de tendência e distribuição dos tipos de comentário.
• Minha Conta: dados de perfil, integração com GitHub, troca de senha e informações do plano.
• Repositórios: lista dos repos sincronizados do GitHub — ligar/desligar revisão, filtrar por status, sincronizar manualmente.
• Licenças: gestão dos desenvolvedores com acesso ao Akira (seat-based, limite conforme o plano).
• Planos: ver o plano atual, comparar opções e fazer upgrade.
• Configurações: preferências gerais, incluindo idioma dos comentários.
• Sino de notificações: avisos importantes (cota acabando, falha em revisão, mudança de plano) no topo do Console.

5. Gerenciar repositórios

Na tela Repositórios você controla em quais projetos o Akira atua.

• Ligar/desligar revisão: cada repositório tem um toggle. Desligar não desinstala o GitHub App — o Akira simplesmente ignora os eventos daquele repo. Útil para pausar revisões em projetos legados ou repositórios de documentação.
• Filtro por status: separe ativos de desativados para localizar rapidamente.
• Sincronizar com o GitHub: se um repositório novo ainda não aparece, clique em Sincronizar — o Akira busca no GitHub e atualiza a lista.
• Público vs privado: no plano Open só repositórios públicos são suportados. A partir do Squad, privados também.

Para dar ou remover acesso a repositórios inteiros, a configuração é feita na página do GitHub App, dentro das configurações da sua organização no GitHub. O Akira respeita estritamente o que foi autorizado lá.

6. Gerenciar desenvolvedores (licenças)

Nos planos pagos, cada desenvolvedor que tem PRs revisados ocupa uma licença (seat).

A tela Licenças mostra quem da sua organização está ativo, quantas licenças você tem disponíveis e quantas já foram ocupadas. Você pode adicionar e remover devs conforme o time muda.

• Adicionar desenvolvedor: informe e-mail ou usuário do GitHub e envie o convite.
• Remover desenvolvedor: libera o seat para ser atribuído a outra pessoa. Toda remoção pede confirmação antes de executar.
• Limites por plano: Open (1 dev), Squad (até 5), Scale (conforme contratado), Enterprise (até 30).

Se você tentar adicionar mais pessoas do que o plano permite, o Console sugere um upgrade. No Enterprise, a gestão de time ganha recursos adicionais como SSO e controles centralizados.

7. Planos e cotas

A cota é sempre em PRs revisados por mês — cada push em um PR aberto conta como 1 revisão.

Como a cota funciona

Uma PR com 4 pushes subsequentes consome 5 revisões da sua cota (1 abertura + 4 pushes). A cota renova no início de cada ciclo mensal.

Planos disponíveis

• Open — grátis para sempre: repositórios públicos, 30 PRs/mês, revisão básica, acesso ao Console. Ideal para projetos open source e para testar sem cartão.
• Squad — R$ 79/dev/mês: até 5 devs, repositórios privados, 150 PRs/mês/dev, suporte por e-mail.
• Scale — R$ 97/dev/mês (mais popular): 500 PRs/mês/dev, análise OWASP completa, alertas de performance, diff ilimitado, suporte prioritário.
• Enterprise — R$ 2.497/mês (até 30 devs): SSO, gestão de times, SLA formal, opção on-premise.

Quando a cota é atingida

As próximas revisões ficam pausadas até o próximo ciclo ou até você fazer upgrade. Os PRs continuam sendo abertos normalmente no GitHub — apenas o Akira para de comentar. O sino de notificações avisa antes de chegar nesse ponto.

Como fazer upgrade

Acesse Planos no Console, escolha o plano desejado e finalize o pagamento. O novo limite passa a valer imediatamente.

8. Idioma e configurações

Hoje o Akira comenta em português do Brasil.

Na seção Configurações do Console, você pode ajustar a preferência de idioma:

• Português do Brasil (pt-BR): disponível.
• Inglês (en-US): em breve.
• Espanhol (es): em breve.

9. Privacidade do seu código

Seu código não é armazenado. Ponto.

Quando um PR dispara uma revisão, o Akira recebe o diff do GitHub, processa em memória, gera os comentários e descarta o conteúdo. Nada fica em disco, nada vai para log, nada é usado para treinar modelo.

O que persiste no nosso banco são apenas metadados: qual PR foi revisado, quantos comentários foram gerados, a qual repositório pertence e a qual usuário está vinculado — o suficiente para a sua cota, as métricas do Console e o histórico de faturamento.

Se você desinstalar o GitHub App, o Akira para imediatamente de receber eventos dos seus repositórios. Detalhes completos em Segurança e Política de Privacidade.

10. Perguntas frequentes

As dúvidas que mais aparecem.

11. Suporte

Se travou em algo, prefira falar com a gente a ficar tentando adivinhar.

• Plano Open: documentação pública (esta página) e base de conhecimento.
• Plano Squad: suporte por e-mail.
• Plano Scale: suporte prioritário, com tempo de resposta mais curto.
• Plano Enterprise: SLA formal definido em contrato e canal dedicado com o time.

Contato geral: contato.akira@blueaisolutions.com.br

Se encontrou um problema técnico, inclua no e-mail: nome da sua organização no GitHub, repositório afetado, URL do PR (quando aplicável) e horário aproximado do ocorrido. Isso acelera bastante a investigação.

Se achar que o Akira errou em algum comentário, nos avise também. Feedback sobre falso-positivo é o que ajuda a gente a calibrar melhor as revisões ao longo do tempo.