Pular para o conteúdo principal
Última atualização em

Criar e gerenciar um Genie Agent

Crie, compartilhe e gerencie um Genie Agent, a interface de chat em linguagem natural que os usuários de negócios usam para fazer perguntas sobre seus dados no Databricks. Analistas de dados configuram cada agente com Unity Catalog, exemplos de queries SQL, instruções e ativos confiáveis; os usuários de negócios o consultam por meio da IU de chat.

nota

Genie Agents eram anteriormente conhecidos como Genie Spaces.

Requisitos e limites técnicos​

Os seguintes requisitos e limites se aplicam ao usar Genie Agents:

  • Unity Catalog: Os dados para o Genie Agent devem ser registrados no Unity Catalog. Você pode adicionar até 30 tabelas ou views a um Genie Agent.
  • Compute: os Genie Agents exigem um SQL warehouse Pro ou serverless. Ao criar ou configurar um Genie Agent, é preciso ter pelo menos a permissão CAN USE no warehouse selecionado. Suas credenciais de compute estão incorporadas no Genie Agent e são usadas para processar todas as queries para todos os usuários.
  • Capacidade: Cada Genie Agent pode suportar até 10.000 conversas, e cada conversa pode incluir até 10.000 mensagens.

Permissões necessárias​

Para criar ou editar um Genie Agent, você deve ter as seguintes permissões e direitos:

  • Direitos: O senhor deve ter o direito Databricks SQL workspace . Ver gerenciar direitos.
  • computar: Acesso CAN USE em pelo menos um profissional ou serverless SQL warehouse.
  • Acesso a dados: privilégios SELECT nos dados usados no agente.
  • ACLs do Genie Agent: no mínimo permissões CAN EDIT no Genie Agent. Os criadores de Genie Agent têm automaticamente permissões CAN MANAGE nos agentes que criam. Consulte ACLs do Genie Agent.
nota

A configuração dos dados e o acesso a compute exigem permissões elevadas, geralmente restritas a um administrador. Consulte Criar um SQL warehouse e gerenciar privilégios em Unity Catalog.

gerenciar Genie access​

Genie usa recursos AI com tecnologia de parceiros, que devem ser habilitados nos níveis account e workspace . Para saber como gerenciar esses recursos para sua account, consulte o recurso AI com tecnologia de parceiros.

nota

Você deve ser um administrador de account para gerenciar o acesso a este recurso. Se você desabilitar os recursos de AI impulsionados por parceiros, os usuários com direito ao Databricks SQL ainda poderão clicar no ícone Genie Agents na barra lateral, mas não conseguirão acessar nenhum Genie Agent.

Criar um Genie Agent​

Para criar um Genie Agent:

  1. Clique em Genie Agents na barra lateral.
  2. Clique em Novo no canto superior direito da tela.
  3. Escolha as fontes de dados que você deseja incluir no seu Genie Agent. Em seguida, clique em Criar .

A caixa de diálogo de conexão de dados com a fonte de dados selecionada.

Configurar um agente com o Genie Code​

Ao criar um agente, Genie Code é iniciado automaticamente. Ele lê seus dados e sugere um contexto que ajuda o Genie a responder a perguntas com precisão, como descrições de suas tabelas e exemplos de queries. Analise as sugestões e aceite as que você deseja manter. Para preencher uma lacuna específica, descreva o contexto que o Genie Code deve adicionar.

prompt

Peça ao Genie Code para fazer isso para você:

Create a Genie agent for our sales team that answers questions about weekly revenue, units sold, and returns by store and region. Use the sales and store tables in the retail catalog.

Também é possível solicitar ao Genie Code que crie um agente quando as tabelas a serem usadas ainda não forem conhecidas. Descreva o domínio de negócios, as perguntas que se deseja que o agente responda e os dados que ele deve usar. O Genie Code identifica dados relevantes, confirma as fontes e cria o agente com o mesmo contexto inicial.

Antes de compartilhar o agente com os usuários, o Databricks recomenda adicionar exemplos de consultas SQL, instruções e configurações de base de conhecimento para melhorar a precisão da resposta. Consulte Ajustar a Qualidade do Genie Agent.

