Escrever código Python em células do Jupyter Notebook no VS Code pode ser lento quando você precisa digitar cada função, loop ou transformação de dados manualmente. O GitHub Copilot sugere blocos de código inteiros, definições de funções e comentários inline enquanto você digita. Este artigo explica como habilitar o Copilot para Jupyter Notebooks, como acionar sugestões dentro das células e como aceitá-las ou rejeitá-las.
O Copilot se integra diretamente ao editor de notebooks do VS Code. Ele lê o contexto das células anteriores, nomes de variáveis e descrições em markdown para gerar código relevante. Você não precisa de um plugin ou extensão separada além da extensão padrão do GitHub Copilot para VS Code.
Este artigo aborda a configuração, os atalhos de teclado para sugestões inline e problemas comuns quando o Copilot não responde dentro de uma célula.
Principais pontos: Usando o GitHub Copilot em Jupyter Notebooks
- Extensão do VS Code > GitHub Copilot > Instalar: Necessária antes que o Copilot funcione em qualquer arquivo, incluindo células de notebook.
- Ctrl+Enter dentro de uma célula de código: Aciona o popup de sugestão inline quando o Copilot não mostra um texto fantasma.
- Tab ou Enter para aceitar uma sugestão: Tab insere a sugestão completa; Enter insere apenas a primeira linha da sugestão.
Como o Copilot Funciona Dentro de Células do Jupyter Notebook
O GitHub Copilot é uma ferramenta de conclusão de código que usa o modelo OpenAI Codex. Quando você instala a extensão GitHub Copilot no VS Code versão 1.68 ou posterior, o Copilot é ativado automaticamente para todos os tipos de arquivo suportados, incluindo arquivos Python, arquivos JavaScript e arquivos .ipynb do Jupyter Notebook.
Dentro de uma célula do Jupyter Notebook, o Copilot lê o contexto de três fontes:
- Células Markdown diretamente acima da célula de código atual.
- Código em células anteriores que já foram executadas.
- Comentários e nomes de variáveis digitados na célula atual.
O Copilot não vê dados de células que não foram executadas. Se você quiser que o Copilot considere a saída de uma célula anterior, você deve executar essa célula primeiro. O Copilot também ignora células que contêm erros de sintaxe.
Pré-requisitos
- VS Code 1.68 ou posterior.
- Extensão GitHub Copilot instalada do VS Code Marketplace.
- Uma assinatura ativa do GitHub Copilot (teste gratuito, Copilot Pro ou Copilot para Empresas).
- Extensão Python da Microsoft instalada para suporte ao kernel.
- Extensão Jupyter da Microsoft instalada para suporte a notebooks.
Passos para Usar o GitHub Copilot Dentro de uma Célula do Jupyter Notebook
Siga estes passos para começar a receber sugestões do Copilot em suas células de notebook.
- Abra um Jupyter Notebook no VS Code
Abra o VS Code e crie um novo arquivo com a extensão .ipynb. Alternativamente, abra um notebook existente no menu Arquivo. O VS Code exibe o editor de notebook com células de código e células markdown. - Selecione o kernel Python
Clique no seletor de kernel no canto superior direito do editor de notebook. Escolha um ambiente Python onde os pacotes necessários estão instalados. O Copilot usa o kernel apenas para execução, não para sugestões, mas um kernel em execução é necessário para ver a saída da célula. - Comece a digitar em uma célula de código
Clique dentro de uma célula de código vazia. Digite um comentário que descreva o que você deseja fazer. Por exemplo, digite# carregar o dataset iris e exibir as cinco primeiras linhas. Após digitar o comentário, pressione Enter para iniciar uma nova linha. O Copilot mostra uma sugestão de texto fantasma em cinza. - Aceite a sugestão completa
Pressione Tab para aceitar todo o texto fantasma. Pressione Enter para aceitar apenas a primeira linha da sugestão. Se você pressionar Enter e a sugestão continuar em várias linhas, pressione Tab novamente para aceitar a próxima parte. - Navegue por sugestões alternativas
Se o Copilot mostrar uma sugestão que você não deseja, pressione Ctrl+Enter para abrir o popup de sugestões. Use as setas do teclado para percorrer as alternativas. Pressione Tab para aceitar a alternativa destacada. - Rejeite uma sugestão
Pressione Escape para dispensar o texto fantasma. A célula retorna ao estado anterior. Você pode continuar digitando e o Copilot gerará uma nova sugestão após uma breve pausa.
Forçar uma Sugestão Quando o Copilot Não Está Respondendo
Às vezes, o Copilot não mostra um texto fantasma imediatamente. Isso acontece quando o contexto é muito curto ou ambíguo. Para forçar uma sugestão:
- Digite um comentário completo ou assinatura de função
Escreva um comentário que inclua o nome da biblioteca e a ação. Por exemplo,# usar pandas para agrupar pela coluna A e calcular a média da coluna B. - Abra o painel de sugestões do Copilot
Pressione Ctrl+Enter para abrir o painel de sugestões inline. O Copilot mostra até dez sugestões. Selecione uma com as setas e pressione Tab para inseri-la.
Problemas Comuns Quando o Copilot Não Funciona em Células de Notebook
O Copilot Não Mostra Sugestões em Nenhuma Célula
A extensão pode não estar ativada. Abra a visualização de Extensões no VS Code e verifique se o GitHub Copilot está instalado e habilitado. Procure o ícone do Copilot na barra de status na parte inferior da janela. Se o ícone mostrar um círculo com uma linha atravessada, clique no ícone e selecione Ativar. Você também deve entrar na sua conta do GitHub e autorizar a assinatura do Copilot.
O Copilot Apenas Sugere Linhas Únicas em Vez de Blocos Completos
Isso ocorre quando o Copilot tem contexto limitado. Escreva um comentário mais detalhado acima da célula de código. Inclua o nome da função, a biblioteca e a saída esperada. Por exemplo, em vez de # carregar dados, escreva # carregar o arquivo CSV da pasta de dados usando pandas e retornar um DataFrame.
O Copilot Sugere Código Que Não Executa
O Copilot gera código com base em padrões que aprendeu de repositórios públicos. O código sugerido pode usar uma função ou parâmetro que não existe no seu ambiente atual. Sempre revise a sugestão antes de aceitá-la. Se a sugestão estiver incorreta, pressione Escape e digite o código correto manualmente. O Copilot aprende com suas correções manuais ao longo do tempo.
O Copilot Não Funciona Após uma Atualização do VS Code
Uma atualização do VS Code pode desativar a extensão do Copilot. Reinicie o VS Code após uma atualização. Se o Copilot ainda não aparecer, vá em Extensões, procure por GitHub Copilot e clique no botão Recarregar. Talvez seja necessário entrar novamente se o token de autenticação expirou.
Sugestões do Copilot vs Copilot Chat em Notebooks: Principais Diferenças
| Item | Sugestões do Copilot | Copilot Chat |
|---|---|---|
| Acionamento | Digitar código ou comentários em uma célula | Ctrl+Shift+I ou o ícone de chat |
| Local da saída | Texto fantasma inline na célula atual | Painel de chat separado ou nova célula |
| Escopo do contexto | Células anteriores e conteúdo da célula atual | Notebook inteiro, código selecionado e histórico da conversa |
| Melhor para | Conclusões rápidas de padrões conhecidos | Explicar código, depurar ou gerar novas funções |
Use os dois recursos juntos. Deixe as Sugestões do Copilot lidarem com conclusões rotineiras, como imports e loops. Use o Copilot Chat para lógica complexa, explicações de erros ou quando precisar refatorar um grande bloco de código.
Agora você pode usar o GitHub Copilot dentro de células do Jupyter Notebook para acelerar seus fluxos de trabalho de análise de dados e aprendizado de máquina. Comece instalando a extensão GitHub Copilot, se ainda não o fez. Em seguida, abra um notebook e digite um comentário descritivo em uma célula de código para ver a primeira sugestão. Para melhores resultados, sempre execute as células anteriores para que o Copilot possa usar a saída delas como contexto. Se você trabalha com notebooks grandes, considere usar o Copilot Chat para gerar novas células a partir de descrições em linguagem natural, em vez de digitar cada linha manualmente.