Extensão DevOps de revisão de código usando a Open AI
Créditos ao criador da Extensão
Essa extensão é uma adaptação da versão original criada por Aidan Cole publicada no Azure DevOps Marketplace e disponibilizada no repositório Git
Bem-vindo à Extensão DevOps 'Open AI Code Review' – seu novo aliado na construção de software! Esta extensão integra perfeitamente os poderosos modelos de linguagem da Open AI ao seu pipeline do Azure DevOps, transformando revisões de código em um processo inteligente e potencialmente eficiente.
Comece agora!
Melhore seu fluxo de trabalho de desenvolvimento com a 'Open AI Code Review'. Comece a receber insights inteligentes e acionáveis sobre suas alterações de código. Instale a extensão e experimente o que pode ser o futuro das revisões de código!
Por que escolher a Open AI Code Review?
- Revisões de código automatizadas: Diga adeus às inspeções manuais de código! Deixe a Open AI analisar suas alterações de código, detectando bugs, problemas de desempenho e sugerindo melhores práticas.
- Instalação sem esforço: Uma instalação simples com apenas um clique a partir do Azure DevOps Marketplace coloca-a em funcionamento instantaneamente.
- Insights com tecnologia de IA: Aproveite os últimos avanços em processamento de linguagem natural para receber comentários perspicazes sobre seus pull requests.
- Revisões mais rápidas: Reduza o tempo gasto em revisões de código. Deixe a Open AI cuidar da rotina, permitindo que sua equipe se concentre em trabalho impactante.
- Configurável e personalizável: Adapte a extensão às suas necessidades com configurações personalizáveis. Especifique o modelo Open AI, defina exclusões de arquivo e muito mais.
Pré-requisitos
Começando
Instale a extensão DevOps do Open AI Code Review do Azure DevOps Marketplace.
Adicione a tarefa de revisão de código Open AI ao seu pipeline:
trigger:
tags:
include:
- Releases/*
branches:
include:
- CodeReview_LongPromptInPortuguese
resources:
- repo: self
pool:
name: Jenkins Server
stages:
- stage: CR
jobs:
- job: Review
displayName: Code Review
steps:
- checkout: self
persistCredentials: true
- task: OpenAICodeReviewCepedi@1
inputs:
api_key: $(OPENAI_API_KEY)
api_key_CEPEDI: $(TOKEN_PROJETO_CEPEDI)
prompt_name: React TypeScript
file_extensions: '.cs,.csproj,.sln,.yml,.json,.config,.md,.tsx'
file_excludes: '.scss,Designer.cs,MeuDbContextModelSnapshot.cs,Tests.cs,Resources.cs'
Se você ainda não tiver a Build Validation configurada para sua ramificação, adicione-a Build validation para sua política de branch para acionar a revisão de código quando um pull request for criado.
Outras informações de como ativar e usar a extensão nos Pull Requests, estão disponíveis neste tutorial
Observações: a) os modelos 'o1', 'o1-mini' e 'o3-mini' não usam os parâmetros de temperatura e top_p, portanto, não deve-se tentar controlar a precisão dos mesmos usando tais modelos, estes não são considerados nas requições ao GPT.; b) o parâmetro max_tokens está sendo usando para simples validação em relação ao prompt e não em relação ao prompt + arquivo (para cada arquivo), este valor não é enviado ao GPT.
Como trabalhar em modificações ou novas versões da extensão de revisão de código?
- Para começar, clone o repositório do azure Code Review Azure Extension;
- Faça as devidas modificações e, antes de publicar a extensão ou nova versão da extensão, altere as versões no arquivos: 'package.json', 'task.json' e 'vss-extension.json'. Pode-se utilizar a mesma versão nos três arquivos;
- Compile os arquivos: dentro do diretório 'Open AI Code Review/src', use o segunite comando no cmd 'tsc --build';
- No diretório 'Open AI Code Review', use o seguinte comando para gerar a nova versão ou versão inicial da extensão: 'npx tfx-cli extension create'
- Se a extensão já estiver instalada, esta DEVE ser desinstalada para que as modificações sejam persisitdas na nova instalação. Para desinstalar a extensão (use a conta azure@cepedi.org.br para fazer a desinstalação) atarvés das configurações de extensões da organização
- Para atualizar ou publicar uma extensão, você pode usar a sua conta do azure ou a conta azure@cepedi.org.br e fazer o upload da entensão no Azure DevOps Marketplace. Espere alguns minutos até que a extensão seja validada e, após isso, clique nos três pontinhos e em 'view extension', copie o link e para instar com a conta azure@cepedi.org.br;
- Para instar a extensão (use conta azure@cepedi.org.br) cole o link copiado no passo 6 e clique em instalar. Para conferir se a instalação ocorreu normalmente, pesquise se a extensão aparece nas configurações de extensões da organização
Perguntas frequentes
Q: Quais configurações do agente de trabalho (agent job) são necessárias?
A: Certifique-se de que "Permitir que scripts acessem o token OAuth" esteja habilitado como parte do trabalho do agente. Siga a documentação para mais detalhes.
Q: Quais permissões são necessárias para Build Administrators?
A: Build Administrators devem receber acesso "Contribuir para solicitações de pull". Verifique esta resposta do Stack Overflow para obter orientação sobre como configurar permissões.
Relatórios de bugs
Se você encontrar um bug ou comportamento inesperado, por favor, reporte-o ao time de IA do CEPEDI.
Solicitações de recursos/ novas características e funcionalidades
Se você tiver ideias para novos recursos ou melhorias, por favor, solicite como tarefa ao time de IA.
License
Este projeto está licenciado sob a Licença MIT, seguindo as recomendações do criador da extensão.
Se você gostaria de contribuir para o desenvolvimento desta extensão, siga nossas diretrizes de contribuição.
| |
