Usar o Assistente Databricks
O Databricks Assistant é um assistente de IA sensível ao contexto que pode ajudá-lo com notebooks Databricks, editor SQL, trabalhos, painéis de IA/BI e editor de arquivos. O Databricks Assistant ajuda-o com dados e código quando pede ajuda utilizando uma interface de conversação.
Para uma conta: Desativar ou ativar os recursos do Assistente do Databricks
Os recursos do Assistente Databricks com IA do Azure são habilitados por padrão. No entanto, os administradores de conta podem desabilitar os recursos do Assistente com IA do Azure para todos os espaços de trabalho em uma conta. Os administradores de conta também podem impor a ativação do Databricks Assistant para toda a conta:
Gorjeta
O ato de habilitar ou desabilitar os recursos do Assistente Databricks com IA do Azure para sua conta é capturado como um evento de conta em seus logs de auditoria, consulte Eventos de conta.
Como administrador da conta, inicie sessão na consola da conta.
Importante
Se nenhum utilizador no seu inquilino do Microsoft Entra ID tiver ainda iniciado sessão na consola da conta, você ou outro utilizador no seu inquilino tem de iniciar sessão como o primeiro administrador da conta. Para fazer isso, você deve ser um Administrador Global do Microsoft Entra ID, mas somente quando fizer logon pela primeira vez no Console de Conta do Azure Databricks. Após o primeiro login, você se torna um administrador de conta do Azure Databricks e não precisa mais da função de Administrador Global do Microsoft Entra ID para acessar a conta do Azure Databricks. Como primeiro administrador de conta, você pode atribuir usuários no locatário do Microsoft Entra ID como administradores de conta adicionais (que podem atribuir mais administradores de conta). Os administradores de conta adicionais não exigem funções específicas no Microsoft Entra ID. Consulte Gerenciar usuários, entidades de serviço e grupos.
Clique em Definições.
Clique na guia Ativação de recursos.
Para a opção Habilitar recursos baseados em IA do Azure, selecione Desativado ou Ativado.
Impedir substituições de espaço de trabalho com a configuração Enforce :
Para saber mais sobre os serviços usados para os recursos do Assistente de Databricks alimentado por IA do Azure, consulte Recursos regidos pela configuração Recursos de assistência de IA alimentados por parceiros.
Para um espaço de trabalho: desativar ou ativar recursos do Assistente
Se o administrador da sua conta ativar o Assistente, ele será habilitado por padrão nos espaços de trabalho. A menos que o administrador da conta opte por impor a configuração, os administradores do espaço de trabalho podem desativá-la para seus espaços de trabalho.
Para desativar o Assistente Databricks em um espaço de trabalho:
- Clique no seu nome de utilizador na barra superior das Definições da área de trabalho >Databricks.
- No painel esquerdo, em Administração do espaço de trabalho, clique na guia Avançado.
- Para desativar o Assistente, clique no botão Desativar para recursos assistivos de IA alimentados por IA do Azure.
Tour do painel Assistente
Esta seção descreve a experiência padrão do 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.
Tópicos e histórico de prompts
Os tópicos de conversa persistem nos diferentes contextos em que o Databricks Assistant está disponível. No painel Assistente, você pode criar novos tópicos de conversa, exibir o histórico de perguntas e prompts e gerenciar sua experiência com o Assistente do Databricks.
O Databricks Assistant intitula os threads com base no contexto dos prompts, para que você possa navegar pelo histórico da conversa do Assistente. O exemplo a seguir é de uma pergunta sobre um bloco de anotações.
Usar o Assistente Databricks em uma célula de bloco de anotações
Em um bloco de anotações, o Assistente Databricks está disponível no painel Assistente ou embutido em uma 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 pressionar Enter (não Shift+Enter, como faria para executar uma célula) para que o Assistente gere uma resposta.
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 |
Comentários 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 visualização de comparação |
/findTables |
Procura tabelas relevantes com base nos metadados do Catálogo Unity. |
/findQueries |
Procura consultas relevantes com base nos metadados do Catálogo Unity. |
/optimize |
Melhora consultas SQL ineficientes. |
/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 usar o Databricks Assistant.
Obtenha explicações detalhadas sobre trechos de código. Use o /explain prompt 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 usando o painel Assistente do que em uma célula do bloco de anotações.
O Assistente fecha automaticamente se você Aceitar ou Rejeitar o código gerado.
Tabelas de referência em prompts usando @
Para referenciar tabelas rapidamente nos prompts do Assistente, use o @ símbolo (at).
Obter ajuda com o código
O Databricks Assistant ajuda com código, tanto SQL quanto Python:
- 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 (Visualização pública).
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.
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".
Obtenha sugestões de código embutidas: 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).
O preenchimento automático baseado em IA também pode gerar código a partir de comentários:
Código de depuração: exemplos de Python e SQL
Importante
Esta funcionalidade está em Pré-visualização Pública.
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 em código Python e SQL:
Python
SQL
Quando você clica em Diagnosticar erro, o Assistente é executado /fixautomaticamente .
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 única alteração de linha.
Clique em Aceitar e executar para fazer a correção recomendada e continuar executando seu código:
Diagnosticar erros em trabalhos (Visualização pública)
Importante
Esta funcionalidade está em Pré-visualização Pública.
O Databricks Assistant ajuda a diagnosticar erros em trabalhos.
Para diagnosticar um trabalho com o Assistente:
- Abra o trabalho com falha na interface do usuário Trabalhos.
- Selecione Diagnosticar erro.
Obtenha respostas da documentação do Azure Databricks
No editor de notebook, o Databricks Assistant pode responder a perguntas com base na documentação do Databricks. Digite sua pergunta ou prompt na caixa de prompt.
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 a esquemas e metadados de tabelas e colunas. Isso permite que você use linguagem natural e gere consultas mais precisas. Por exemplo, se uma tabela tiver uma coluna chamada Estado, você poderá 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. Use 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 tabelas e colunas, consulte Adicionar comentários a dados e ativos de IA.
Se você precisar usar conversões de tipo de dados de coluna para executar uma operação, talvez seja necessário fornecer detalhes. 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
Use 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
Execute o código no painel Assistente para validá-lo ou usá-lo como um scratchpad. 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.
Informações adicionais
Os seguintes artigos contêm informações adicionais sobre como usar o Databricks Assistant: