Usar o Assistente Databricks

Importante

Este recurso está atualmente em Visualização Pública. O uso do recurso durante a visualização é gratuito. O preço final será estabelecido e comunicado antes da disponibilidade geral (GA).

O Databricks Assistant é um assistente de IA sensível ao contexto que está disponível em blocos de anotações Databricks, editor SQL e editor de arquivos. O Databricks Assistant permite consultar dados 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 executar as seguintes tarefas:

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

O Assistente Databricks está habilitado por padrão. Um administrador pode desativar ou ativar o Assistente Databricks para todos os espaços de trabalho de uma conta. Se um administrador tiver permitido substituições de configurações de espaço de trabalho, os administradores de espaço de trabalho poderão habilitar ou desabilitar o Assistente Databricks para espaços de trabalho específicos. Para obter mais detalhes, consulte Habilitar ou desabilitar o Assistente Databricks.

A ativação do Assistente Databricks para sua conta é capturada como um evento de conta em seus logs de auditoria, consulte Eventos de conta no nível da conta.

Informações adicionais

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

• O que é o Databricks Assistant?
• DatabricksIQ confiança e segurança.

Como usar o Databricks Assistant

O Databricks Assistant está disponível em blocos de anotações, editor SQL, editor de arquivos e painéis. Este documento centra-se nos cadernos. O uso nos outros produtos é semelhante. Para obter informações sobre como usar o Databricks Assistant para criar visualizações para painéis, consulte Criar visualizações com o Databricks Assistant.

Em um bloco de anotações, o Assistente Databricks está disponível no painel Assistente ou embutido em uma célula de código.

Usar o Assistente Databricks em uma célula de bloco de anotações

Para usar o Assistente Databricks diretamente em uma célula de código, pressione Cmd + i MacOS ou Ctrl + i Windows. Uma caixa de texto aparece dentro da 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.

Você também pode digitar / para exibir uma lista de comandos comuns, como /explain explicar o código em uma célula, /fix propor uma correção se o código tiver um erro e /doc sugerir comentários de documentação para seu código.

Quando você usa /fix ou /doc, o assistente exibe as alterações propostas em uma 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 usar o Databricks Assistant.

Para o preenchimento automático de código, o desempenho pode ser melhor usando o painel Assistente do que em uma célula do bloco de anotações.

Para sair do Assistente numa célula do bloco de notas, clique em no canto superior direito da célula. O Assistente fecha automaticamente se você aceitar ou rejeitar o código gerado.

Usar o painel Assistente

Para abrir o painel Assistente, clique na barra lateral esquerda.

Digite perguntas na caixa de texto na parte inferior do painel Assistente e pressione Enter ou clique à direita da caixa de texto. O Assistente exibe sua resposta. A captura de tela a seguir mostra as ações que você pode executar depois que o Assistente gerou código no painel Assistente.

Você pode executar a mesma consulta novamente para gerar outra resposta. Para fazer isso, passe o cursor sobre a resposta e clique em .

Para fechar o painel, clique no ícone novamente ou clique no canto superior direito da célula. Você pode expandir o painel para largura total clicando em ; clique para retornar o painel à largura padrão.

O painel Assistente controla as suas conversas mesmo que feche o painel ou o bloco de notas. Para limpar conversas anteriores, clique no canto superior direito do painel Assistente.

Preenchimento automático baseado em IA

Importante

Esta funcionalidade está em Pré-visualização Pública.

O preenchimento automático baseado em IA fornece sugestões de código embutido à medida que você digita em blocos de anotações Databricks, no editor SQL e no editor de arquivos. Sugestões de código embutido estão disponíveis para Python e SQL.

Ativar e desativar sugestões de código embutido

Na maioria dos espaços de trabalho, as sugestões de código embutido são habilitadas por padrão. Um administrador pode desativar o recurso da seguinte maneira:

1. Clique no seu nome de utilizador no canto superior direito da área de trabalho do Azure Databricks e selecione Pré-visualizações no menu pendente.
2. Alterne o Databricks Assistant Autocomplete.

O recurso deve ser habilitado para cada usuário da seguinte maneira:

1. Clique em Definições.
2. Em Recursos experimentais, alterne o Databricks Assistant Autocomplete.

Nota

As sugestões de código embutido não estão disponíveis em regiões do Azure Government ou espaços de trabalho com conformidade com FedRAMP.

Usar sugestões de código embutido

À 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).

O preenchimento automático baseado em IA também pode gerar código a partir de comentários:

Código de depuração

