O que é o Assistente do Databricks?

O Databricks Assistant é um programador de pares e agente de suporte baseado em IA que o torna mais eficiente à medida que cria blocos de notas, consultas, dashboards 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. Para perguntas sobre privacidade e segurança, consulte Privacidade e segurança.

Azure AI Services vs recursos baseados em Databricks

O Databricks Assistant é uma coleção de recursos orientados por IA que aumentam a produtividade para uma ampla variedade de tarefas.

Alguns recursos do Assistente são os Serviços de IA do Azure, o que significa que eles dependem de modelos não atendidos pelo Databricks. A tabela a seguir descreve os recursos do Assistente e o provedor de modelo para cada recurso.

Funcionalidade Assistente	Descrição das funcionalidades	Provedor de modelo
Assistente de bate-papo	Um painel de bate-papo de IA disponível em todo o produto para ajudar com várias tarefas.	Serviços de IA do Azure
Solicitações de ações da célula assistente	Transformações em linguagem natural do código em uma única célula.	Serviços de IA do Azure
Assistente de preenchimento automático baseado em IA (Visualização pública)	Sugestões de código embutido à medida que você digita.	Databricks

Para uma conta: Ativar ou desativar os recursos do Assistente do Databricks

Os recursos do Assistente de Databricks dos Serviços de IA do Azure são habilitados por padrão. No entanto, os administradores podem desativar os recursos do Assistente de Serviços do Azure AI para todos os espaços de trabalho em uma conta:

Gorjeta

O ato de habilitar ou desabilitar os recursos do Assistente de Databricks dos Serviços de IA do Azure para sua conta é capturado como um evento de conta em seus logs de auditoria, consulte Eventos de conta.

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. Para a opção Recursos de assistência de IA baseados em serviços de IA do Azure, selecione Ativado ou Desativado.

Para um utilizador: Ativar ou desativar as funcionalidades do Assistente

Todos os usuários, incluindo não administradores, podem habilitar ou desabilitar os recursos do Assistente para seu perfil de usuário nas configurações do desenvolvedor :

1. Clique no seu nome de utilizador na barra superior das Definições da área de trabalho >Databricks.
2. Em Usuário, clique na guia Desenvolvedor .
3. Em Recursos experimentais, use alternâncias para o preenchimento automático do Databricks Assistant e o Novo Assistente.

Obtenha ajuda de codificação do Databricks Assistant

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 pode abrir no lado esquerdo ou direito do ecrã.

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 a ser executado em 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 usa informações de recursos do Databricks, como o site de documentação do Databricks ou a Base de Conhecimento, para responder melhor às consultas do usuário. 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 de executá-lo, porque às vezes ele pode cometer erros.

Criar visualizações de dados usando o Assistente Databricks

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 obter detalhes, consulte Política de gerenciamento de dados do Azure.

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.

Dicas para melhorar a precisão dos resultados

• Use o prompt "Encontrar tabelas" para obter melhores respostas. Antes de fazer perguntas sobre dados em uma tabela, peça ao Assistente para encontrar tabelas relacionadas por assunto ou outras características. Exemplo: Find tables related to NFL games.

• Especifique a estrutura da resposta desejada. A estrutura e os detalhes que o Databricks Assistant fornece variam, mesmo para o mesmo prompt. O Databricks Assistant conhece o esquema e os metadados da sua tabela e coluna, para que possa utilizar linguagem natural para colocar a sua questão. Exemplo: List active and retired NFL quarterbacks' passing completion rate, for those who had over 500 attempts in a season. o assistente responde usando dados de colunas como s.player_id e s.attempts.

• Forneça exemplos de seus valores de dados em nível de linha. O Databricks Assistant não tem acesso a dados em nível de linha, portanto, para obter respostas mais precisas, forneça exemplos dos dados. Exemplo: List the average height for each position in inches. Isso retorna um erro porque o conjunto de dados mostra a altura em pés e polegadas, como em 6-2.

• Teste trechos de código executando-os no painel Assistente. Use o painel Assistente como um bloco de rascunho que salva iterações de suas consultas e respostas do assistente. Você pode executar o código e editá-lo no painel até estar pronto para adicioná-lo a um bloco de anotações.

  

• Use ações de célula em um bloco de anotações. As ações da célula incluem atalhos para tarefas comuns, como documentar (comentar), corrigir e explicar código.

  

Para exemplos totalmente ilustrados, consulte 5 dicas para o Databricks Assistant.

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

Qual é o preço do Databricks Assistant?

Todos os recursos atuais do Databricks Assistant estão disponíveis sem custo adicional para todos os clientes.

Os usuários pagam apenas pela computação que usam para executar seus blocos de anotações, consultas, trabalhos e assim por diante. Existem limites de utilização justos em vigor para evitar abusos. A maioria dos usuários não é afetada por esses limites.

Enviar comentários

A melhor maneira de enviar comentários é usar os links Fornecer Comentários 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.

Compartilhe sugestões de melhoria de produtos e problemas de experiência do usuário em vez de comentários sobre a precisão imediata. Se receber uma sugestão inútil do Assistente, clique no botão "Não útil".

Disponibilidade geográfica dos recursos do Assistente

O Databricks Assistant é um Serviço Designado que usa o Geos para gerenciar a residência de dados ao processar o conteúdo do cliente. Para saber mais sobre a disponibilidade dos recursos do Assistente em diferentes áreas geográficas, consulte Serviços designados do Databricks.

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. Revise e teste o código gerado por 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.