Conceitos de Genie Agents
Genie Agents é um recurso do Databricks que permite que as equipes de negócios interajam com seus dados usando linguagem natural. Especialistas no domínio configuram os Genie Agents com datasets, queries de amostra e diretrizes de texto para ajudar o Genie a traduzir perguntas comerciais em queries analíticas. Após a configuração, os usuários corporativos podem fazer perguntas e gerar visualizações para entender os dados operacionais. Para obter **informação** adicional sobre os recursos de **AI** da **Databricks AI**, consulte recursos assistivos de **AI** da **Databricks AI**.
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 query SQL equivalente. Ele responde com a query 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.
Caso de uso de exemplo
Um gerente de vendas quer entender qual foi 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 o Genie Agents funciona
Genie Agents usam um sistema composto de IA para interpretar questões de negócios e gerar respostas. Em vez de usar um único modelo de linguagem grande, sistemas compostos de IA processam tarefas em aplicativos de IA combinando vários componentes que interagem entre si. Sistemas compostos de IA são um padrão de design cada vez mais comum para aplicativos de IA devido ao seu desempenho e flexibilidade. Para mais informação, consulte A Mudança de Modelos para Sistemas Compostos de IA.
Principais conceitos
Conceito | Descrição |
|---|---|
Repositório de conhecimento | 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 no nível do agente, sinônimos, relacionamentos de join, 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 | Observações de texto simples que informam ao Genie como interpretar seus dados e responder a perguntas. As instruções podem descrever regras de negócios, terminologia preferida, formatos de data e outros contextos específicos do domínio. Consulte Fornecer 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 | Queries de exemplo 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 desta lógica verificada. Consulte Revisar 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 são apenas para avaliação — o Genie não usa perguntas ou SQL de benchmark para melhorar seu contexto. Consulte benchmarks. |
Modo agente | Um modo de raciocínio em várias etapas que realiza uma análise mais aprofundada em seus dados. O modo Agente divide perguntas complexas em subtarefas, executa várias queries SQL e retorna um relatório estruturado com descobertas e visualizações. Veja o modo Agente em Genie Agents. |
Quais dados posso usar?
Um Genie Agent baseia-se em dados registrados no Unity Catalog, incluindo tabelas gerenciadas, tabelas externas, tabelas estrangeiras, views, views de métricas e views materializadas. O Genie utiliza os metadados anexados aos objetos do Unity Catalog, bem como um repositório de conhecimento em nível de agente curado pelo autor, para gerar respostas. Datasets bem anotados, juntamente com instruções específicas que o senhor fornece, são fundamentais para criar uma experiência positiva para os usuários finais.
O Genie funciona apenas com dados estruturados . Não é possível 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 Bate-papo no Genie, que pode se conectar a fontes de documentos externas, como Google Drive ou SharePoint.
Como os Genie Agents geram 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. Os detalhes fornecidos pelos autores, combinados com comentários relevantes do Unity Catalog, metadados e valores de amostra de colunas selecionadas, permitem que o Genie infira a lógica de negócios e técnica. O Genie filtra de forma inteligente exemplos de queries SQL, metadados de tabelas e colunas, e histórico de chat para selecionar o contexto mais relevante para responder à solicitação.
O Genie gera respostas usando os seguintes componentes:
Componente | Descrição |
|---|---|
Metadados de tabela do Unity Catalog | Nomes de tabela, descrições e relacionamentos de chave primária (PK) e chave estrangeira (FK) definidos. O Genie usa esses dados para converter prompts de linguagem natural em SQL. |
Nomes e descrições das colunas | Genie filtra inteligentemente por nomes e descrições de colunas relevantes. |
Contexto do Knowledge store | Metadados específicos do agente que os autores adicionam localmente, incluindo valores de coluna relevantes para a geração de query. Não altera os metadados existentes do Unity Catalog. Consulte Crie um armazenamento de conhecimento. |
Exemplos de queries SQL | O Genie seleciona inteligentemente exemplos de SQL relevantes de **Queries SQL**. |
Funções SQL | Todas as funções SQL que foram adicionadas ao agente. |
Instruções | Observações de texto simples fornecidas como Instruções Gerais . |
Histórico de prompts e respostas | Instruções e respostas do chat atual. Se necessário, devido aos limites de token definidos, as partes mais antigas do registro de chat são excluídas. |
Alguns detalhes da tabela, como o proprietário e o tamanho da tabela, não são incluídos por default. Para acessar esta informação, use as views do esquema de informações 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, o Genie gera uma query SQL que é executada no SQL warehouse do agente. Queries geradas são sempre somente leitura. As repetições são tratadas automaticamente, e o SQL warehouse lida com a simultaneidade e a escala. Para detalhes sobre como o Genie mantém a segurança e a privacidade, consulte confiança e segurança dos recursos de assistência da Databricks AI.
Melhorar a precisão da resposta usando Inspecionar
Visualização
Este recurso está em Pré-visualização Pública.
Inspecionar usa raciocínio avançado para revisar e melhorar a precisão das queries SQL geradas pelo Genie. Ao ativar Inspecionar para uma resposta, o Genie:
-
Revisa a query SQL gerada inicialmente.
-
Elabora instruções SQL menores para verificar aspectos específicos da query, como:
- Confirmando que os valores de filtro corretos estão incluídos.
- Validando a lógica do intervalo de datas, como janelas de 7 dias anteriores.
- Verificando condições de join e agregações.
-
Identifica lacunas ou problemas potenciais na query original.
-
Se problemas forem identificados, gera uma query SQL aprimorada que os resolve.
-
Realiza uma comparação final entre as queries originais e aprimoradas.
-
Retorna a query que responde com mais precisão à sua pergunta.
Use o Inspetor quando desejar confiança adicional na precisão da query, especialmente para queries complexas envolvendo filtros, intervalos de datas ou várias tabelas.
Suporte a idiomas
É possível usar Genie Agents em outros idiomas além do 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 preferência. As respostas do Genie podem, às vezes, aparecer em inglês devido aos prompts do sistema subjacente.
Como o acesso a dados funciona
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 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, aplique a segurança em nível de linha às tabelas subjacentes no Unity Catalog. Consulte Filtros de linha e máscaras de coluna.
Para informações sobre como configurar permissões de usuário para um Genie Agent, consulte Compartilhar um Genie Agent. Para perguntas frequentes sobre privacidade e segurança, consulte Perguntas frequentes sobre privacidade e segurança.
Próximos passos
- Para criar um Genie Agent e configurar dados e configurações, consulte Criar e gerenciar um Genie Agent.
- Para adicionar instruções, queries de exemplo e um armazenamento de conhecimento para melhorar a qualidade da resposta, consulte Ajustar a qualidade do Genie Agent.
- Para fazer perguntas e explorar dados como usuário de negócios, consulte Usar um Genie Agent para explorar dados de negócios.
- Para integrar o Genie em aplicativos e estruturas de agente, consulte Usar a API do Genie Agents.
- Para entender os preços do Genie e definir orçamentos para monitorar e controlar os gastos, consulte Gerenciar orçamentos e controle de custos para o Genie.