Como Usar o GitHub Copilot no VS Code com Polyglot Notebooks

Polyglot Notebooks no VS Code permitem escrever código em várias linguagens dentro de um único arquivo. Você pode misturar Python, JavaScript, SQL e outras em células separadas. O GitHub Copilot fornece sugestões de código enquanto você digita em cada célula. Este artigo explica como configurar o Copilot para Polyglot Notebooks e escrever código multilíngue de forma eficiente.

O que são Polyglot Notebooks e como o Copilot funciona com eles

Polyglot Notebooks, anteriormente conhecidos como .NET Interactive Notebooks, são uma extensão do VS Code que permite criar um único arquivo de notebook com células que executam diferentes linguagens de programação. Cada célula pode ser configurada para uma linguagem específica, como Python, JavaScript, C#, SQL ou PowerShell. O notebook usa um espaço de variáveis compartilhado, permitindo que dados passem entre células escritas em linguagens diferentes.

O GitHub Copilot é uma ferramenta de conclusão de código com IA que sugere código com base no contexto do arquivo que você está editando. Em um arquivo de código padrão, o Copilot detecta a linguagem pela extensão do arquivo. Em um Polyglot Notebook, o Copilot lê os metadados de linguagem associados a cada célula. Quando você define uma célula como Python, o Copilot gera sugestões em Python. Quando você muda a célula para SQL, o Copilot alterna automaticamente para conclusões SQL.

Para usar o Copilot de forma eficaz em Polyglot Notebooks, você precisa ter tanto a extensão Polyglot Notebooks quanto a extensão GitHub Copilot instaladas no VS Code. Você também precisa de uma assinatura ativa do GitHub Copilot, que pode ser o nível gratuito com conclusões limitadas ou um plano pago. O Copilot não requer configuração especial para Polyglot Notebooks além da configuração padrão.

Como o Copilot determina a linguagem em uma célula Polyglot

O Copilot verifica o especificador de linguagem nos metadados da célula. Quando você cria uma nova célula em um Polyglot Notebook, um menu suspenso no topo da célula mostra a linguagem atual. O Copilot lê esse valor e o usa para selecionar o modelo de linguagem apropriado. Se você não definir a linguagem corretamente, o Copilot pode produzir sugestões para a linguagem errada. Por exemplo, se a célula estiver configurada como JavaScript mas você escrever código Python, o Copilot sugerirá conclusões em JavaScript.

Passos para configurar o GitHub Copilot no VS Code para Polyglot Notebooks

Siga estes passos para habilitar o GitHub Copilot em Polyglot Notebooks. O processo assume que você já tem o VS Code instalado.

1. Instale a extensão Polyglot Notebooks
   Abra o VS Code e vá para a visualização de Extensões pressionando Ctrl+Shift+X. Pesquise por “Polyglot Notebooks” e instale a extensão publicada pela Microsoft. Essa extensão adiciona suporte para arquivos .ipynb com múltiplos kernels de linguagem.
2. Instale a extensão GitHub Copilot
   Na visualização de Extensões, pesquise por “GitHub Copilot” e instale a extensão. Após a instalação, você verá um ícone do Copilot na barra de status na parte inferior do VS Code.
3. Faça login no GitHub Copilot
   Clique no ícone do Copilot na barra de status e selecione “Fazer login no GitHub Copilot”. Uma janela do navegador será aberta pedindo para autorizar o VS Code. Complete o processo de login. Sua conta do GitHub deve ter uma assinatura ativa do Copilot.
4. Crie um novo Polyglot Notebook
   Pressione Ctrl+Shift+P para abrir a Paleta de Comandos. Digite “Polyglot Notebook: Criar Novo Notebook” e selecione. Um novo notebook será aberto com uma célula vazia. Alternativamente, crie um novo arquivo com a extensão .ipynb e o VS Code o abrirá como um notebook.
5. Defina a linguagem da primeira célula
   Clique no menu suspenso de linguagem no canto superior direito da célula. Selecione a linguagem que deseja usar, como Python. Você também pode digitar um comentário de linguagem no topo da célula, por exemplo #!python, e o Copilot o detectará.
