Usar o Databricks Assistant

Databricks Assistant é um assistente de AI com reconhecimento de contexto que está disponível no Notebook, no editor SQL, nos painéis AI/BI e no editor de arquivos. Este documento se concentra no Notebook. O uso no outro recurso do site Databricks é semelhante.

Para um account: Desativar ou ativar Databricks Assistant recurso

parceiros-powered Databricks Assistant recurso são ativados por default. No entanto, os administradores do site account podem desativar o recurso Assistant com parceiros para todos os espaços de trabalho em um site account. Os administradores de conta também podem impor a ativação do Databricks Assistant para todo o account:

Dica

O ato de ativar ou desativar o recurso de parceiros Databricks Assistant para seu account é capturado como um evento account em sua auditoria logs, consulte eventos de conta.

  1. Como administrador da conta, faça login no console da conta.

  2. Clique em Settings.

  3. Clique na guia Ativação de recursos .

  4. Para a opção Ativar recurso de AI alimentado por parceiros, selecione Desligado ou Ligado.

  5. Evite workspace substituições com a configuração Enforce:

    Aplicar configuração que substitui uma configuração do site workspace.

Para saber mais sobre o serviço usado para o recurso Databricks Assistant alimentado por parceiros, consulte o recurso regido pela configuração **parceiros-powered AI assistive recurso.

Para um workspace: Desativar ou ativar o recurso Assistant

Se o administrador do account ativar o Assistant, ele será ativado pelo default no espaço de trabalho. A menos que o administrador do account opte por aplicar a configuração, os administradores do workspace podem desativá-la em seu espaço de trabalho.

Para desativar o Databricks Assistant em um workspace:

  1. Clique no seu nome de usuário na barra superior do site Databricks workspace > Settings.

  2. No painel esquerdo, em workspace admin, clique em Advanced tab.

  3. Para desativar o Assistant, clique no botão Off (Desligado ) para o recurso de assistência da IA com IA.

Tour do painel Assistente

Esta seção descreve a experiência default do painel Assistente.

Para abrir o painel Assistente, clique em Ícone do assistente de ajuda no produto - cinza na barra lateral esquerda.

Captura de tela do painel do assistente em uso.

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

Ícones na parte superior da caixa de código no painel Assistente.

O senhor pode executar a mesma consulta novamente para gerar outra resposta. Para fazer isso, passe o cursor sobre a resposta e clique em Regenerar Query Icon..

Para fechar o painel, clique no ícone novamente ou clique em Fechar o ícone do assistente. no canto superior direito da célula. O senhor pode expandir o painel até a largura total clicando em O ícone de abertura em toda a largura.; clique em fechar ícone de largura total para retornar o painel à largura de default.

Ícones na parte superior do painel Assistente.

O painel Assistente mantém o controle de suas conversas mesmo que o senhor feche o painel ou Notebook. Para limpar as conversas anteriores, clique em Limpar o ícone do assistente. no canto superior direito do painel do Assistente.

Threads e prompt história

Os tópicos de conversação persistem nos diferentes contextos em que o Databricks Assistant está disponível. No painel Assistente, o senhor pode criar novos tópicos de conversa, view o histórico de perguntas e solicitações e gerenciar sua experiência em Databricks Assistant.

Ícones do painel Assistente.

Databricks Assistant intitula os tópicos com base no contexto de seus prompts, para que o senhor possa navegar pela história da conversa com o Assistente. O exemplo a seguir é de uma pergunta sobre o site Notebook.

Exemplo de um título para um tópico do Databricks Assistant.

Use o Databricks Assistant em uma célula do site Notebook

Em um site Notebook, o Databricks Assistant está disponível no painel Assistant 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 (não Shift+Enter, como faria para executar uma célula) para que o Assistant gere uma resposta.

O assistente em linha ajuda o senhor 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 do prompt

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.

/findQueries

Busca consultas relevantes com base nos metadados do Unity Catalog.

/optimize

Melhora as consultas SQL ineficientes.

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

Quando o senhor usa /fix ou /doc, na janela de comparação, selecione Accept (Aceitar) para aceitar as alterações propostas ou Reject (Rejeitar ) para manter o código original. Se o senhor aceitar o código proposto, o código não será executado automaticamente. O senhor pode revisar o código antes de executá-lo. Se o código gerado não for o que o senhor 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 prompt /explain e inclua termos como "be concise" (seja conciso) ou "explain code line-by-line" (explique o código linha por linha) para solicitar o nível de detalhe que o senhor deseja. 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 site Notebook.

O Assistant fecha automaticamente se o senhor 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 @

