Partilhar via

Obtenha ajuda de codificação do Databricks Assistant

Este artigo descreve como se pode usar o Assistente Databricks para ajudar a codificar e depurar os seus notebooks e dá dicas para tirar o máximo proveito do Assistente.

O que o Databricks Assistant pode ajudar?

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

O Databricks Assistant pode ajudá-lo com as seguintes tarefas:

  • Gere código.
  • Depurar código, incluindo identificar e sugerir correções para erros.
  • Transforme, otimize e refatore o código.
  • Explique o código.
  • Ajudá-lo a encontrar informações relevantes na documentação do Azure Databricks.

Para obter informações sobre os modelos que alimentam o Databricks Assistant, consulte Recursos de IA alimentados por parceiros. Para obter informações gerais sobre o Databricks Assistant, consulte O que é o Databricks Assistant?.

Atalhos de comando do Assistente de para blocos de notas

Em um caderno, o Assistente Databricks está disponível no painel Assistente ou integrado numa célula de código.

Para usar o Assistente Databricks 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. Você pode digitar uma pergunta ou comentário em inglês e, em seguida, pressionar Enter (não Shift+Enter, como faria para executar uma célula) para que o Assistente gere uma resposta.

O assistente integrado ajuda a localizar e adicionar dados de enriquecimento.

Usar comandos de barra para prompts

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

Texto prompt O que o Assistente faz
/ Exibe comandos comuns
/doc Comenta o código numa vista de diferença
/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 visualização de comparação
/findTables Procura tabelas relevantes com base nos metadados do Catálogo Unity. Para encontrar recursos ou tabelas de recursos, mencione "recursos" ou "tabelas de recursos" na consulta. Consulte Localizar funcionalidades e tabelas de funcionalidades usando o Assistente Databricks.
/findQueries Procura consultas relevantes com base nos metadados do Catálogo Unity.
/optimize Melhora o código SQL e Python.
/prettify Formata o código para facilitar a leitura.
/rename Sugere nomes atualizados para células do bloco de anotações e outros elementos, dependendo do contexto.
/settings Ajusta as definições do seu bloco de notas diretamente a partir do Assistente.

Quando você usar /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ê pode 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 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 detalhe desejado. Você também pode pedir ao Databricks Assistant para adicionar comentários ao código.

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

O Assistente fecha automaticamente se Aceitares ou Rejeitares o código que gerou.

Tabelas de referência em prompts usando @

Para referenciar tabelas rapidamente nos prompts do Assistente, use o símbolo @ (at).

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

Obter ajuda com o código

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

  • Modo de edição, que funciona em um bloco de anotações para fazer correções e atualizações em várias células.
  • Preenchimento automático baseado em IA em blocos de anotações Databricks, no editor SQL e no editor de arquivos.
  • Filtragem de dados com prompts em linguagem natural.
  • Depuração de código com Diagnose Error.

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

O modo de edição aplica sugestões geradas por IA em várias células do seu bloco de anotações a partir de um único prompt.

Para usar o modo de edição:

  1. Com um bloco de notas aberto, clique no ícone Assistente Ícone de brilho no canto superior direito do ecrã.

  2. No painel Assistente, clique em Editar na parte inferior da caixa de prompt.

    Modo de edição no painel Assistente do Databricks.

  3. No modo de edição, insira um prompt como faria no modo de bate-papo.

    O Assistente analisa o seu bloco de notas e apresenta sugestões em linha nas células onde são necessárias alterações.

  4. Depois de gerar sugestões, você pode revisá-las diretamente no caderno ou através do painel Assistente. Clique em qualquer célula no painel Assistente para saltar para essa parte do bloco de notas.

  5. Aceite ou rejeite edições individualmente, em linha no bloco de notas ou a partir do painel Assistente. Para aplicar todas as sugestões de uma só vez, clique em Aceitar tudo ou Rejeitar tudo.

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

À medida que 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 de preenchimento automático de 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 a partir de comentários:

GIF animado de completar automaticamente o código a partir de um comentário.

Filtrar dados com prompts de linguagem natural

Use o Assistente Databricks 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 "Mostre-me apenas homens com mais de 70 anos".

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

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 em uma alteração de linha única.

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 ecrã da interface de correção de erros 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, siga um destes procedimentos:

  • 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.

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

Python

Exemplo do Assistente de depuração em Python.

SQL

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

Exemplo de depuração do Assistente em SQL.

Quando o utilizador clica em Diagnosticar erro, o Assistente executa-se 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 da biblioteca.

Quando há uma falha de instalação no painel lateral do ambiente, o ícone do Assistente Ícone de brilho. aparece no canto inferior direito. Clique no ícone Brilho para abrir o painel Assistente, onde o Assistente é executado /repairEnvironment para ajudar a diagnosticar e corrigir o problema.

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

Otimize o código Python, PySpark e SQL

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

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

Utilize o prompt de otimização num notebook.

Veja como /optimize ajuda com o código:

  • Avisos pré-execução: Os 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 cursor sobre o texto sublinhado para ver as sugestões de otimização.
  • Análise pós-execução: Depois de executar o código, clique no botão Otimizar .
  • Sugestões ao nível da tabela: Por exemplo, quando os usuários criam uma tabela, eles recebem uma dica recomendando CREATE TABLE CLUSTER BY AUTO.

Informações adicionais

Os seguintes artigos contêm informações adicionais sobre como usar o Databricks Assistant:

  • Last updated on