O que é o Assistente do 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 Assistente do Databricks funciona como um programador de pares complementar baseado em IA para aumentar a sua eficiência à medida que cria blocos de notas, consultas e ficheiros. Pode ajudar a responder rapidamente a perguntas gerando, otimizando, concluindo, explicando e corrigindo código e consultas.

Esta página fornece informações gerais sobre o Assistente sob a forma de perguntas frequentes. Para perguntas sobre privacidade e segurança, consulte Privacidade e segurança.

Ativar ou desativar o Assistente Databricks

O Assistente Databricks está habilitado por padrão.

Para habilitar ou desabilitar todos os espaços de trabalho em uma conta para o Assistente Databricks, siga estas instruções:

1. Como administrador da conta, inicie sessão na consola da conta.

   Importante

   Se nenhum utilizador no seu inquilino do Microsoft Entra ID (anteriormente Azure Ative Directory) 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.

2. Clique em Definições.

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

4. Na seção Recursos de assistência de IA baseados em serviços de IA do Azure, selecione Habilitado ou Desabilitado e clique em Salvar. Você pode impedir substituições de configuração de espaço de trabalho para esse recurso definindo a alternância Impor como ativada.

Se a configuração de conta permitir substituições de configuração de espaço de trabalho, os administradores de espaço de trabalho poderão habilitar ou desabilitar espaços de trabalho específicos. Para fazer isso, use uma configuração de espaço de trabalho para substituir a configuração padrão no console de conta da seguinte maneira:

1. Vá para a página de configurações de administração do espaço de trabalho.
2. Clique na guia Avançado .
3. Use o menu suspenso Recursos de assistência de IA baseados em serviços de IA do Azure para fazer sua seleção.
4. Clique em Guardar.

Usar o Databricks Assistant para sugestões de codificação e ajuda

Para acessar o Assistente do Databricks, clique no ícone Assistente na barra lateral esquerda do bloco de anotações, no editor de arquivos, no Editor SQL ou na guia Dados do painel.

O painel Assistente é aberto no lado esquerdo da tela.

Alguns recursos do Databricks Assistant são os seguintes:

• Gerar: use linguagem natural para gerar uma consulta SQL.
• Explicar: realce uma consulta ou um bloco de código e faça com que o Assistente Databricks percorra a lógica em inglês claro e conciso.
• Correção: explique e corrija erros de sintaxe e tempo de execução com um único clique.
• Transforme e otimize: converta o código Pandas em PySpark para uma execução mais rápida.

Qualquer código gerado pelo Assistente Databricks destina-se à execução dentro de um ambiente de computação Databricks. Ele é otimizado para criar código em linguagens de programação, estruturas e dialetos suportados pelo Databricks. Não se destina a ser um assistente de programação de uso geral. O Assistente geralmente usará informações de bases de conhecimento do Databricks, como documentação, para responder melhor às perguntas dos usuários. Ele funciona melhor quando a pergunta do usuário está relacionada a perguntas que podem ser respondidas com conhecimento da documentação do Databricks, do Unity Catalog e do código do usuário no espaço de trabalho.

Os usuários devem sempre revisar qualquer código gerado pelo Assistente antes da execução, pois às vezes ele pode cometer erros.

Criar visualizações usando o Assistente Databricks para painéis

Você pode usar o Assistente Databricks ao desenhar painéis. Ao criar visualizações em um conjunto de dados de painel existente, solicite ao Assistente perguntas para receber respostas na forma de gráficos gerados. Para usar o Assistente em um painel, primeiro crie um ou mais conjuntos de dados e, em seguida, adicione um widget de visualização ao Canvas. O widget de visualização inclui um prompt para descrever seu novo gráfico. Digite uma descrição do gráfico que você deseja ver e o assistente irá gerá-lo. Você pode aprovar ou rejeitar o gráfico, ou modificar a descrição para gerar algo novo. Para obter detalhes e exemplos de como usar o Assistente com painéis, consulte Criar visualizações com o Assistente Databricks.

Serviços utilizados pelo Databricks Assistant

O Assistente Databricks usa os serviços do Azure OpenAI para fornecer respostas. O serviço Azure OpenAI é operado pela Microsoft, não pela OpenAI, e está sujeito às respetivas políticas de gestão de dados. Os dados enviados para este serviço não são utilizados para qualquer formação de modelo. Para o Azure OpenAI, o Azure Databricks optou por não participar do Monitoramento de Abuso, portanto, nenhum prompt ou resposta é armazenado com o Azure OpenAI. Para obter detalhes, consulte Política de gerenciamento de dados do Azure.