Obter ajuda com o código

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

  • Autocompletar baseado em IA no Databricks Notebook, no editor SQL e no editor de arquivos.

  • Filtragem de dados com prompts de linguagem natural.

  • Depuração de código com Diagnose Error (visualização pública).

Filtrar dados com prompts de linguagem natural

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

Para filtrar os resultados com linguagem natural, clique no ícone Filter (Filtro) na tabela de resultados e digite um prompt. Por exemplo, como no exemplo animado a seguir, o senhor pode solicitar "Show me only male over 70" (Mostre-me apenas homens acima 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.

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

À medida que o senhor digita, as sugestões aparecem automaticamente. Pressione tab para aceitar uma sugestão. Para acionar manualmente uma sugestão, pressione Option + Shift + Espaço (no macOS) ou Control + Shift + Espaço (no Windows).

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

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

GIF animado de conclusão de código a partir de um comentário.

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

Visualização

Esse recurso está em Prévia Pública.

Para usar o Databricks Assistant para corrigir o código, faça um dos seguintes procedimentos:

  • Faça uma pergunta no painel Assistente.

  • Clique no botão Diagnose Error (Diagnosticar erro ) que aparece nos resultados da célula quando ocorre um erro.

  • Clique em Debug 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 nos códigos Python e SQL:

Exemplo de depuração do assistente em Python.
Exemplo de depuração de assistente em SQL.

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

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 a executar seu código:

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

Diagnosticar erros no trabalho (visualização pública)

Visualização

Esse recurso está em Prévia Pública.

Databricks Assistant ajuda a diagnosticar erros no Job.

Para diagnosticar um trabalho com o Assistant:

  1. Abra o trabalho com falha na interface do usuário de trabalhos.

  2. Selecione Diagnose Error (Diagnosticar erro).

Failed Job (Trabalho com falha) com o botão Diagnose Error (Diagnosticar erro).

Obtenha respostas da documentação da Databricks

No editor Notebook, Databricks Assistant pode responder a perguntas com base na documentação da Databricks. Digite sua pergunta ou solicitação na caixa de solicitação.

Responda a uma pergunta com base na documentação da Databricks.

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 o senhor use linguagem natural e gere consultas mais precisas. Por exemplo, se uma tabela tiver uma coluna chamada State (Estado), o senhor 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 Notebook ou no editor Databricks SQL tab.

  • Nomes e descrições de tabelas e colunas.

  • Perguntas anteriores do prompt.

  • Tabelas favoritas e ativas.

  • Para o recurso de diagnóstico de erro, o rastreamento de pilha da saída de erro.

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

Como o Databricks Assistant usa o histórico da conversa para fornecer respostas melhores e mais precisas, o senhor pode solicitar ao Databricks Assistant que altere o resultado de uma resposta anterior sem precisar reescrever todo o prompt. Use o histórico de bate-papo do Assistant para limpar, explorar, filtrar e dividir de forma iterativa o site DataFrames no painel do Assistant.

Seja específico

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

  • "Explique esse código em algumas frases" ou "Explique esse 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 Databricks Assistant 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 os comentários de tabela ou coluna no Catalog Explorer para adicionar uma linha de dados de amostra. 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á no formato de cadeias de caracteres e é separada por um hífen. Exemplo: '6-2'". Para obter informações sobre comentários em tabelas e colunas, consulte Adicionar comentários aos dados e IA ativo.

Se o senhor precisar usar conversões de tipo de dados de coluna para executar uma operação, talvez seja necessário fornecer detalhes. Por exemplo: "converter este código de Pandas para PySpark, incluindo o código necessário para converter o Pandas DataFrame em um PySpark DataFrame e alterar o tipo de dados da coluna churn de Boolean para integer".

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 Assistant chat. Isso facilita a formatação e a organização de suas mensagens para o Databricks Assistant.

Editar e executar o código no painel de bate-papo do Databricks Assistant

O senhor pode usar o código de execução no painel Assistente para validá-lo ou usá-lo como um bloco de notas. Para executar o código, clique em ícone de código de execução no canto superior esquerdo da caixa de código no painel Assistente.

A guia abaixo mostra exemplos para os códigos Python e SQL:

execução Python código no painel do assistente.
execução SQL código no painel do assistente.

Quando o senhor executa o código no painel Assistente, a saída é exibida e as variáveis se tornam utilizáveis no site Notebook.

O senhor também pode editar o código que o Databricks Assistant gera diretamente na caixa de bate-papo do Assistant antes de mover o código para o site Notebook.

Informações adicionais

Os artigos a seguir contêm informações adicionais sobre o uso do Databricks Assistant: