# Configuração automática de cobertura de código

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.

Quando 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ão há custo adicional para usar esse recurso.**

## Como o agente funciona

O agente funciona em três fases:

1. **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.
2. **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`).
3. **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.

## Quando o agente for interrompido

O agente pode parar antes de abrir uma solicitação de pull nas seguintes situações:

* **Nenhum teste encontrado.** O agente não conseguiu encontrar testes para instrumentar, portanto, não há nada para o qual gerar cobertura.
* **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.

Se 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.

* **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.

## Resultados da solicitação de pull

> \[!NOTE]
> 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.

Se o agente abrir com êxito uma solicitação de pull, a solicitação de pull poderá estar em um destes estados:

* **as-ismesclável:** O fluxo de trabalho é concluído com êxito na CI e a cobertura é carregada corretamente.
* **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).
* **Ú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.

## Leitura adicional

* [Configurando a cobertura de código para seu repositório](/pt/enterprise-cloud@latest/code-security/how-tos/maintain-quality-code/set-up-code-coverage#automatic-setup)
* [Qualidade do Código do GitHub](/pt/enterprise-cloud@latest/code-security/concepts/code-quality/code-quality)