Skip to main content

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

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

Quem pode usar esse recurso?

O Agente de codificação do Copilot está disponível com os planos GitHub Copilot Pro+ e GitHub Copilot Enterprise nos repositórios em que está habilitado.
Sign up for Copilot

Observação

Agente de codificação do Copilot is in versão prévia pública and subject to change.

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

Você só pode atribuir issues ao Copilot se tem acesso ao Copilot por meio do plano GitHub Copilot Pro+ ou do plano GitHub Copilot Enterprise.

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

Se você tem o GitHub Copilot Pro+ ou o GitHub Copilot Enterprise, verifique se o Agente de codificação do Copilot está habilitado e foi disponibilizado para o repositório:

Observação

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

O Copilot não pode criar uma pull request no Copilot Chat

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 do 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 Copilot Chat 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

Copilot only responds to comments from people who have write access to the repository.

Se você tiver acesso para gravação e adicionar um comentário em uma pull request atribuída ao Copilot, o comentário será passado para o Agente de codificação do Copilot. Um emoji de olhos (👀) é adicionado ao seu comentário para indicar que o Agente de codificação do Copilot está considerando seu comentário. Se o agente trabalhar para fazer alterações em resposta ao comentário, um evento "Copilot started work" será adicionado à linha do tempo da pull request.

Se isso não acontecer, o Copilot poderá ter removido a atribuição da pull request, ou o Copilot poderá ter decidido que seu comentário não é acionável.

Verifique se o Copilot está atribuído à pull request. Se ele estiver, você poderá forçar o Copilot a responder ao seu comentário usando @mentioning Copilot no comentário com @copilot.

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. Confira Revisando uma pull request criada pelo Copilot.

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

Ao trabalhar em um issue, o Copilot tem acesso ao próprio ambiente de desenvolvimento efêmero, da plataforma GitHub Actions, em que pode executar testes automatizados e linters para validar seu trabalho antes de efetuar push dele.

É mais provável que ele faça isso se receber instruções claras sobre o que fazer. A melhor maneira de fazer isso é com um arquivo .github/copilot-instructions.md. Confira Best practices for using Copilot to work on tasks.

Há um aviso do GitHub Copilot sobre o firewall

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

Limitar o acesso à Internet ajuda a gerenciar riscos de exfiltração dos dados, em que um comportamento surpreendente do Copilot ou instruções mal-intencionadas fornecidas a ele pode fazer com que o código ou outras informações confidenciais sejam vazadas 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 Customizing or disabling the firewall for Copilot coding agent.

Leitura adicional