Pular para o conteúdo principal

Obtenha ajuda de codificação do Databricks Assistant

Este artigo descreve como o senhor pode usar o Databricks Assistant para ajudá-lo a codificar e depurar o Notebook e fornece dicas sobre como aproveitar ao máximo o Assistente.

Em que o Databricks Assistant pode ajudar?​

Databricks Assistant é um assistente AI com reconhecimento de contexto com o qual o senhor pode interagir usando uma interface de conversação, tornando-o mais produtivo em Databricks. O senhor pode descrever sua tarefa em inglês e deixar que o assistente gere código Python ou consultas SQL, explique códigos complexos e corrija erros automaticamente. O assistente usa os metadados do site Unity Catalog para entender suas tabelas, colunas, descrições e dados populares ativos em toda a sua empresa para fornecer respostas personalizadas.

Databricks Assistant pode ajudar o senhor com a tarefa a seguir:

  • Gere código.
  • Código de depuração, incluindo identificação e sugestão de correções para erros.
  • Transforme, otimize e refatore o código.
  • Explique o código.
  • Ajudar o senhor a encontrar informações relevantes na documentação da Databricks.

Para obter informações sobre os modelos que alimentam Databricks Assistant, consulte recurso AI com tecnologia de parceiros. Para obter informações gerais sobre Databricks Assistant, consulte O que é Databricks Assistant?.

Atalhos do comando Assistant para o Notebook​

Em um Notebook, o site Databricks Assistant está disponível no painel Assistente ou em linha em uma célula de código.

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

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

Use o comando slash para prompts​

Os comandos de barra são um atalho para a criação de prompts comuns.

Texto rápido

O que o Assistente faz

/

Exibe o comando comum

/doc

Comentários sobre o código em um diff view

/explain

Fornece uma explicação do código em uma célula

/fix

Propõe uma correção para qualquer erro de código em um diff view

/findTables

Busca tabelas relevantes com base nos metadados do Unity Catalog. Para localizar recurso ou tabelas de recurso, mencione "recurso" ou "recurso tables" na consulta. Consulte Localizar recurso e tabelas de recurso usando Databricks Assistant.

/findQueries

Busca consultas relevantes com base nos metadados do Unity Catalog.

/optimize

Aprimora o código SQL e Python.

/prettify

Formata o código para facilitar a leitura.

/rename

Sugere nomes atualizados para células do Notebook e outros elementos, dependendo do contexto.

/settings

Ajusta as configurações do Notebook diretamente do Assistant.

Ao usar /fix ou /doc, na janela diff, selecione Aceitar para aceitar as alterações propostas ou Rejeitar para manter o código original. Se aceitar o código proposto, o código não será executado automaticamente. Você pode revisar o código antes de executá-lo. Se o código gerado não for o desejado, tente novamente adicionando mais detalhes ou informações ao seu comentário. Consulte Dicas para melhorar as respostas do Assistente.

Obtenha explicações detalhadas sobre trechos de código. Use o prompt /explain e inclua termos como “seja conciso” ou “explique o código linha por linha” para solicitar o nível de detalhes desejado. O senhor também pode pedir ao Databricks Assistant para adicionar comentários ao código.

Para o autocompletar de código, o desempenho pode ser melhor usando o painel Assistente do que em uma célula do Notebook.

O Assistente fecha automaticamente se você aceitar ou rejeitar o código gerado.

Tabelas de referência em prompts usando @​

Para referenciar tabelas rapidamente nas instruções do Assistente, use o símbolo @ (at).

Referência de tabela em um prompt do Assistente usando o símbolo @

Obtenha ajuda com o código​

O Databricks Assistant ajuda com o código, tanto SQL quanto Python:

  • Modo de edição, que funciona em todo o Notebook para fazer correções e atualizações em várias células.
  • AIO preenchimento automático baseado em Databricks Notebook, o editor SQL e o editor de arquivos.
  • Filtragem de dados com solicitações em linguagem natural.
  • Código de depuração com Diagnose Error .

