Compartilhar via


Obter ajuda de codificação do Genie Code

Esta página descreve como você pode usar o Genie Code para ajudá-lo a codificar e depurar seus blocos de anotações e fornece dicas sobre como aproveitar ao máximo o 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 Python código ou consultas SQL, explicar código complexo e corrigir 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.
  • Ajude 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 computação selecionado (por exemplo, notebooks ou editor de SQL), o Genie Code utilizará automaticamente esse recurso em vez disso. 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 inserir 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.

O assistente embutido ajuda você a localizar e adicionar dados de enriquecimento.

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 SQL e código 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 @.

Referência de tabela em uma solicitação do Assistente usando 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.

Obtenha sugestões de código em linha: 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).

GIF animado da conclusão do código para SQL.

GIF animado de autocompletar código para Python.

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

GIF animado da conclusão do código em um comentário.

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 solicitar "Mostrar-me apenas machos nos EUA".

GIF animado mostra o Genie Code filtrando uma tabela de clientes de padaria para encontrar homens nos EUA.

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:

Captura de tela da interface do usuário de correção de bug embutida do Genie Code.

Debug code: 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 em Python e em código SQL:

Python

Exemplo de depuração assistente em Python.

SQL

Exemplo de depuração do Assistente no SQL.

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, ícone assistente do Avatar., aparece na parte inferior direita. Clique no ícone do assistente avatar. 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 Python, PySpark e código SQL

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

  1. Em uma célula do bloco de anotações ou no editor do SQL, clique no ícone de cor assistente. Í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.

Use o prompt de otimização em um notebook.

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: