Conceitos de Genie Agents
Genie Agents é um recurso do Databricks que permite que equipes de negócios interajam com seus dados usando linguagem natural. Especialistas no domínio configuram os Genie Agents com datasets, consultas de amostra e diretrizes de texto para ajudar o Genie a traduzir perguntas de negócios em consultas analíticas. Após a configuração, os usuários corporativos podem fazer perguntas e gerar visualizações para entender os dados operacionais. Para informações adicionais sobre recursos com tecnologia de AI do Databricks, consulte recursos de assistência com AI do Databricks.
Os Genie Agents eram anteriormente conhecidos como Genie Spaces.
O Genie seleciona nomes e descrições relevantes de tabelas e colunas anotadas para converter perguntas em linguagem natural em uma consulta SQL equivalente. Ele responde com a consulta gerada e a tabela de resultados, se possível. Se o Genie não conseguir gerar uma resposta, ele pode fazer perguntas de acompanhamento para esclarecer antes de fornecer uma resposta.
Exemplo de caso de uso
Um gerente de vendas deseja entender qual o produto mais vendido ao longo do tempo em sua padaria. Eles podem interagir com o Genie Agent usando linguagem natural e gerar automaticamente uma visualização.
O gif a seguir mostra essa interação:
Como os Genie Agents funcionam
Genie Agents usam um sistema de AI composto para interpretar questões de negócios e gerar respostas. Em vez de usar um único modelo de linguagem grande, sistemas de IA compostos processam tarefa em aplicações de AI combinando múltiplos componentes interativos. Sistemas de IA compostos são um padrão de design cada vez mais comum para aplicações de IA devido ao seu desempenho e flexibilidade. Para mais informações, consulte A Mudança de Modelos para Sistemas de IA Compostos.
Conceitos fundamentais
Conceito | Descrição |
|---|---|
Knowledge Store | Uma coleção de definições semânticas selecionadas que aprimora a compreensão do Genie sobre seus dados. O repositório de conhecimento inclui descrições de tabelas e colunas em nível de agente, sinônimos, relações de junção, expressões SQL e configurações de correspondência de prompt. As configurações do repositório de conhecimento são restritas ao agente e não afetam os metadados do Unity Catalog. Consulte Criar um repositório de conhecimento. |
Instruções | Notas de texto simples que dizem ao Genie como interpretar seus dados e responder a perguntas. Instruções podem descrever regras de negócios, terminologia preferencial, formatos de data e outros contextos específicos do domínio. Consulte Apresentar instruções. |
Exemplos de queries SQL | Queries SQL que servem como respostas de referência para perguntas comuns. Genie seleciona inteligentemente exemplos relevantes da biblioteca de queries do agente para gerar respostas mais precisas. Consulte Adicionar exemplos de queries e funções SQL. |
Ativos confiáveis | Exemplos de queries parametrizadas e funções SQL cuja lógica exata foi verificada por um autor de agente. Quando o Genie usa um ativo confiável para gerar uma resposta, a resposta vem dessa lógica verificada. Veja Revise uma resposta. |
Benchmarks | Um conjunto de perguntas de teste usado para avaliar e medir a precisão da resposta do Genie Agent. Ao contrário das instruções, os benchmarks servem apenas para avaliação — o Genie não usa perguntas de benchmark ou SQL para melhorar seu contexto. Consulte Benchmarks. |
Modo Agente | Um modo de raciocínio de várias etapas que realiza uma análise mais profunda de seus dados. O Modo Agente divide perguntas complexas em subtarefas, executa várias consultas SQL e retorna um relatório estruturado com descobertas e visualizações. Consulte Modo Agente no Genie Agents. |
Quais dados posso usar?
Um Genie Agent é baseado em dados registrados no Unity Catalog, incluindo tabelas gerenciadas, tabelas externas, tabelas estrangeiras, views, views de métricas e views materializadas. O Genie usa os metadados anexados aos objetos do Unity Catalog, bem como um armazenamento de conhecimento de nível de agente curado pelo autor, para gerar respostas. Datasets bem anotados, combinados com instruções específicas fornecidas, são essenciais para criar uma experiência positiva para os usuários finais.
O Genie só funciona com dados estruturados . Não pode responder a perguntas sobre dados não estruturados, como PDFs, documentos do Word ou outro conteúdo baseado em arquivo. Para dar ao Genie acesso a documentos não estruturados, use o Chat no Genie, que pode se conectar a fontes de documentos externas como Google Drive ou SharePoint.
Como o Genie Agents gera uma resposta
Quando um usuário envia uma pergunta, o Genie analisa a solicitação, identifica fontes de dados relevantes e determina como gerar uma resposta apropriada. Detalhes fornecidos pelos autores, combinados com comentários relevantes do Unity Catalog, metadados e valores de amostra de colunas selecionadas, permitem ao Genie inferir tanto a lógica de negócios quanto a técnica. Genie filtra inteligentemente queries SQL de exemplo, metadados de tabela e coluna e histórico de chat para selecionar o contexto mais relevante para responder à solicitação.
O Genie gera respostas utilizando os seguintes componentes:
Componente | Descrição |
|---|---|
Metadados de tabela do Unity Catalog | Nomes de tabelas, descrições e relacionamentos definidos de chave primária (PK) e chave estrangeira (FK). O Genie utiliza esses dados para converter solicitações de linguagem natural em SQL. |
Nomes e descrições da coluna | O Genie filtra inteligentemente nomes e descrições de colunas relevantes. |
Contexto de Knowledge Store | Metadados específicos do agente que os autores adicionam localmente, incluindo valores de coluna relevantes para a geração de consultas. Não altera metadados existentes do Unity Catalog. Consulte Crie um armazenamento de conhecimento. |
Exemplos de queries SQL | Genie seleciona inteligentemente exemplos relevantes de queries SQL. |
Funções SQL | Todas as funções SQL que foram adicionadas ao Agent. |
Instruções | Notas de texto simples fornecidas como **Instruções gerais**. |
Histórico de instruções e respostas | Prompts e respostas do chat atual. Se necessário, devido aos limites de tokens definidos, as partes mais antigas do registro do chat são excluídas. |
Alguns detalhes da tabela, como o proprietário e o tamanho da tabela, não estão incluídos por default. Para acessar esta informação, use as views do esquema de informação disponíveis para todos os catálogos do Unity Catalog. Para obter mais informações sobre o que está disponível no esquema de informações, consulte Esquema de informações.
Na maioria dos casos, Genie gera uma consulta SQL que é executada no SQL warehouse do agente. Consultas geradas são sempre somente leitura. As novas tentativas são tratadas automaticamente, e o SQL warehouse gerencia a simultaneidade e a escala. Para obter detalhes sobre como o Genie mantém a segurança e a privacidade, consulte Confiança e segurança dos recursos assistivos de IA do Databricks.
Melhore a precisão da resposta usando o Inspect
Visualização
Esse recurso está em Prévia Pública.
O recurso Inspecionar utiliza raciocínio avançado para revisar e aprimorar a precisão das queries SQL geradas pelo Genie. Ao ativar a Inspeção para uma resposta, o Genie:
-
Revisa a consulta SQL gerada inicialmente.
-
Cria instruções SQL menores para verificar aspectos específicos da consulta, tais como:
- Verificar se os valores de filtro corretos estão incluídos.
- Validação da lógica de intervalo de datas, como janelas móveis de 7 dias.
- Verificando condições de join e agregações
-
Identifica lacunas ou possíveis problemas na consulta original.
-
Se forem identificados problemas, é gerada uma Query SQL aprimorada que os resolve.
-
Realiza uma comparação final entre as consultas originais e aprimoradas.
-
Retorna a query que responde com mais precisão à sua pergunta.
Use o Inspect quando desejar mais confiança na precisão da consulta, especialmente para consultas complexas que envolvam filtros, intervalos de datas ou várias tabelas.
Suporte a idiomas
Você pode usar o Genie Agents em idiomas que não sejam o inglês, como português e francês. No entanto, a estrutura de agente subjacente envolve os prompts em inglês.
A Databricks recomenda que os criadores de agentes adicionem o máximo de metadados possível em seu idioma de escolha. As respostas do Genie podem, às vezes, aparecer em inglês devido aos prompts de sistema subjacentes.
Como funciona o acesso a dados
O acesso a dados em um Genie Agent é regido pelo Unity Catalog. Quando um usuário faz uma pergunta, a query SQL gerada é executada nos dados usando as credenciais de compute incorporadas pelo autor do agente (o SQL warehouse configurado). As permissões de uso de dados do Unity Catalog de cada usuário são aplicadas aos resultados da query. Os usuários só veem os dados que estão autorizados a acessar. Qualquer pergunta sobre dados que eles não podem acessar retorna uma resposta vazia.
Isso significa:
- Não é necessário conceder permissões diretas de warehouse aos usuários.
- Filtros de linha e máscaras de coluna definidos no Unity Catalog são aplicados automaticamente por usuário.
- Para implementar a filtragem de dados por usuário, aplicar segurança em nível de linha às tabelas subjacentes no Unity Catalog. Consulte Filtros de linhas e máscaras de colunas.
Para informações sobre como configurar permissões de usuário para um Genie Agent, consulte Compartilhe um Genie Agent. Para perguntas frequentes sobre privacidade e segurança, consulte Perguntas frequentes sobre privacidade e segurança.
Passos seguintes
- Para criar um Genie Agent e configurar dados e configurações, consulte Criar e gerenciar um Genie Agent.
- Para adicionar instruções, exemplos de queries e um armazenamento de conhecimento para melhorar a qualidade das respostas, consulte Otimizar a qualidade do Genie Agent.
- Para fazer perguntas e explorar dados como um usuário de negócios, consulte Usar um Genie Agent para explorar dados de negócios.
- Para integrar o Genie em aplicativos e frameworks de agente, consulte Usar a API dos Genie Agents.
- Para entender os preços do Genie e definir orçamentos para monitorar e controlar os gastos, consulte Gerenciar orçamentos e controles de custos para o Genie.