Modo de edição para sugestões em várias células do Notebook​

O modo de edição aplica sugestões geradas pelo “ AI ” em várias células do seu Notebook a partir de um único prompt.

Para usar o modo de edição:

  1. Com um Notebook aberto, clique no ícone do Assistente Ícone Sparkle. no canto superior direito da tela.

  2. No painel Assistente, clique em Editar na parte inferior da caixa de solicitação.

    Modo de edição no painel Databricks Assistant.

  3. No modo de edição, insira um prompt da mesma forma que faria no modo de bate-papo.

    O assistente analisa seu caderno e apresenta sugestões diretamente nas células onde são necessárias alterações.

  4. Após gerar sugestões, é possível revisá-las diretamente no Bloco de notas ou através do painel do Assistente. Clique em qualquer célula no painel Assistente para acessar essa parte do Caderno.

  5. Aceite ou rejeite edições individualmente, seja diretamente no Caderno ou no painel Assistente. Para aplicar todas as sugestões de uma só vez, clique em Aceitar tudo ou Rejeitar tudo .

Obtenha sugestões de código em linha: Exemplos de Python e SQL​

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

GIF animado do recurso de autocompletar código para SQL.

GIF animado do recurso de autocompletar código para Python.

AIO autocompletar baseado em - também pode gerar código a partir de comentários:

GIF animado de preenchimento de código a partir de um comentário.

Filtre dados com solicitações de linguagem natural​

Use o Databricks Assistant para filtrar as saídas de dados com prompts de linguagem natural.

Para filtrar as saídas com linguagem natural, clique no ícone Filtro na tabela de saída e insira um prompt. Por exemplo, como no exemplo animado a seguir, você pode solicitar “Mostre-me somente homens com mais de 70 anos”.

O GIF animado mostra o Databricks Assistant filtrando uma tabela de sobreviventes do Titanic para homens com mais de 70 anos de idade.

Correção rápida​

Quando o código retorna erros, o Quick Fix recomenda automaticamente correções para erros básicos que podem ser corrigidos com uma única alteração de linha.

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

Captura de tela da UI de correção de bugs em linha do Databricks Assistant.

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

Para usar o Databricks Assistant para corrigir o código, faça uma das seguintes ações:

  • Faça uma pergunta no painel Assistente.
  • 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 por linha, definir pontos de interrupção, inspecionar variáveis e analisar a execução de um programa.

A guia abaixo mostra exemplos de erros de diagnóstico nos códigos Python e SQL:

Exemplo de depuração do assistente em Python.

Quando o senhor clica em Diagnosticar erro , o Assistente executa automaticamente /fix.

Erros de ambiente de depuração​

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

Quando ocorre uma falha de instalação no painel lateral do ambiente, o ícone do Assistente Ícone Sparkle. aparece no canto inferior direito. Clique Ícone Sparkle. para abrir o painel Assistente, onde o Assistente executa /repairEnvironment para ajudar a diagnosticar e corrigir o problema.

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

Otimizar o código Python, PySpark e SQL​

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

  1. Em uma célula do Notebook ou no editor SQL, clique no ícone Ícone do assistente de ajuda do produto - cor Assistant.
  2. Na caixa de solicitação, digite /optimize e clique no botão Gerar .
  3. Para usar as sugestões de otimização do Assistente, clique em Aceitar .

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

Veja como /optimize ajuda com o código:

  • Avisos pré-execução: Os sublinhados amarelos destacam oportunidades de otimizar a consulta antes da execução, como quando o usuário não está filtrando em uma coluna de partição. Passe o mouse sobre o texto sublinhado para acessar view sugestões de otimização.
  • Análise pós-execução: Depois de executar o código, clique no botão Optimize (Otimizar ).
  • Sugestões em 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 o uso do site Databricks Assistant:

Última atualização em