{"meta":{"title":"Usando GitHub Copilot agente de nuvem para melhorar um projeto","intro":"Encontre e corrija problemas em um projeto com Copilot cloud agent.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/tutorials","title":"Tutoriais"},{"href":"/pt/copilot/tutorials/cloud-agent","title":"Agente de nuvem"},{"href":"/pt/copilot/tutorials/cloud-agent/improve-a-project","title":"Melhorar um projeto"}],"documentType":"article"},"body":"# Usando GitHub Copilot agente de nuvem para melhorar um projeto\n\nEncontre e corrija problemas em um projeto com Copilot cloud agent.\n\n> \\[!NOTE]\n> Para obter uma introdução, consulte Copilot cloud agent[Sobre o agente de nuvem do GitHub Copilot](/pt/copilot/concepts/agents/cloud-agent/about-cloud-agent).\n\n## Introdução\n\nO desenvolvimento moderno geralmente começa com boas intenções: um script rápido, um protótipo, talvez uma ação para automatizar uma pequena coisa. Mas à medida que os projetos evoluem, esses primeiros esforços podem se tornar frágeis.\n\nEste tutorial mostra como você pode usar Copilot cloud agent para melhorar um projeto maduro, sem diminuir o ritmo.\n\nNas seções a seguir, vamos:\n\n* Verifique se o projeto contém instruções personalizadas que Copilot podem ser usadas para adaptar suas respostas ao seu projeto.\n* Verifique se há um arquivo de configuração de ambiente para Copilot cloud agent para que ele possa iniciar as tarefas mais rapidamente ao pré-instalar as dependências do projeto.\n* Solicite que Copilot procure melhorias que possam ser feitas no código e crie tarefas para esse trabalho.\n* Delegar o trabalho de codificação para Copilot ao atribuí-lo a uma tarefa.\n\n## 1. Verifique se há instruções personalizadas\n\n1. Vá para o repositório em GitHub.\n\n2. Verifique se existe pelo menos um dos seguintes arquivos de instruções personalizadas:\n\n * `.github/copilot-instructions.md`\n * `.github/instructions/**/*-instructions.md`\n * `AGENTS.md`\n\n3. Se houver algum desses arquivos, exiba o arquivo e verifique se as instruções são adequadas e atualizadas.\n\n Para obter mais informações, consulte a seção \"Escrevendo instruções personalizadas efetivas\" em [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization?tool=webui#writing-effective-custom-instructions) e a biblioteca de exemplos em [Instruções personalizadas](/pt/copilot/tutorials/customization-library/custom-instructions).\n\n4. Se não houver arquivos de instruções personalizados no repositório, use Copilot cloud agent para criar um `.github/copilot-instructions.md` arquivo seguindo as instruções em [Adicionando instruções personalizadas do repositório para GitHub Copilot](/pt/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions#asking-copilot-cloud-agent-to-generate-a-copilot-instructionsmd-file).\n\n5. Examine a solicitação de pull que Copilot cloud agent cria. Verifique se o `.github/copilot-instructions.md` arquivo fornece Copilot todas as informações que precisa saber para trabalhar neste projeto.\n\n O arquivo deve incluir:\n\n * Um resumo claro da base de código e o que o software faz.\n * Uma visão geral da estrutura do projeto.\n * Diretrizes de contribuição. Por exemplo, como criar, formatar, lintar e testar a base de código e os requisitos que devem ser atendidos antes que as solicitações de pull possam ser mescladas.\n * Principais princípios técnicos.\n\n6. Edite o arquivo conforme necessário.\n\n7. Clique **em Pronto para revisão** na parte inferior da guia \"Conversa\" da solicitação de pull e conclua seu processo habitual para mesclar uma solicitação de pull.\n\n## 2. Verifique se há um arquivo de configuração de ambiente\n\nUm `copilot-setup-steps.yml`GitHub Actions arquivo de fluxo de trabalho pode ajudar Copilot cloud agent a começar as tarefas mais rapidamente instalando previamente as dependências usadas pelo projeto.\n\nCriar esse arquivo é opcional, mas é uma boa ideia se você usar Copilot cloud agent regularmente no repositório.\n\n1. Em seu repositório, GitHubverifique se o seguinte arquivo existe:\n\n ```text copy\n .github/workflows/copilot-setup-steps.yml\n ```\n\n > \\[!TIP]\n > Uma maneira rápida de fazer isso é copiar o caminho acima, ir para a página principal do seu repositório e colar o caminho no campo \"Ir para o arquivo\".\n\n2. Se o arquivo existir, abra-o e verifique se as etapas no fluxo de trabalho instalam as dependências corretas para o projeto. Depois de verificar isso, você pode ignorar as etapas restantes nesta seção.\n\n3. Se você ainda não tiver um arquivo `copilot-setup-steps.yml`, use as etapas a seguir para que Copilot cloud agent o crie para você.\n\n4. No topo de qualquer página do seu repositório no site do GitHub, clique em ****.\n\n5. Copie e cole o seguinte prompt na caixa de diálogo Agentes:\n\n \n\n ```text copy\n Analyze this repository to understand the dependencies that need to be installed on the development environment to work on the code in this repository. Using this information, and the details about the `copilot-setup-steps.yml` file that are given in https://docs.github.com/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment, add a `.github/workflows/copilot-setup-steps.yml` to this repository. This Actions workflow file should install, in the development environment for Copilot cloud agent, all of the dependencies necessary to work on the code in this repository. Make sure that the workflow job is named `copilot-setup-steps`.\n ```\n\n \n\n6. Clique **** ou pressione Enter.\n\n7. Na lista \"Sessões de agente recentes\", clique na nova sessão do agente iniciada.\n\n Isso exibe um log de atividades enquanto Copilot trabalha na tarefa. Quando Copilot terminar, ele gerará um resumo do que fez.\n\n8. Leia o resumo e clique em ** Exibir solicitação de pull**.\n\n9. Opcionalmente, adicione Copilot como revisor. Para obter mais informações, consulte [Usando o GitHub Copilot para revisão de código](/pt/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review?tool=webui). Aguarde para Copilot adicionar comentários de revisão e faça as alterações que você achar necessárias em resposta aos comentários.\n\n10. Examine a solicitação de pull por conta própria, certificando-se de que as etapas de instalação no novo `copilot-setup-steps.yml` arquivo estejam corretas.\n\n O arquivo de fluxo de trabalho criado Copilot deve incluir um `on: workflow_dispatch` gatilho, para permitir que você execute o fluxo de trabalho manualmente e o trabalho deve ser nomeado `copilot-setup-steps` conforme mostrado neste extrato:\n\n ```yaml\n on:\n workflow_dispatch:\n push:\n paths:\n - .github/workflows/copilot-setup-steps.yml\n pull_request:\n paths:\n - .github/workflows/copilot-setup-steps.yml\n\n jobs:\n copilot-setup-steps:\n runs-on: ubuntu-latest\n ```\n\n11. Faça as alterações necessárias no `copilot-setup-steps.yml` arquivo na solicitação de pull.\n\n Você pode solicitar que Copilot faça alterações para você usando `@copilot` em um comentário de revisão. Por exemplo:\n\n `@copilot - comment the file more thoroughly`\n\n12. Clique **em Pronto para revisão** na parte inferior da guia \"Conversa\" da solicitação de pull e conclua seu processo habitual para mesclar uma solicitação de pull.\n\n13. Abra o arquivo recém-adicionado `.github/workflows/copilot-setup-steps.yml` em seu repositório no GitHub.\n\n14. Clique em **Exibir Execuções** no canto superior direito da página.\n\n15. Clique em **Executar fluxo de trabalho** e, em seguida, **execute o fluxo de trabalho** na caixa de diálogo para testar o novo fluxo de trabalho.\n\n16. Verifique se o fluxo de trabalho é executado corretamente e instala as dependências. Corrija as falhas editando o arquivo `.github/workflows/copilot-setup-steps.yml`.\n\n## 3. Deixe o Copilot encontrar dívida técnica.\n\nAgora que o Copilot tem o contexto adequado e (opcionalmente) um ambiente pronto para uso, você pode utilizá-lo para identificar e priorizar a dívida técnica no seu repositório.\n\n1. Clique no botão **** na caixa de prompt a seguir para enviar esse prompt para Copilot Chat no GitHub.com.\n\n ```copilot copy prompt\n What technical debt exists in this project? Give me a prioritized list of up to 5 areas we need to focus on. For each, describe the problem and its consequences.\n ```\n\n2. Verifique se o ** modo Perguntar** está selecionado.\n\n3. Use o menu suspenso ** Todos os repositórios** para selecionar o seu repositório.\n\n4. Clique **** ou pressione Enter.\n\n5. Revise os detalhes na resposta de Copilot.\n\n6. Supondo que Copilot tenha identificado pelo menos uma área para melhoria, copie o seguinte prompt para a mesma conversa:\n\n ```copilot copy\n /create-issue\n\n Create a GitHub issue to address the first of the problem areas that you identified.\n\n If the problem area requires substantial work, create one main issue for the entire problem area and then sub-issues that allow the work to be split up into manageable chunks, which will be tackled in separate pull requests that can be easily reviewed. For a large body of work, do not create a single issue that attempts to address the entire problem.\n\n The issue, or each sub-issue if these are created, must include a description of the problem, a set of acceptance criteria, and pointers on what files need to be added/updated.\n ```\n\n7. Edite esse prompt conforme necessário. Por exemplo, dependendo da resposta que Copilot produziu, talvez você queira trabalhar em outra das áreas problemáticas identificadas Copilot , em vez da primeira.\n\n8. Verifique se o modo Perguntar ainda está selecionado (****).\n\n9. Clique **** ou pressione Enter.\n\n10. Revise o rascunho do issue que o Copilot gera, editando-o conforme necessário.\n\n11. Se o Copilot criar um único issue de rascunho indicando que sub-issues devem ser criados, solicite ao Copilot que faça isso para você:\n\n ```copilot copy\n Go ahead and create sub-issues that chunk this work into manageable pieces.\n ```\n\n12. Clique em **Criar** ou **Revisar e Criar**, dependendo de quantos itens foram redigidos.\n\nCopilot cria um ou mais issues em seu nome. Você será mostrado como o autor do problema.\n\n## 4. Obtenha Copilot para corrigir um problema\n\nAgora que você criou issues, o próximo passo é delegar um issue ao Copilot e revisar o pull request resultante.\n\n1. Abra um dos issues que o Copilot criou para você na seção anterior.\n\n2. Verifique se o problema contém critérios de aceitação que Copilot pode usar para verificar se a tarefa foi concluída.\n\n3. Faça as alterações que você achar necessárias para descrever com precisão o problema que precisa ser corrigido e o resultado esperado do trabalho sobre esse problema.\n\n4. Clique em ** Atribuir ao Copilot**.\n\n5. Em \"Atribuir o Copilot ao problema\", clique em **Atribuir**.\n\nCopilot começará a trabalhar no problema. Após alguns instantes, um link para uma pull request de rascunho será adicionado ao problema.\n\n1. Clique no link da pull request do rascunho.\n\n Depois de Copilot terminar de trabalhar na solicitação de pull, ele removerá \"\\[WIP]\" do título da solicitação de pull e adicionará você como revisor.\n\n Você pode deixar o Copilot trabalhar no pull request de maneira assíncrona e voltar para revisá-lo quando você for adicionado como revisor.\n\n2. Opcionalmente, depois que Copilot estiver trabalhando por alguns minutos, você pode clicar em **Exibir sessão** na solicitação de pull para ver um log do que Copilot está fazendo.\n\n3. Opcionalmente, na guia \"Conversa\" da solicitação de pull, adicione Copilot como revisor.\n\n4. Depois de ser adicionado como revisor, examine as alterações por conta própria e faça as alterações necessárias.\n\n Você pode solicitar que Copilot faça alterações para você usando `@copilot` em um comentário de revisão.\n\n5. Clique **em Pronto para revisão** na parte inferior da guia \"Conversa\" da solicitação de pull e conclua seu processo habitual para mesclar uma solicitação de pull.\n\n## 5. Iterar o processo\n\n1. Se Copilot tiver criado vários problemas, repita a seção 4, atribuindo Copilot a um dos outros problemas.\n2. Depois de fechar todos os problemas criados por Copilot, repita a seção 3, escolhendo outra área problemática e repetindo o passo na seção 4 para atribuir problemas a Copilot, examinando e mesclando suas alterações.\n\n## Conclusion\n\nCopilot cloud agent pode ajudá-lo a melhorar a qualidade do código em qualquer projeto, mas é particularmente útil para reduzir a dívida técnica em um projeto que cresceu organicamente ao longo de muitos meses ou anos. Ao usar Copilot cloud agent, você pode fazer melhorias para as quais talvez tenha lutado para encontrar tempo sem que um assistente de IA trabalhe em seu nome.\n\nCopilot não o substitui como desenvolvedor , você ainda precisa estar envolvido em cada etapa desse processo, especificando o que deseja Copilot fazer e examinando cuidadosamente o código que ele altera ou adiciona, mas permite implementar melhorias ao mesmo tempo que você trabalha em outras tarefas importantes.\n\n## Próximas Etapas \n\nLeia este estudo de caso no blog do GitHub: [Como a equipe de cobrança do GitHub usa o cloud agent no GitHub Copilot para reduzir continuamente a dívida técnica](https://github.blog/ai-and-ml/github-copilot/how-the-github-billing-team-uses-the-coding-agent-in-github-copilot-to-continuously-burn-down-technical-debt/)."}