Revise as sugestões de consulta​

Para saber mais sobre os dados do agente, o Genie acessa informação no workspace para entender melhor as relações entre as tabelas e a semântica do negócio. Ao adicionar ativos de dados a um agente, o Genie busca automaticamente por queries populares relevantes do workspace associadas a esses ativos. As credenciais de usuário são usadas para encontrar queries relevantes para as quais há pelo menos permissões de CAN VIEW. Se a busca retornar queries, uma notificação aparece na tab **Dados** do painel **Instruções**. Clique em **Revisar** para ver as queries sugeridas.

Para obter mais informações sobre permissões de acesso a consultas, consulte ACLs de consultas.

Notificação de revisão de queries sugeridas.

Use a caixa de diálogo Revisar queries sugeridas para revisar, editar, aceitar ou rejeitar as queries sugeridas. Outros usuários com pelo menos acesso CAN EDIT no Genie Agent podem revisar queries, desde que tenham pelo menos acesso CAN VIEW na própria query.

Caixa de diálogo de revisão de anotar de queries sugeridas. As seções numeradas explicam como trabalhar com as queries sugeridas.

  1. O texto do título vem pré-preenchido com uma pergunta. Revise ou edite a pergunta digitando no campo Título .
  2. O campo Code (Código ) contém o texto completo da consulta SQL sugerida. Esse campo não é editável. Para view a consulta completa, clique em ... mais linhas .
  3. Se o senhor tiver permissões suficientes para a consulta, poderá clicar em SQL query para abrir a consulta na UI da história da consulta . Veja o histórico da consulta de visualização.
  4. Depois de determinar se a query é relevante para seu agente, clique em Aceitar ou Rejeitar para adicioná-la ao seu agente ou descartar a sugestão, respectivamente.
  5. Clique nas outras sugestões para expandir e revisar.

As queries aceitas aparecem no contexto de queries SQL para o agente. Depois de adicionadas ao agente, as queries sugeridas e as perguntas associadas são totalmente editáveis. Veja Adicionar exemplos de queries SQL e funções.

Se nenhuma consulta sugerida for retornada:

  • Talvez você não tenha acesso suficiente às consultas relevantes.
  • Talvez não haja dados relevantes. Se as consultas não tiverem sido executadas em suas tabelas incluídas, a pesquisa poderá não retornar resultados.
  • Queries irrelevantes para o Genie Agent não são consideradas. Por exemplo, queries que executam apenas operações básicas de gravação nos ativos incluídos não são consideradas exemplos relevantes para o Genie.
  • O Genie não sugere queries em tabelas que não são adicionadas ao Agent. Se foram criadas tabelas ou views unidas especificamente para o Genie Agent, mas queries relevantes do Databricks SQL são geralmente executadas em uma tabela de origem diferente, o Genie não retorna essas queries nos resultados.

gerenciar objetos de dados​

Para gerenciar quais objetos de dados estão incluídos em um Genie Agent, clique em Configurar > Dados . Clique no botão Adicionar para adicionar mais tabelas. Clique no Ícone de lixo. à direita do nome da tabela para remover uma tabela do agente.

Para view detalhes sobre um objeto de dados, clique no nome do objeto. A view do objeto de dados mostra duas abas:

  • Visão geral : Exibe as colunas no objeto de dados, incluindo nomes de colunas, tipos de dados e descrições.
  • Dados de exemplo : Exibe dados de exemplo da tabela para ajudar você a entender o contexto e o conteúdo dos dados.
nota

O Genie pode consultar tabelas além daquelas explicitamente adicionadas a um Agent. O acesso é controlado por permissões do Unity Catalog, e não pelo próprio Genie Agent. Embora o Genie utilize as tabelas e views anexadas por default, os usuários podem consultar outras tabelas solicitando joins ou editando o SQL diretamente. Da mesma forma, se as instruções ou metadados fizerem referência a tabelas fora do agente, o Genie poderá incluí-los em consultas geradas.

Definir configurações​

