Skip to main content

Solução de problemas do agente de codificação GitHub Copilot

Saiba como resolver problemas que podem ocorrer quando você atribui tarefas ao Copilot.

Quem pode usar esse recurso?

O agente de codificação Copilot está disponível com os planos GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business e GitHub Copilot Enterprise. O agente está disponível em todos os repositórios armazenados no GitHub, exceto os repositórios pertencentes ao contas de usuário gerenciadas e em locais em que foi explicitamente desabilitado.
Sign up for Copilot

O Copilot não está disponível na lista "Assignees" no meu issue

Você só poderá atribuir problemas ao Copilot se tiver acesso ao Copilot através do plano GitHub Copilot Pro, plano GitHub Copilot Pro+, plano GitHub Copilot Business ou plano GitHub Copilot Enterprise.

Se você ainda não tem uma assinatura de um desses planos, clique neste botão para saber mais:

          <a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline">
          <span>Inscreva-se para o Copilot</span> <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link external icon" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg></a>

Se você tem o GitHub Copilot Pro, o GitHub Copilot Pro+, o GitHub Copilot Business ou o GitHub Copilot Enterprise, verifique se agente de codificação Copilot está habilitado e não foi desabilitado manualmente para o repositório:

Observação

Você pode verificar se o agente de codificação Copilot foi habilitado para você na página de recursos nas configurações do Copilot: github.com/settings/copilot/features.

Tenho uma conta do Enterprise Managed User e o Copilot não funcionará no meu repositório pessoal

O agente de codificação Copilot não está disponível em repositórios pessoais pertencentes a contas de usuário gerenciadas. Isso ocorre porque agente de codificação Copilot é executado em GitHub-hosted runners, que não estão disponíveis para repositórios pessoais pertencentes a contas de usuário gerenciadas. Para saber mais, confira Executores hospedados no GitHub.

Se você tem um conta de usuário gerenciada e tentar atribuir o Copilot a um problema em um repositório pessoal, poderá ver uma mensagem de erro informando que o GitHub Actions não está disponível em seu repositório.

Para usar o agente de codificação Copilot, você precisará trabalhar com repositórios pertencentes à sua organização em vez de repositórios pessoais.

Copilot não pode criar uma pull request do Chat Copilot

Se você pediu ao Copilot para criar uma pull request e ele respondeu que não pode criar uma pull request diretamente, verifique se o agente de codificação Copilot está disponível.

Importante

Em IDEs do VS Code, Visual Studio e do JetBrains, você deve mencionar o participante do chat @github em seu prompt. Você pode omitir isso no Chat Copilot no GitHub.com.

Atribuí um issue ao Copilot, mas não está acontecendo nada

Aguarde um pouco e atualize a página. Você deverá ver o Copilot deixar uma reação 👀 no issue. Logo depois disso, o Copilot abrirá uma pull request de rascunho vinculada ao issue, que será mostrada na linha do tempo do issue.

O Copilot abriu uma pull request, mas nada está acontecendo

Se houver um evento "Copilot started work" na linha do tempo da pull request, clique em View session para ver os logs da sessão. Eles serão transmitidos ao vivo e você poderá ver o que o Copilot está fazendo.

O Copilot não responde aos comentários da minha pull request

O Copilot responde apenas aos comentários de pessoas que têm acesso para gravação ao repositório.

Se você tiver acesso de gravação e mencionar @copilot em um pull request atribuído a Copilot, o comentário será passado para agente de codificação Copilot. Um emoji de olhos (👀) é adicionado ao seu comentário para indicar que o agente de codificação Copilot viu seu comentário. Logo depois, um evento "Copilot started work" é adicionado à linha do tempo da pull request.

Se isso não acontecer, Copilot pode ter sido removido da solicitação de pull ou talvez você não tenha acesso de escrita. Observe que Copilot responde apenas a menções em pull requests abertos. Depois que uma pull request for mesclada ou fechada, agente de codificação Copilot não responderá a novas menções ou comentários para se concentrar melhor no trabalho de desenvolvimento ativo.

Com base nos logs de sessão do agente, o Copilot parece estar travado

O Copilot pode parecer ficar travado por algum tempo e, em seguida, começar funcionar novamente.

Se a sessão permanecer travada, ela atingirá o tempo limite após uma hora. Você pode tentar novamente cancelando a atribuição do issue e reatribuindo-o ao Copilot.

Se o Copilot ficou travado ao responder a um comentário, tente adicionar o mesmo comentário à pull request novamente.

Meus fluxos de trabalho do GitHub Actions não são executados quando o Copilot efetua push

Os fluxos de trabalho do GitHub Actions não são executados automaticamente quando o Copilot efetua push das alterações para uma pull request.

Para permitir que os fluxos de trabalho do GitHub Actions sejam executados, clique no botão Approve and run workflows na caixa de mesclagem da pull request. Consulte Revisar uma solicitação de pull criada por GitHub Copilot.

O Copilot está efetuando push de alterações que não passam nas minhas verificações de CI

Ao trabalhar em um problema, Copilot tem acesso ao seu próprio ambiente de desenvolvimento efêmero, alimentado por GitHub Actions, onde pode executar testes automatizados e linters para validar seu trabalho antes de enviá-lo.

É mais provável fazer isso se forem dadas instruções claras sobre o que fazer. ** A melhor maneira de fazer isso é com um arquivo .github/copilot-instructions.md. Confira Práticas recomendadas para usar GitHub Copilot para trabalhar em tarefas.

Há um aviso do GitHub Copilot sobre o firewall

Por padrão, o acesso do Copilot à Internet é limitado por um firewall.

Limitar acesso à Internet ajuda a gerenciar riscos de exfiltração de dados, em que um comportamento inesperado de Copilot ou instruções mal-intencionadas fornecidas a ele podem levar ao vazamento de o código ou outras informações confidenciais para locais remotos.

Se o Copilot tentar fazer uma solicitação bloqueada pelo firewall, um aviso será adicionado ao corpo da pull request (se o Copilot estiver respondendo a uma atribuição de issue) ou a um comentário (se o Copilot estiver respondendo a um comentário). O aviso mostra o endereço bloqueado e o comando que tentou fazer a solicitação.

Captura de tela de um aviso do Copilot sobre o bloqueio pelo firewall.

Para saber mais, confira Personalizando ou desabilitando o firewall para o agente de codificação do GitHub Copilot.

O Copilot não está selecionando capturas de tela anexadas

O tamanho máximo de imagem permitido por agente de codificação Copilot é de 3,00 MiB. Imagens maiores do que essa serão removidas da solicitação.

Leitura adicional

  •         [AUTOTITLE](/copilot/tutorials/coding-agent/best-practices)
    
  •         [AUTOTITLE](/copilot/customizing-copilot/customizing-the-development-environment-for-copilot-coding-agent)