Para usar o Assistente Databricks para corrigir o código, faça uma pergunta no painel Assistente ou clique no botão Diagnosticar erro que aparece nos resultados da célula quando ocorre um erro. As guias abaixo mostram exemplos de código Python e SQL.

Python

Sql

Explicar o código

O Databricks Assistant pode fornecer explicações detalhadas de trechos de código. No prompt fornecido, você pode incluir termos como "seja conciso" ou "explique o código linha por linha" para solicitar o nível de detalhe para a explicação que ele fornece. Você também pode pedir ao Databricks Assistant para adicionar comentários ao código.

Encontre informações relevantes na documentação do Azure Databricks

O Databricks Assistant pode ajudar a responder a perguntas com base na documentação do Databricks diretamente do editor de notebook.

Dicas para usar o Databricks Assistant

Esta seção inclui algumas dicas gerais e práticas recomendadas ao usar o Databricks Assistant.

O Databricks Assistant usa o contexto para fornecer respostas melhores

O Databricks Assistant tem acesso ao esquema e metadados de tabela e coluna. Isso permite que você use linguagem natural e gere consultas mais precisas. Por exemplo, se uma tabela tiver uma coluna Estado, você pode pedir ao Databricks Assistant para gerar uma lista de usuários que moram em Michigan.

O Databricks Assistant usa o seguinte contexto:

• Código ou consultas na célula atual do bloco de anotações ou na guia do editor SQL do Databricks.
• Nomes e descrições de tabelas e colunas.
• Perguntas prévias.
• Mesas favoritas e ativas.
• Para o recurso de erro de diagnóstico, o rastreamento de pilha da saída do erro.

Ao selecionar colunas de um DataFrame, você pode obter resultados mais precisos fornecendo uma consulta inicial. Por exemplo, forneça uma instrução como SELECT * FROM <table_name>. Isso permite que o Databricks Assistant obtenha os nomes das colunas e não precise adivinhar.

Como o Databricks Assistant usa seu histórico de conversas para fornecer respostas melhores e mais precisas, você pode pedir ao Databricks Assistant para alterar a saída de uma resposta anterior sem ter que reescrever todo o prompt. Você pode usar o histórico de bate-papo do Assistente para limpar, explorar, filtrar e fatiar iterativamente DataFrames no painel Assistente.

Seja específico

A estrutura e os detalhes que o Databricks Assistant fornece variam de tempos em tempos, mesmo para o mesmo prompt. Tente fornecer ao assistente o máximo de orientação possível para ajudá-lo a retornar as informações desejadas no formato desejado, nível de detalhe e assim por diante. Por exemplo:

• "Explique este código em algumas frases" ou "Explique este código linha por linha".
• "Criar uma visualização usando MatPlotLib" ou "Criar uma visualização usando Seaborn".

Dê exemplos de valores de dados em nível de linha

Como o Assistente Databricks não usa dados em nível de linha, talvez seja necessário fornecer mais detalhes aos prompts para obter a resposta mais precisa. Use comentários de tabela ou coluna no Gerenciador de Catálogo para adicionar uma linha de dados de exemplo. Por exemplo, suponha que sua coluna de altura esteja no formato feet-inches. Para ajudar o assistente a interpretar os dados, adicione um comentário como "A coluna de altura está em formato de cadeia de caracteres e é separada por um hífen. Exemplo: '6-2'." Para obter informações sobre comentários de tabela e coluna, consulte Dados do documento no Gerenciador de Catálogos usando comentários de marcação.

Também pode ser necessário fornecer detalhes se forem necessárias conversões de tipo de dados de coluna para executar uma operação. Por exemplo: "converta este código de pandas para PySpark, incluindo o código necessário para converter o DataFrame de pandas em um DataFrame PySpark e alterando o tipo de dados de rotatividade de coluna de booleano para inteiro".

Use Shift+Enter para adicionar uma nova linha na caixa de texto do bate-papo

Você pode usar Shift+Enter para adicionar uma nova linha na caixa de texto do bate-papo do Assistente. Isso facilita a formatação e organização de suas mensagens para o Databricks Assistant.

Editar e executar código no painel de chat do Assistente do Databricks

Você pode executar o código no painel Assistente para validá-lo ou usá-lo como um bloco de rascunho. Para executar o código, clique no canto superior esquerdo da caixa de código no painel Assistente. As guias abaixo mostram exemplos de código Python e SQL.

Python

Sql

Quando você executa o código no painel Assistente, a saída é exibida e as variáveis se tornam utilizáveis no bloco de anotações.

Você também pode editar o código que o Assistente Databricks gera diretamente na caixa de bate-papo do Assistente antes de mover o código para o bloco de anotações.