{"meta":{"title":"Configuração automática de cobertura de código","intro":"Um agente habilitado para IA pode analisar seu repositório e gerar um fluxo de trabalho de cobertura de código de trabalho, para que você possa começar a acompanhar a cobertura de teste sem criar manualmente a configuração de CI.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/concepts","title":"Concepts"},{"href":"/pt/code-security/concepts/code-quality","title":"Qualidade do código"},{"href":"/pt/code-security/concepts/code-quality/automatic-code-coverage-setup","title":"Cobertura automática de código"}],"documentType":"article"},"body":"# Configuração automática de cobertura de código\n\nUm agente habilitado para IA pode analisar seu repositório e gerar um fluxo de trabalho de cobertura de código de trabalho, para que você possa começar a acompanhar a cobertura de teste sem criar manualmente a configuração de CI.\n\nQuando você usa a configuração automática para cobertura de código, um agente alimentado por IA analisa seu repositório, identifica sua estrutura de teste e abre uma solicitação de pull com um fluxo de trabalho de cobertura pronto para revisão.\n\n**Não há custo adicional para usar esse recurso.**\n\n## Como o agente funciona\n\nO agente funciona em três fases:\n\n1. **Descoberta:** O agente lê a configuração de CI, a documentação e os arquivos de build para entender a estrutura do projeto e identificar sua estrutura de teste.\n2. **Execução:** O agente instala dependências, cria o projeto e executa seus testes com a cobertura habilitada. Se as ferramentas de cobertura ainda não estiverem configuradas, o agente a adicionará à configuração do projeto (por exemplo, `vitest.config.ts` ou `jest.config.js`).\n3. **Integração de fluxo de trabalho:** Se o agente produzir um relatório de cobertura válido, ele verificará se o repositório já tem um GitHub Actions fluxo de trabalho que executa testes em solicitações de pull. Nesse caso, o agente aumenta esse fluxo de trabalho com uma etapa de upload de cobertura. Caso contrário, ele cria um novo arquivo de fluxo de trabalho e abre uma solicitação de pull.\n\n## Quando o agente for interrompido\n\nO agente pode parar antes de abrir uma solicitação de pull nas seguintes situações:\n\n* **Nenhum teste encontrado.** O agente não conseguiu encontrar testes para instrumentar, portanto, não há nada para o qual gerar cobertura.\n* **Não é possível reproduzir o build.** Registros privados ausentes, SDKs proprietários ou dependências do sistema impedem que o agente verifique o conjunto de testes.\n\nSe o agente parar ou produzir resultados inesperados, você poderá examinar o log de sessão do agente para obter detalhes. Navegue até a guia **Tarefas** no repositório para localizar a sessão associada à tentativa de geração de fluxo de trabalho.\n\n* **Conversão de relatório de cobertura sem suporte.** O agente não reconstruirá Cobertura XML de relatórios que expõem somente contadores agregados. Por exemplo, o XML do JaCoCo não contém estrutura de linha e ramificação suficientes para um upload confiável da Cobertura, portanto, projetos JVM que produzem apenas JaCoCo XML podem precisar de configuração manual.\n\n## Resultados da solicitação de pull\n\n> \\[!NOTE]\n> O agente abre a solicitação de pull imediatamente com uma confirmação de planejamento inicial que não contém nenhuma alteração de código. A confirmação de implementação real normalmente chega alguns minutos depois. Se a solicitação de pull mostrar inicialmente 0 arquivos alterados, aguarde alguns minutos e atualize a página.\n\nSe o agente abrir com êxito uma solicitação de pull, a solicitação de pull poderá estar em um destes estados:\n\n* **as-ismesclável:** O fluxo de trabalho é concluído com êxito na CI e a cobertura é carregada corretamente.\n* **Pronto para iterar:** O fluxo de trabalho é executado, mas requer ajustes (por exemplo, segredos ausentes, configuração de executor auto-hospedado ou diferenças de caminho entre a verificação local e a CI).\n* **Útil como referência:** Os mantenedores podem preferir configurar a cobertura por conta própria, usando a solicitação de pull do agente como ponto de partida para os comandos de build e teste descobertos.\n\n## Leitura adicional\n\n* [Configurando a cobertura de código para seu repositório](/pt/code-security/how-tos/maintain-quality-code/set-up-code-coverage#automatic-setup)\n* [Qualidade do Código do GitHub](/pt/code-security/concepts/code-quality/code-quality)"}