Personalize seu Genie Agent configurando configurações adicionais. Clique em Configurar > Configurações para acessar as seguintes configurações:

  • Título : O título aparece no navegador do workspace com outros objetos do workspace. Escolha um título que ajude os usuários finais a descobrir seu Genie Agent.
  • Default warehouse : Este recurso de compute alimenta as instruções SQL geradas no Genie Agent. Quando você salva uma seleção de warehouse, suas credenciais de compute são incorporadas ao Genie Agent e usadas para processar todas as queries do Genie para todos os usuários. Você deve ter pelo menos permissões CAN EDIT no agente para mudar o warehouse. Se um autor diferente mudar o warehouse mais tarde, suas credenciais de compute serão incorporadas. Um Genie Agent pode usar um SQL warehouse profissional ou serverless. Para um desempenho ideal, o Databricks recomenda o uso de um SQL warehouse serverless.
  • Tags : use tags para organizar e categorizar os Genie Agents para um gerenciamento mais fácil. Consulte Adicionar tags.
  • Miniatura : Adicione uma imagem em miniatura ao Genie Agent. Miniaturas aparecem na página de chat inicial do Genie Agent e no Genie One.
  • Descrição: Os usuários veem a descrição quando abrem o Genie Agent. Use esta área de texto para descrever a finalidade do agente. O campo de descrição oferece suporte à formatação Markdown para que você possa estilizar seu texto e fornecer links para contexto e referências úteis. Para obter mais informações sobre a sintaxe Markdown, consulte a folha de dicas do Guia Markdown.
  • Perguntas comuns : As perguntas comuns são exemplos opcionais dos tipos de perguntas que os usuários podem fazer. Eles aparecem na página de aterrissagem do chat do agente e podem ser adicionados durante a criação ou posteriormente nas Configurações do agente. As perguntas comuns definidas pelo autor têm prioridade e aparecem primeiro. Quando se fornecem perguntas comuns suficientes para preencher a página de aterrissagem do chat, apenas as suas perguntas aparecem. Quando se fornecem menos, o Genie preenche os slots restantes com perguntas geradas automaticamente.

Espere iterar em seu Genie Agent com base em testes e uso. Para obter orientações sobre as melhores práticas para criar e iterar em um agente, consulte Organizar um Genie Agent eficaz.

Adicionar tags​

Você deve ter pelo menos permissões de CAN EDIT em um Genie Agent para adicionar uma tag. Para adicionar uma tag governada, você também deve ter a permissão de ASSIGN na tag governada. Para obter mais informações sobre tags, consulte Aplicar tags a objetos protegíveis do Unity Catalog.

info

Visualização

Esse recurso está em Public Preview.

  1. Clique em Configurar > Configurações .

  2. Clique em Geral .

  3. Em tags , adicione ou atualize uma tag:

    • Se não houver tags, clique no botão Adicionar tags .
    • Se houver tags, clique em Ícone de edição Ícone Adicionar/Editar tags .

  4. Selecione uma chave tag existente e um valor ou insira o nome de uma nova tag.

    • As tags que são governadas estão no cabeçalho da seção Governado e têm um ícone de cadeadoÍcone de cadeado..
    • chave de tag são necessárias. Se um valor tag é necessário depende da key tag .

Compartilhe um Genie Agent​

nota

Os Genie Agents usam credenciais de compute incorporadas do autor que configurou o warehouse. Todas as consultas são executadas usando essas credenciais de compute incorporadas. No entanto, os usuários finais do agente têm suas próprias credenciais de dados aplicadas nas consultas, assim, eles veem apenas os dados que deveriam ver. Qualquer pergunta sobre dados aos quais não podem acessar gera uma resposta vazia.

Para restringir os dados que cada usuário pode ver no mesmo Genie Agent, aplique segurança em nível de linha às tabelas subjacentes no Unity Catalog. Os filtros de linha e as máscaras de coluna definidos no Unity Catalog são aplicados por usuário automaticamente, independentemente de como o Genie Agent é compartilhado. Consulte Filtros de linha e máscaras de coluna.

