Usar o Databricks Assistant

O Databricks Assistant é um assistente de IA com reconhecimento de contexto que está disponível no Databricks Notebook, no editor SQL e no editor de arquivos. O Databricks Assistant permite que o senhor consulte o uso de dados em uma interface de conversação, tornando-o mais produtivo dentro da Databricks. O senhor pode descrever sua tarefa em inglês e deixar que o assistente gere código Python ou consultas SQL, explique códigos complexos e corrija erros automaticamente. O assistente usa os metadados do Unity Catalog para entender suas tabelas, colunas, descrições e dados populares ativos em sua empresa para fornecer respostas personalizadas.

O Databricks Assistant pode executar as seguintes tarefas:

  • Gerar código.

  • Depurar código, inclusive identificando e sugerindo correções para erros.

  • Transformar e otimizar o código.

  • Explicar o código.

  • Ajudar o senhor a encontrar informações relevantes na documentação da Databricks.

Databricks O Assistente é ativado por default. Um administrador pode desativar ou ativar o Databricks Assistant para todos os espaços de trabalho em um account. Se um administrador tiver permitido a substituição das configurações do workspace, os administradores do workspace poderão ativar ou desativar o Databricks Assistant para um espaço de trabalho específico. Para obter mais detalhes, consulte Ativar ou desativar o Databricks Assistant.

A ativação do Databricks Assistant para o seu account é capturada como um evento account em sua auditoria logs, consulte account-level account events.

Informações adicionais

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

Como usar o Databricks Assistant

O Databricks Assistant está disponível no Notebook, no editor SQL, no editor de arquivos e nos painéis do Lakeview. Este documento se concentra no Notebook. O uso no outro produto é semelhante. Para obter informações sobre como usar o Databricks Assistant para criar visualizações para painéis do Lakeview, consulte Criar visualizações com o Databricks Assistant para Lakeview.

Em um site Notebook, o Databricks Assistant está disponível no painel Assistant ou em linha em uma célula de código.

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

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 assistente gere uma resposta.

Captura de tela do assistente inline em uso

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

Quando o senhor usa /fix ou /doc, o assistente exibe as alterações propostas em uma janela de diferenças. 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.

Para o autocompletar de código, o desempenho pode ser melhor usando o painel Assistente do que em uma célula do site Notebook.

Para sair do Assistente em uma célula do site Notebook, clique em assistente próximo no canto superior direito da célula. O Assistente fecha automaticamente se o senhor aceitar ou rejeitar o código gerado.

Usar o painel Assistente

Para abrir o painel Assistente, clique em Ícone do assistente do Databricks 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 inserir 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 após o Assistente ter gerado o código no painel Assistente.

ícones na parte superior da caixa de código no painel do 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 assistente próximo no canto superior direito da célula. O senhor pode expandir o painel até a largura total clicando em abrir ícone de largura total; clique em fechar ícone de largura total para retornar o painel à largura de default.

ícones na parte superior do painel do 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 clear-assistant no canto superior direito do painel do Assistente.

Código de depuração

Para usar o Databricks Assistant para corrigir o código, faça uma pergunta no painel do Assistant ou clique no botão Diagnose Error (Diagnosticar erro ) que aparece nos resultados da célula quando ocorre um erro.

Exemplo de depuração de assistente

Transformar ou otimizar o código

O Databricks Assistant pode ajudar a otimizar seu código para torná-lo mais eficiente. Por exemplo, ele pode sugerir maneiras de otimizar códigos lentos ou ineficientes, como a substituição de loops desnecessários por funções integradas, ou pode converter o código Pandas em PySpark ou Spark SQL.

Explicar o código

O Databricks Assistant pode fornecer explicações detalhadas sobre trechos de código. No prompt fornecido, o senhor pode incluir 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 detalhes da explicação fornecida. O senhor também pode pedir ao Databricks Assistant para adicionar comentários ao código.

Encontre informações relevantes na documentação da Databricks

O Databricks Assistant pode ajudar a responder perguntas baseadas na documentação da Databricks diretamente do editor Notebook.

Responder à 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 ao esquema e aos 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 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 pedir ao Databricks Assistant para alterar o resultado de uma resposta anterior sem precisar reescrever todo o prompt, conforme mostrado abaixo.

De forma semelhante ao exemplo acima, o senhor pode usar o histórico de bate-papo do Assistente para limpar, explorar, filtrar e dividir iterativamente os DataFrames no painel do Assistente.

Formatar automaticamente o código

Para formatar seu código de modo a aderir às práticas recomendadas, digite "prettify" na caixa de texto do assistente ou no painel do assistente.

exemplo de código de formato

Seja específico

Como o Databricks Assistant não usa dados em nível de linha, o senhor pode fornecer mais detalhes aos prompts para obter a resposta mais precisa. Por exemplo, especifique a aparência dos dados ou se são necessárias conversões de tipos de dados de coluna para realizar uma operação.

Por exemplo: "converter este código de Pandas para PySpark, incluindo o código necessário para converter o DataFrame Pandas em um DataFrame PySpark 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

O senhor pode usar 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 executar o código 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.

código de execução no painel 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.