Obter ajuda do Assistente do Databricks para codificação

Este artigo descreve como você pode usar o Assistente do Databricks para ajudar a codificar e depurar seus notebooks, além de dar dicas para aproveitar ao máximo o Assistente.

Com o que o Assistente do Databricks pode ajudar?

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

O Assistente do Databricks pode ajudar você nas 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 movem o Assistente Databricks, consulte recursos de IA impulsionados por parceiros. Para obter informações gerais sobre o Assistente do Databricks, consulte o que é o Assistente do Databricks?.

Comandos de atalho do assistente para notebooks

Em um notebook, o Assistente do Databricks está disponível no painel do Assistente ou embutido em uma célula do código.

Para usar o Assistente do Databricks 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 Assistente 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 Assistente 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 funcionalidades e tabelas de funcionalidades usando o Assistente do Databricks.
/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 do assistente.

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

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 solicitar que o Assistente do Databricks adicione comentários ao código.

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

O Assistente será fechado automaticamente se você Aceitar ou Rejeitar o código gerado por ele.

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

Para fazer referência rápida a tabelas em prompts do Assistente, use o símbolo @ (@) (arroba).

Obter ajuda com o código

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

• Edite o modo, que funciona em um notebook para fazer correções e atualizações em várias células.
• 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.

Editar o modo para sugestões em várias células do notebook

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

Para usar o modo de edição:

1. Com um bloco de anotações aberto, clique no No canto superior direito da tela.

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

   

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

   O Assistente analisa seu notebook e apresenta sugestões embutidas nas células em que as alterações são necessárias.

4. Depois de gerar sugestões, você pode revisá-las diretamente no bloco de anotações ou por meio do painel Assistente. Clique em qualquer célula no painel Assistente para ir para essa parte do bloco de anotações.

5. Aceite ou rejeite edições individualmente, embutidas no bloco de anotações ou no painel Assistente. Para aplicar todas as sugestões de uma vez, clique em Aceitar Tudo ou Rejeitar Tudo.

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 Assistente do 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 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 Assistente do Databricks para corrigir o código, siga qualquer um dos seguintes procedimentos:

• Faça uma pergunta no painel do 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 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 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 exibido na parte inferior direita. Clique no 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 do pip e, em seguida, clicar em Diagnosticar erro para executar o comando /repairEnvironment no painel do Assistente.

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 notebook ou no editor SQL, clique no ícone do assistente .
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.

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 Assistente do Databricks:

• O que é o Assistente do Databricks?
• Usar o Assistente do Databricks
• Confiabilidade e segurança dos recursos assistivos de IA do Databricks
• Medir o impacto do Assistente do Databricks