Dicas para melhorar a precisão dos resultados retornados

• Seja o mais específico possível. Especifique tabelas e exemplos da aparência dos dados.
• O Databricks Assistant sabe sobre seu esquema e metadados de tabela e coluna. Isso permite que você use linguagem natural e gere consultas bastante precisas. Por exemplo, se sua tabela tiver colunas userID e State, você pode pedir ao Databricks Assistant para gerar uma lista de usuários que moram em Washington.
• O Assistente de Databricks tem acesso apenas a metadados de tabela e coluna e não tem acesso a dados de nível de linha. Assim, ele pode não escrever consultas corretamente se os dados reais tiverem formas exclusivas. Por exemplo, se você tiver uma coluna Pricee cada valor acrescentar uma denominação de país (por exemplo, $10.99 USD, $5.99 CAD), a consulta retornada pode ter problemas para somar essa coluna, pois não é uma DECIMAL. Tente fornecer instruções específicas ao Databricks Assistant para analisar essa coluna. Por exemplo: "Soma a receita total das bolachas. Preço é uma coluna de cadeia de caracteres que tem uma denominação de país anexada a cada valor de moeda como '$10.99 USD'".

O Databricks Assistant considera o histórico da conversa para que você possa refinar suas perguntas à medida que avança.

Enviar comentários

A melhor maneira de enviar comentários é usar os links "Fornecer feedback" no bloco de anotações e no editor SQL. Também pode enviar um e-mail para assistant-feedback@databricks.com ou para a sua equipa de conta.

Estamos interessados principalmente em ouvir sobre sugestões de melhoria do produto e problemas de experiência do usuário, em vez de precisão imediata. Se receber uma sugestão inútil do Assistente, clique no botão "Não útil" para nos permitir capturar esse feedback.

Privacidade e segurança

P: Que dados estão a ser enviados para os modelos?

O Databricks Assistant envia código e metadados para os modelos em cada solicitação de API. Isso ajuda a retornar resultados mais relevantes para seus dados. Exemplos incluem:

• Código/consultas na célula atual do bloco de anotações ou na guia Editor SQL
• Nomes e descrições de tabelas e colunas
• Perguntas anteriores
• Mesas favoritas

P: Os metadados enviados para os modelos respeitam as permissões do Catálogo Unity do usuário?

Sim, todos os dados enviados para o modelo respeitam as permissões do Unity Catalog do usuário, portanto, ele não envia metadados relacionados a tabelas que o usuário não tem permissão para ver.

P: Se eu executar uma consulta com resultados e, em seguida, fizer uma pergunta, os resultados da minha consulta serão enviados para o modelo?

Não, apenas o conteúdo do código nas células, metadados sobre tabelas e o texto inserido pelo usuário são compartilhados com o modelo. Para o recurso "corrigir erro", o Databricks também compartilha o rastreamento de pilha da saída do erro.

P: O Databricks Assistant executará código perigoso?

N.º O Databricks Assistant não executa código automaticamente em seu nome. Os modelos de IA podem cometer erros, entender mal a intenção e alucinar ou dar respostas incorretas. Certifique-se de revisar o código gerado pela IA antes de executá-lo.

P: A Databricks fez alguma avaliação para avaliar a precisão e adequação das respostas do Assistente?

Sim. O Databricks tem mitigações para evitar que o Assistente gere respostas prejudiciais, como discurso de ódio, código inseguro, jailbreaks imediatos e conteúdo de direitos autorais de terceiros. A Databricks fez testes extensivos de todos os nossos recursos de assistência de IA com milhares de entradas de usuário simuladas para avaliar a robustez das mitigações. Essas avaliações se concentraram nos casos de uso esperados para o Assistente, como geração de código nas linguagens Python, Databricks SQL, R e Scala.

P: Posso usar o Databricks Assistant com tabelas que processam dados regulamentados (PHI, PCI, IRAP, FedRAMP)?

Sim. Para fazer isso, você deve cumprir requisitos, como habilitar o perfil de segurança de conformidade, e adicionar o padrão de conformidade relevante como parte da configuração do perfil de segurança de conformidade.