Você abre o Visual Studio Code para usar o Modo Agente do Copilot, mas o botão para alternar entre os modos não está visível. Isso geralmente acontece após uma atualização do VS Code, um conflito de extensões ou uma configuração incorreta. O botão do Modo Agente permite alternar entre chat inline, chat rápido e o painel completo do agente. Este artigo explica por que o botão desaparece e fornece as etapas exatas para restaurá-lo.
Principais conclusões: Corrigindo o botão do Modo Agente do Copilot que sumiu
- Configurações do VS Code > Extensões > Copilot > Modo de Chat: Controla quais modos de chat estão habilitados e visíveis na interface.
- Ctrl+Shift+P > Desenvolvedor: Recarregar Janela: Recarrega a janela do VS Code sem fechar o aplicativo, geralmente restaurando elementos de interface ausentes.
- Painel de Extensões > Desabilitar/Habilitar Copilot: Alternar a extensão do Copilot desliga e liga resolve conflitos com outras extensões.
Por que o botão do Modo Agente do Copilot desaparece
O botão do Modo Agente faz parte da interface de chat do Copilot no VS Code. Ele permite alternar entre chat inline, chat rápido e o painel completo do agente. Quando esse botão está ausente, geralmente uma de três causas raiz é responsável.
Conflitos de extensões
Extensões de terceiros que modificam a interface do chat ou a barra de status podem ocultar o botão do Modo Agente. Extensões como GitHub Copilot Chat, GitHub Copilot Labs ou extensões de tema personalizado que substituem o painel de chat podem entrar em conflito com a extensão principal do Copilot. Desabilitar essas extensões geralmente restaura o botão.
Substituição de configurações do VS Code
Uma configuração de usuário ou workspace pode ocultar o seletor de modo de chat. A configuração github.copilot.chat.modeSelector controla se o botão de modo aparece. Se estiver definida como hidden, o botão não será exibido. Essa configuração pode ser alterada na interface de configurações do VS Code ou no arquivo settings.json.
Extensão do Copilot desatualizada
Uma versão desatualizada da extensão GitHub Copilot pode não ter o recurso Modo Agente. A Microsoft atualiza regularmente o Copilot com novas funcionalidades. Se sua extensão não for atualizada automaticamente, o botão de modo pode não aparecer. A correção é atualizar a extensão manualmente.
Etapas para restaurar o botão do Modo Agente do Copilot
Siga estas etapas em ordem. Cada etapa aborda uma causa raiz diferente. Teste após cada etapa para ver se o botão retorna.
- Recarregar a janela do VS Code
Pressione Ctrl+Shift+P para abrir a paleta de comandos. Digite Desenvolvedor: Recarregar Janela e pressione Enter. Isso recarrega a janela do VS Code sem fechar o aplicativo. Restaura o estado da interface e geralmente corrige falhas temporárias que ocultam o botão do Modo Agente. - Verificar a configuração do modo de chat
Abra as configurações do VS Code pressionando Ctrl+,. Na barra de pesquisa, digite seletor de modo de chat. Procure pela configuração GitHub Copilot: Seletor de Modo de Chat. Se estiver definida como oculto, altere para visível. Se a configuração não estiver presente, adicione-a manualmente nosettings.jsondefinindo"github.copilot.chat.modeSelector": "visible". - Desabilitar extensões conflitantes
Abra o painel de Extensões clicando no ícone de Extensões na barra lateral esquerda ou pressionando Ctrl+Shift+X. Procure por extensões que modifiquem a interface do chat, como GitHub Copilot Chat, GitHub Copilot Labs ou extensões de tema personalizado. Desabilite-as uma a uma clicando no ícone de engrenagem e selecionando Desabilitar. Após desabilitar cada uma, recarregue a janela e verifique o botão do Modo Agente. - Atualizar a extensão GitHub Copilot
No painel de Extensões, pesquise por GitHub Copilot. Se uma atualização estiver disponível, você verá um botão Atualizar. Clique nele para atualizar a extensão. Após a atualização, recarregue a janela. Se não houver atualização disponível, desinstale a extensão e reinstale-a do marketplace do VS Code. - Reinstalar a extensão GitHub Copilot
Se nenhuma das etapas acima funcionar, desinstale completamente a extensão GitHub Copilot. No painel de Extensões, clique com o botão direito em GitHub Copilot e selecione Desinstalar. Em seguida, reinicie o VS Code. Após reiniciar, vá ao painel de Extensões, pesquise por GitHub Copilot e instale novamente. Esse processo limpa quaisquer dados corrompidos da extensão.
Se o botão do Modo Agente ainda não aparecer
Mesmo após seguir as etapas principais, alguns usuários ainda não veem o botão. Os problemas a seguir são menos comuns, mas podem causar o mesmo sintoma.
Botão do Modo Agente do Copilot sumiu após uma atualização do VS Code
Uma atualização do VS Code pode alterar as configurações padrão das extensões. Após uma atualização, verifique novamente a configuração GitHub Copilot: Seletor de Modo de Chat. Ela pode ter sido redefinida para oculto. Além disso, verifique se a atualização introduziu uma nova extensão que conflita com o Copilot. Desabilite quaisquer extensões recém-instaladas que modifiquem o painel de chat.
Botão do Modo Agente do Copilot sumiu em contextos remotos ou de workspace
Se você usa o VS Code com uma conexão remota como SSH, WSL ou um contêiner de desenvolvimento, a extensão do Copilot pode se comportar de forma diferente. Nesses contextos, o botão do Modo Agente pode estar oculto por padrão. Verifique as configurações remotas abrindo a paleta de comandos com Ctrl+Shift+P e digitando Preferências: Abrir Configurações Remotas. Pesquise por seletor de modo de chat e defina como visível. Além disso, certifique-se de que a extensão Copilot esteja instalada na máquina remota.
Botão do Modo Agente do Copilot sumiu ao usar um tema personalizado
Alguns temas personalizados substituem a interface do chat e podem ocultar o botão de modo. Mude temporariamente para o tema padrão do VS Code abrindo a paleta de comandos com Ctrl+Shift+P, digitando Preferências: Tema de Cores e selecionando Dark+ (padrão escuro) ou Light+ (padrão claro). Se o botão aparecer, o tema é a causa. Entre em contato com o autor do tema para uma correção.
Modo Agente do Copilot no VS Code vs Chat Inline: Principais diferenças
| Item | Modo Agente | Chat Inline |
|---|---|---|
| Descrição | Um painel dedicado para conversas de múltiplas interações com o Copilot | Uma caixa de chat de interação única que aparece dentro do editor |
| Localização na interface | Barra lateral ou aba separada na área do painel | Embutido no editor de código |
| Caso de uso | Geração de código complexo, depuração e refatoração | Completamento rápido de código e perguntas simples |
| Visibilidade do botão | Controlada pela configuração github.copilot.chat.modeSelector |
Sempre visível quando o Copilot está habilitado |
| Melhor para | Desenvolvedores que precisam de conversas com contexto | Desenvolvedores que desejam assistência rápida e inline |
O botão do Modo Agente é a porta de entrada para a experiência completa de chat do Copilot. Sem ele, você fica limitado a sugestões inline. Restaurar o botão dá acesso a conversas de múltiplas interações, explicação de código e assistência avançada de depuração.
Após restaurar o botão, experimente o Modo Agente clicando nele e pedindo ao Copilot para explicar uma função no seu código. Isso confirmará que o modo está funcionando corretamente. Para usuários avançados, você pode personalizar o seletor de modo de chat para mostrar apenas os modos que usa com frequência editando a configuração github.copilot.chat.modes no settings.json.