Como Fixar o GitHub Copilot a um Modelo Específico nas Configurações do VS Code

Ao usar o GitHub Copilot no Visual Studio Code, o comportamento padrão permite que a extensão escolha qual modelo de IA lida com suas conclusões de código e respostas de chat. Isso pode levar a uma qualidade de saída inconsistente ou comportamento inesperado se o modelo mudar durante uma sessão. Ao fixar o Copilot a um modelo específico, você ganha desempenho previsível e evita surpresas de atualizações automáticas de modelo. Este artigo explica como localizar as configurações corretas do VS Code, configurar a seleção do modelo e verificar se o modelo fixado está ativo.

Por que Fixar um Modelo é Importante para o GitHub Copilot

O GitHub Copilot usa vários modelos de IA internamente. O modelo padrão pode mudar ao longo do tempo conforme a Microsoft lança atualizações ou novas versões. Quando você fixa um modelo específico, trava o Copilot naquele modelo até que você altere manualmente a configuração. Isso é útil para equipes que precisam de sugestões de código reproduzíveis ou para desenvolvedores que preferem o estilo de saída de um modelo específico.

Fixar também evita interrupções durante longas sessões de codificação. Se o modelo mudar no meio da sessão, o tom das sugestões pode mudar e os padrões de código gerados anteriormente podem não continuar de forma consistente. Ao fixar o modelo, você mantém uma experiência uniforme do início ao fim.

A configuração se aplica tanto às conclusões inline do Copilot quanto às respostas do Copilot Chat. No entanto, alguns recursos avançados, como instruções personalizadas ou modo agente, podem se comportar de forma diferente dependendo do modelo fixado. A próxima seção aborda os pré-requisitos e o escopo desta configuração.

Pré-requisitos para Fixar um Modelo

Antes de fixar um modelo, verifique se você atende a estes requisitos:

• Visual Studio Code versão 1.92 ou superior instalado.
• Extensão GitHub Copilot versão 1.194 ou superior instalada e ativada.
• Uma assinatura ativa do GitHub Copilot (Copilot Individual, Business ou Enterprise).
• Acesso de rede aos servidores do GitHub Copilot para validação da seleção do modelo.

Passos para Fixar o GitHub Copilot a um Modelo Específico

Siga estes passos para definir um modelo fixo para o GitHub Copilot no VS Code. Você pode usar a interface de configurações ou o arquivo settings.json. Ambos os métodos alcançam o mesmo resultado.

Método 1: Usando a Interface de Configurações do VS Code

1. Abra o editor de Configurações
   Pressione Ctrl + , para abrir a aba Configurações. Alternativamente, vá ao menu e selecione Arquivo > Preferências > Configurações.
2. Pesquise pela configuração do modelo do Copilot
   Na barra de pesquisa no topo da aba Configurações, digite modelo. Os resultados mostrarão todas as configurações que contêm essa palavra.
3. Localize o menu suspenso do modelo do GitHub Copilot
   Role até a seção Extensões > GitHub Copilot. Procure pela configuração chamada Github > Copilot > Avançado: Modelo. Este é um menu suspenso que lista os modelos disponíveis.
4. Selecione seu modelo preferido
   Clique no menu suspenso e escolha o modelo que deseja fixar. Opções comuns incluem gpt-4, gpt-4o ou claude-3.5-sonnet. A lista exata depende da sua assinatura do Copilot e região.
5. Salve a configuração
   A alteração é salva automaticamente ao selecionar um modelo. Nenhum botão adicional é necessário. Feche a aba Configurações para aplicar a mudança.

Método 2: Editando o settings.json Diretamente

1. Abra a Paleta de Comandos
   Pressione Ctrl + Shift + P para abrir a Paleta de Comandos. Digite Preferências: Abrir Configurações do Usuário (JSON) e selecione.
2. Localize ou crie a chave do modelo do Copilot
   No arquivo settings.json que abrir, encontre a linha "github.copilot.advanced". Se não existir, adicione-a no nível superior do objeto JSON.
