Como corrigir erros de código com o Copilot no Fabric

Um erro numa célula pode bloquear toda a tua análise e fazer-te perder tempo à procura da causa. No Microsoft Fabric, o Copilot ajuda-te a corrigir erros de código diretamente no Notebook: resume o que correu mal, explica a causa provável e sugere uma correção pronta a aplicar. A seguir tens o passo a passo para resolver um erro real de PySpark com o comando /fix.

Nota: as funcionalidades de Copilot nos Notebooks do Fabric estão em pré-visualização e evoluem com frequência. Os nomes de botões e comandos podem variar ligeiramente na tua versão.

Pré-requisitos

• Uma capacidade do Microsoft Fabric com o Copilot disponível (F2 ou superior, ou uma avaliação).
• O administrador do tenant precisa de ter ativado o switch do Copilot.
• Um Notebook do Fabric ligado a uma Lakehouse com, pelo menos, uma tabela Delta.
• Conhecimentos básicos de Python e PySpark.

Passo 1: Ativar o Copilot no Notebook

Abre o teu Notebook e, no friso, clica no botão Copilot. O Fabric acrescenta uma célula de inicialização no topo do Notebook — executa essa célula para carregar o Copilot. Assim que terminar, o painel de chat abre-se do lado direito.

O Copilot só funciona com uma sessão Spark ativa. Se ainda não executaste nada, corre primeiro uma célula simples para garantir que a sessão arranca e que os teus dados estão acessíveis:

df = spark.read.format("delta").load("Tables/vendas")
df.show(5)

Passo 2: Reproduzir um erro

Para veres o Copilot a funcionar, executa de propósito uma célula com um erro comum. Repara no método grouBy, escrito de forma incorreta:

df = spark.read.format("delta").load("Tables/vendas")
df.select("Regiao", "Total").grouBy("Regiao").sum("Total").show()

O Fabric mostra uma mensagem parecida com AttributeError: 'DataFrame' object has no attribute 'grouBy'. Antes de avançar, lê sempre a última linha do erro: costuma indicar exatamente o que falhou. Erros de escrita em nomes de métodos ou de colunas estão entre os mais frequentes em PySpark, por isso são um bom caso para testar o Copilot.

Passo 3: Pedir a correção com o comando /fix

Quando uma célula falha, o Fabric mostra a opção Fix with Copilot por baixo do resultado. Em alternativa, seleciona a célula com erro e escreve o comando /fix no painel do Copilot:

/fix

O Copilot lê a mensagem de erro e o código, apresenta um resumo da causa (o método grouBy não existe em PySpark) e propõe a versão corrigida. Podes usar o /fix para uma célula específica ou para o Notebook inteiro. O botão Fix with Copilot foca-se na célula que falhou; o comando /fix no painel dá-te mais contexto e permite continuar a conversa com perguntas de seguimento.

Passo 4: Rever e aplicar a correção

Lê sempre a sugestão antes de a aceitar — o Copilot pode enganar-se. Neste caso, propõe trocar grouBy por groupBy:

df = spark.read.format("delta").load("Tables/vendas")
df.select("Regiao", "Total").groupBy("Regiao").sum("Total").show()

Clica em Insert para colocar o código corrigido na célula (ou copia o bloco) e volta a executá-la. Se quiseres perceber melhor a causa em vez de só copiar a solução, usa o comando /explain na mesma célula: o Copilot explica, linha a linha, o que o código faz.

Verificar o resultado

A célula deixa de dar erro e passa a mostrar uma tabela com o total por região. Confirma que:

• Já não aparece nenhuma mensagem de erro a vermelho por baixo da célula.
• O resultado tem as colunas Regiao e sum(Total).
• Os valores somados fazem sentido para os teus dados.

Dica: corrige um erro de cada vez e volta a executar a célula depois de cada alteração — assim percebes qual foi a correção que resolveu o problema e evitas introduzir novos enganos.

Conclusão

Com o comando /fix do Copilot corrigiste um erro de PySpark sem sair do Notebook do Fabric. A partir daqui, experimenta o /explain para aprender com cada correção, o /comments para documentar o código e o /optimize para melhorar o desempenho. Qual foi o último erro que te fez perder demasiado tempo — e como poderia o Copilot ter ajudado?