Obter ajuda de codificação do Genie Code

Este artigo descreve como você pode usar o Genie Code para ajudá-lo a programar e depurar seus notebooks, e fornece dicas sobre como tirar o máximo proveito do Genie Code.

Com o que o Genie Code pode ajudar?

O Genie Code é um assistente de IA com reconhecimento de contexto com o qual você pode interagir usando uma interface de conversa, tornando-o mais produtivo dentro do Databricks. Você pode descrever sua tarefa em inglês e permitir que o Genie Code gere código Python ou consultas SQL, explique código complexo e corrija erros automaticamente. O Genie Code usa metadados do Catálogo do Unity para entender suas tabelas, colunas, descrições e ativos de dados populares em sua empresa para fornecer respostas personalizadas.

O Genie Code pode ajudá-lo com as seguintes tarefas:

• Gerar código.
• Depurar código, incluindo identificação de erros e sugestão de correções.
• Transformar, otimizar e refatorar código.
• Explicar o código.
• Ajudar você a encontrar informações relevantes na documentação do Azure Databricks.

Para obter informações sobre os modelos que alimentam o Genie Code, consulte os recursos de IA habilitados para parceiros. Para obter informações gerais sobre o Genie Code, consulte Genie Code.

Executar código no Genie Code na computação sem servidor

Você pode executar o código diretamente do painel lateral do Genie Code. O Genie Code usa a computação sem servidor por padrão, que é a computação padrão no Databricks.

Se você estiver em uma página que já tenha um recurso de cálculo selecionado (por exemplo, notebooks ou editor de SQL), o Genie Code usará automaticamente esse recurso de cálculo. Para obter informações sobre tipos de computação, consulte Computação.

Se você não tiver acesso à computação sem servidor, deverá ter uma instância de computação disponível para executar o código no painel Genie Code.

Atalhos de comando do Genie Code para notebooks

Em um notebook, o Genie Code está disponível no painel Genie Code ou embutido em uma célula de código.

Para usar o Genie Code diretamente em uma célula de código, pressione Cmd+I no MacOS ou Ctrl+I no Windows. Uma caixa de texto é exibida na célula. Você pode digitar uma pergunta ou comentário em inglês e pressionar Enter (não Shift+Enter, como você faria para executar uma célula) para que o Genie Code gere uma resposta.

Use comandos de barra para prompts

Comandos de barra são um atalho para criar prompts comuns.

Texto de prompt	O que o Genie Code faz
/	Exibe comandos comuns
/doc	Comenta o código em uma exibição de comparação
/explain	Fornece uma explicação do código em uma célula
/fix	Propõe uma correção para quaisquer erros de código em uma exibição de comparação
/findTables	Pesquisa tabelas relevantes com base nos metadados do Unity Catalog. Para localizar recursos ou tabelas de recursos, mencione “recursos” ou “tabelas de recursos” na consulta. Consulte Localizar recursos e tabelas de recursos usando o Genie Code.
/findQueries	Pesquisa consultas relevantes com base nos metadados do Unity Catalog.
/optimize	Aprimora o código SQL e Python.
/prettify	Formata o código para melhor legibilidade.
/rename	Sugere nomes atualizados para células de notebooks e outros elementos, dependendo do contexto.
/settings	Ajusta as configurações do notebook diretamente no Genie Code.

Quando você usa /fix ou /doc na janela de comparação, selecione Aceitar para aceitar as alterações propostas ou Rejeitar para manter o código original. Se você aceitar o código proposto, o código não será executado automaticamente. Você poderá revisar o código antes de executá-lo. Se o código gerado não for o que você queria, tente novamente adicionando mais detalhes ou informações ao seu comentário. Consulte Dicas para melhorar as respostas do Genie Code.

Obtenha explicações detalhadas sobre snippets de código. Use o prompt /explain e inclua termos como “ser conciso” ou “explicar o código linha por linha” para solicitar o nível de detalhe que você deseja. Você também pode pedir ao Genie Code para adicionar comentários ao código.

Para preenchimento automático de código, o desempenho pode ser melhor usando o painel Genie Code do que em uma célula do notebook.

O Genie Code será fechado automaticamente se você aceitar ou rejeitar o código gerado.