3. Adicione o identificador do modelo
   Dentro do objeto github.copilot.advanced, adicione uma chave chamada "model" com o identificador do modelo como string. Por exemplo: "github.copilot.advanced": { "model": "gpt-4o" }. Salve o arquivo.
4. Verifique a sintaxe JSON
   O VS Code valida o arquivo JSON automaticamente. Se você vir linhas onduladas vermelhas, verifique se há vírgulas ou chaves faltando. Corrija quaisquer erros antes de fechar o arquivo.
5. Recarregue a janela
   Para garantir que a alteração entre em vigor, pressione Ctrl + Shift + P, digite Desenvolvedor: Recarregar Janela e pressione Enter. Isso reinicia o host da extensão com a nova configuração de modelo.

Problemas Comuns ao Fixar um Modelo do Copilot

O menu suspenso de modelo não mostra opções

Se o menu suspenso na interface de configurações estiver vazio, sua extensão do Copilot pode estar desatualizada. Atualize a extensão GitHub Copilot no painel de Extensões. Verifique também se você está conectado à sua conta do GitHub e se sua assinatura está ativa. Após a atualização, reinicie o VS Code e verifique o menu novamente.

O modelo fixado volta ao padrão após reiniciar

Isso geralmente acontece quando você tem uma configuração de nível de workspace que substitui a configuração do usuário. Abra o arquivo .vscode/settings.json na pasta do seu projeto e remova qualquer entrada github.copilot.advanced.model lá. A configuração do usuário então terá precedência. Alternativamente, defina o modelo nas configurações do workspace diretamente se quiser que se aplique apenas àquele projeto.

O Copilot ainda usa um modelo diferente do que fixei

Alguns recursos do Copilot, como modo agente ou instruções personalizadas, podem ignorar a configuração de modelo fixado. Verifique a barra de status do VS Code para o indicador de modelo ativo. Clique no ícone do Copilot na barra de status e selecione Informações do Modelo para ver qual modelo está em execução. Se for diferente da sua seleção fixada, desative quaisquer arquivos de instrução personalizada ou substituições de modo agente nas configurações do Copilot.

Fixar um modelo quebra as conclusões do Copilot Chat

Certos modelos são otimizados para conclusões de código, mas não para chat. Se você fixar um modelo que não suporta chat, o Copilot Chat pode falhar ao responder. Mude para um modelo que suporte ambos os modos, como gpt-4o ou claude-3.5-sonnet. Verifique as notas de versão do GitHub Copilot para a lista mais recente de modelos compatíveis.

Modelo Fixado vs Modelo Padrão: Principais Diferenças

Item	Modelo Fixado	Modelo Padrão
Método de seleção	Manual via interface de configurações ou settings.json	Automático pela extensão Copilot
Consistência entre sessões	Modelo fixo até ser alterado	Pode mudar com atualizações da extensão
Previsibilidade da saída	Alta para conclusões de código e chat	Variável dependendo da versão do modelo
Suporte a todos os recursos do Copilot	Depende das capacidades do modelo escolhido	Suporte completo garantido
Possibilidade de substituição por workspace	Sim, via settings.json do workspace	Não, sempre segue os padrões da extensão

Fixar dá a você controle, mas requer conhecimento de quais modelos suportam quais recursos. O modelo padrão é mais seguro para uso geral, mas menos previsível. Escolha com base na sua necessidade de consistência versus completeza de recursos.

Agora você pode fixar o GitHub Copilot a um modelo específico usando a interface de configurações do VS Code ou editando o settings.json diretamente. Após fixar, verifique o modelo ativo clicando no ícone do Copilot na barra de status e selecionando Informações do Modelo. Para equipes, considere adicionar a configuração de modelo fixado ao arquivo .vscode/settings.json do projeto para que todos os membros usem o mesmo modelo. Se depois quiser desafixar, basta definir o menu suspenso de modelo de volta ao padrão ou remover a chave do settings.json.