6. Comece a digitar código e aceite as sugestões do Copilot
   Na célula, comece a digitar código na linguagem selecionada. O Copilot mostrará uma sugestão em texto fantasma. Pressione Tab para aceitar a sugestão. Pressione Esc para descartá-la. Continue digitando para obter novas sugestões.
7. Adicione mais células com linguagens diferentes
   Clique no botão + Código no topo do notebook para adicionar uma nova célula. Defina sua linguagem para um valor diferente, por exemplo SQL. Digite código SQL na nova célula. O Copilot alterna automaticamente para conclusões SQL.
8. Execute células e passe dados entre linguagens
   Clique no botão Executar em cada célula para executar o código. Variáveis definidas em uma célula são acessíveis em células posteriores se compartilharem o mesmo kernel. Por exemplo, uma variável Python pode ser lida por uma célula C# no mesmo notebook.

Se o Copilot parar de sugerir código em Polyglot Notebooks

Copilot não mostra sugestões em uma nova célula

Isso geralmente acontece quando a linguagem da célula não está definida. Verifique o menu suspenso de linguagem no topo da célula. Se mostrar “(não especificado)”, clique e selecione uma linguagem. O Copilot não fornecerá sugestões para uma linguagem não especificada. Depois de definir a linguagem, comece a digitar e o Copilot deve aparecer.

Copilot sugere código para a linguagem errada

Os metadados da célula podem estar incorretos. Verifique se o menu suspenso de linguagem mostra a linguagem que você pretende usar. Se vir JavaScript mas quer Python, altere o menu suspenso. Você também pode excluir a célula e recriá-la com a linguagem correta. O Copilot baseia suas sugestões nos metadados, não apenas no conteúdo do código.

Copilot está habilitado mas ainda não funciona

Verifique o status do Copilot na barra de status do VS Code. O ícone deve mostrar um círculo girando ou uma marca de seleção. Se mostrar um círculo riscado, o Copilot está desabilitado. Clique no ícone e selecione “Habilitar Conclusões”. Verifique também se você está logado na conta GitHub correta que possui uma assinatura ativa do Copilot. Se você usa uma conta GitHub corporativa ou escolar, a assinatura deve ser atribuída à sua conta pela sua organização.

Polyglot Notebooks vs Notebooks Padrão: Principais Diferenças para Usuários do Copilot

Item	Polyglot Notebooks	Jupyter Notebooks Padrão
Linguagens suportadas	Python, JavaScript, C#, SQL, PowerShell, F#, HTML, Mermaid e mais	Principalmente Python, com kernels opcionais para R, Julia e outros
Detecção de linguagem pelo Copilot	Usa o menu suspenso de metadados da célula ou comentário de linguagem	Usa o kernel selecionado para o notebook, geralmente uma linguagem por notebook
Compartilhamento de variáveis entre linguagens	Suportado via kernel .NET Interactive, variáveis passam entre células de diferentes linguagens	Não suportado; cada kernel executa em seu próprio processo
Precisão das sugestões do Copilot	Alta quando os metadados de linguagem estão configurados corretamente	Alta, mas limitada à linguagem única do notebook

O Copilot em Polyglot Notebooks é mais útil quando você precisa combinar processamento de dados em Python com consultas a banco de dados em SQL e visualização em JavaScript. Notebooks padrão funcionam melhor para projetos de linguagem única onde não é necessário compartilhamento de variáveis entre linguagens.

Agora você pode criar Polyglot Notebooks no VS Code e usar o GitHub Copilot para gerar código em várias linguagens dentro do mesmo arquivo. Para obter os melhores resultados, sempre defina a linguagem da célula antes de começar a digitar. Você também pode usar o painel Copilot Chat para fazer perguntas sobre o código do seu notebook. Para cenários avançados, tente passar um DataFrame do Python para uma célula C# para processamento adicional e deixe o Copilot sugerir o código de conversão.