Ao compartilhar um Genie Agent, os usuários devem ter as seguintes permissões para interagir com o agente:

  • Direitos: O acesso do consumidor ou Databricks SQL workspace entitlement. Ver gerenciar direitos.
  • Computação: Execução de consultas usando as credenciais compute incorporadas pelo autor que configurou o data warehouse. Os usuários finais não precisam de permissões diretas de armazenamento.
  • Acesso a dados: Pelo menos SELECT privilégios em todos os objetos de dados do Unity Catalog usados no agente. Os usuários só veem os dados aos quais têm permissão para acessar.
  • ACLs do Genie Agent: Pelo menos permissões de CAN VIEW/CAN RUN no Genie Agent. Consulte ACLs do Genie Agent.

Novos Genie Agents são salvos na sua pasta de usuário por padrão. Assim como outros objetos de workspace, eles herdam as permissões da pasta que os contém. É possível usar a estrutura de pastas do seu workspace para compartilhá-las com outros usuários. Consulte navegador do Workspace.

Você também pode especificar determinados usuários ou grupos (incluindo todos os usuários account ) para compartilhar em um determinado nível de permissão: CAN MANAGE, CAN EDIT, CAN RUN e CAN VIEW.

Para compartilhar com usuários ou grupos específicos:

  1. Clique em Compartilhar .
  2. Insira os usuários ou grupos com os quais deseja compartilhar o agente. Em seguida, clique em Adicionar e defina os níveis de permissão apropriados. Usuários individuais e membros de pequenos grupos recebem uma notificação por email confirmando que o agente foi compartilhado.
  3. Use o botão **Copiar link** na parte inferior da caixa de diálogo Compartilhar para obter um link compartilhável para o Genie Agent. Usuários privilegiados podem clicar no link para abrir o Genie Agent em uma nova tab e fazer perguntas.

Para compartilhar com todos os usuários account :

  1. Clique em Compartilhar .
  2. Selecione Todos os usuários account .
  3. Defina o nível de permissão apropriado.

Os usuários do agente também podem compartilhar conversas individuais. Consulte Compartilhar uma conversa.

Para compartilhar um Genie Agent com usuários fora da sua organização usando OpenSharing, consulte Compartilhar um Genie Agent usando OpenSharing.

Clonar um Genie Agent​

A clonagem de um Genie Agent cria uma cópia que inclui todo o contexto de configuração e as instruções. A clonagem é útil quando se deseja testar mudanças em um agente separado ou reutilizar o contexto original em um novo. Após a clonagem de um agente, o novo agente é independente do original. É possível fazer edições e ajustes sem impactar o original.

Os seguintes elementos são copiados para um Genie Agent clonado:

  • Tabelas e configurações
  • Instruções gerais
  • Exemplo de consultas SQL
  • Funções SQL

Tópicos de bate-papo existentes e dados da guia Monitorar não são copiados para o novo agente.

Para clonar um Genie Agent, faça o seguinte:

  1. Abra o Genie Agent que você deseja clonar.
  2. Clique no Ícone do menu Kebab. menu kebab no canto superior direito do agente.
  3. Clique em Clonar .
  4. (Opcional) Na caixa de diálogo Clonar , especifique um novo nome e local da pasta do workspace para o Genie Agent clonado.
  5. Clique em **Clonar** para criar o novo agente.

Exportar um Genie Agent como uma view de métrica​

É possível exportar o contexto de um Genie Agent como uma view de métricas. Isto cria uma view de métricas com base nos dados e no contexto semântico configurados no Agent.

Para exportar um Genie Agent como uma view de métricas, faça o seguinte:

  1. Abra o Genie Agent que você deseja exportar.
  2. Clique no Ícone do menu Kebab. menu kebab no canto superior direito do agente.
  3. Selecione Exportar para viewde métricas .
  4. Selecione o caminho para a nova view de métricas.
  5. (Opcional) Clique em Ícone do Genie Code com brilho. no canto superior direito da página para abrir o Genie Code e refinar a definição da view de métricas.
  6. Clique em Criar .

Recurso adicional​

Nesta página