Tabelas de referência em prompts com o uso de @

Para fazer referência rápida a tabelas nos prompts do Genie Code, use o símbolo @.

Obter ajuda com o código

O Genie Code ajuda com o código, tanto o SQL quanto o Python:

• Modo de agente, que pode fazer correções e atualizações em várias células e arquivos de um único prompt. Consulte Usar o Genie Code para ciência de dados.
• Preenchimento automático baseado em IA em blocos de anotações do Databricks, no editor do SQL e no editor de arquivos.
• Filtragem de dados com prompts em linguagem natural.
• Depuração de código com Erro de diagnóstico.

Obter sugestões de código embutido: exemplos de Python e SQL

Conforme você digita, as sugestões são exibidas automaticamente. Pressione Tab para aceitar uma sugestão. Para disparar manualmente uma sugestão, pressione Option+Shift+Space (no macOS) ou Control+Shift+Space (no Windows).

O preenchimento automático baseado em IA também pode gerar código com base em comentários:

Filtrar dados com prompts de linguagem natural

Use o Genie Code para filtrar saídas de dados com prompts de linguagem natural.

Para filtrar saídas com linguagem natural, clique no ícone Filtrar na tabela de saída e insira um prompt. Por exemplo, como no exemplo animado a seguir, você pode usar o prompt “Mostrar-me apenas homens com mais de 70 anos.”

Correção rápida

Quando o código retorna erros, a Correção Rápida recomenda automaticamente correções para erros básicos que podem ser corrigidos em uma alteração de linha única.

Clique em Aceitar e execute para fazer a correção recomendada e continuar executando seu código, conforme mostrado na seguinte captura de tela:

Código de depuração: exemplos de Python e SQL

Para usar o Genie Code para corrigir o código, faça qualquer um dos seguintes procedimentos:

• Faça uma pergunta no painel Genie Code.
• Clique no botão Diagnosticar Erro que aparece nos resultados da célula quando ocorre um erro.
• Clique em Depurar para percorrer interativamente o código linha a linha, definir pontos de interrupção, inspecionar variáveis e analisar a execução de um programa.

As guias abaixo mostram exemplos de erro de diagnóstico no código Python e SQL:

Python

SQL

Quando você clica em Diagnosticar erro, o Assistente executa automaticamente um prompt '/fix'.

Quando você clica em Diagnosticar erro, o Assistente é executa /fix automaticamente.

Erros de ambiente de depuração

O Genie Code pode ajudar a diagnosticar e sugerir correções para falhas de ambiente, incluindo erros de instalação da biblioteca.

Quando há uma falha de instalação no painel lateral do ambiente, o ícone do Código Genie, , aparece na parte inferior direita. Clique no Para abrir o painel Genie Code, em que o Genie Code é executado /repairEnvironment para ajudar a diagnosticar e corrigir o problema.

Você também pode abrir os logs pip e, em seguida, clicar em Diagnosticar erro para executar o /repairEnvironment comando no painel Genie Code.

Otimizar código Python, PySpark e SQL

Usando o prompt de barra /optimize, avalie e otimize códigos em Python, PySpark e SQL.

1. Em uma célula do bloco de anotações ou no editor do SQL, clique no Ícone do Genie Code.
2. Na caixa de prompt, digite /optimizee clique no botão Gerar .
3. Para usar as sugestões de otimização do Genie Code, clique em Aceitar.

Veja como /optimize ajuda com o código:

• Avisos de pré-execução: Sublinhados amarelos destacam oportunidades para otimizar sua consulta antes da execução, como quando você não está filtrando em uma coluna de partição. Passe o mouse sobre o texto sublinhado para exibir sugestões de otimização.
• Análise pós-execução: Depois de executar o código, clique no botão Otimizar .
• Sugestões de nível de tabela: Por exemplo, quando os usuários criam uma tabela, eles recebem uma dica recomendando CREATE TABLE CLUSTER BY AUTO.

Informações adicionais

Os artigos a seguir contêm informações adicionais sobre como usar o Genie Code:

• Genie Code
• Usar o Código do Gênio
• Confiabilidade e segurança dos recursos assistivos de IA do Databricks
• Medir o impacto do Genie Code