Conceitos de Genie Agents

O Genie Agents é um recurso Azure Databricks que permite que as equipes de negócios interajam com seus dados usando linguagem natural. Especialistas em domínio configuram o Genie Agents com conjuntos de dados, consultas de exemplo e diretrizes de texto para ajudar o Genie a traduzir perguntas de negócios em consultas analíticas. Após a instalação, os usuários empresariais podem fazer perguntas e gerar visualizações para entender os dados operacionais. Para obter informações adicionais sobre os recursos de IA do Azure Databricks, consulte os recursos de assistência de IA do Databricks.

Note

Os Agentes Genie eram anteriormente conhecidos como Genie Spaces.

O Genie seleciona nomes e descrições relevantes de tabelas e colunas anotadas para converter perguntas de linguagem natural em uma consulta SQL equivalente. Ele retorna a consulta gerada e a tabela de resultados, se possível. Se o Genie não puder gerar uma resposta, ele poderá fazer perguntas de acompanhamento para esclarecer antes de fornecer uma resposta.

Exemplo de caso de uso

Um gerente de vendas quer entender o produto mais vendido ao longo do tempo em sua padaria. Eles podem interagir com o Agente Genie usando linguagem natural e gerar automaticamente uma visualização.

O GIF a seguir mostra essa interação:

Gif com pergunta de exemplo, resposta e visualização gerada automaticamente

Como o Genie Agents funciona

Os Agentes do Genie usam um sistema de IA composto para interpretar perguntas comerciais e gerar respostas. Em vez de usar um único modelo de linguagem grande, os sistemas de IA compostos processam tarefas em aplicativos de IA combinando vários componentes de interação. Os 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 obter mais informações, consulte a mudança de modelos para sistemas de IA compostos.

Conceitos principais

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 colunas e tabelas no nível do agente, sinônimos, relacionamentos de junção, expressões SQL e configurações de correspondência de prompts. As configurações do repositório de conhecimento têm como escopo o agente e não afetam os metadados do Catálogo do Unity. Consulte Criar um repositório de conhecimento.
Instruções Notas de texto sem formatação que dizem ao Genie como interpretar seus dados e responder a perguntas. As instruções podem descrever regras de negócios, terminologia preferencial, formatos de data e outro contexto específico do domínio. Consulte Instruções de Fornecer.
Exemplo de consultas SQL Consultas SQL que servem como respostas de referência para perguntas comuns. O Genie seleciona de forma inteligente exemplos relevantes da biblioteca de consultas do agente para gerar respostas mais precisas. Consulte Adicionar consultas e funções SQL de exemplo.
Ativos confiáveis Consultas de exemplo parametrizadas e funções SQL cuja lógica exata foi verificada por um autor do agente. Quando o Genie usa um ativo confiável para gerar uma resposta, a resposta vem dessa lógica verificada. Consulte Revisar uma resposta.
Benchmarks Um conjunto de perguntas de teste usadas para avaliar e medir a precisão da resposta do Agente Genie. Ao contrário das instruções, os benchmarks são apenas para avaliação. O Genie não usa perguntas de benchmark nem SQL para melhorar seu contexto. Consulte Benchmarks.
Modo de agente Um modo de raciocínio de várias etapas que executa uma análise mais profunda em seus dados. O modo de agente divide perguntas complexas em subtarefas, executa várias consultas SQL e retorna um relatório estruturado com descobertas e visualizações. Consulte o modo Agente.

Quais dados posso usar?

Um Agente do Genie é baseado em dados registrados no Unity Catalog, incluindo tabelas gerenciadas, tabelas externas, tabelas forâneas, visualizações, visualizações de métricas e visualizações materializadas. O Genie usa os metadados anexados aos objetos do Unity Catalog, bem como um repositório de conhecimento em nível de agente selecionado pelo autor, para gerar respostas. Conjuntos de dados bem anotados, emparelhados com instruções específicas que você fornece, são fundamentais para criar uma experiência positiva para os usuários finais.

Note

No modo Chat, o Genie trabalha apenas com dados estruturados. Ele não pode responder perguntas sobre dados não estruturados, como PDFs, documentos Word ou outro conteúdo baseado em arquivo. Para consultar arquivos não estruturados armazenados em volumes do Catálogo Unity (Beta), use o modo Agente. Consulte Análise de arquivos em volumes com o Genie Agent. Para dar acesso ao Genie a documentos externos, use o Chat no Genie, que pode se conectar a fontes externas de documentos como Google Drive e 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. Os detalhes fornecidos pelos autores, combinados com comentários relevantes do Catálogo do Unity, metadados e valores de exemplo de colunas selecionadas, permitem que o Genie infera lógica técnica e comercial. O Genie filtra de forma inteligente exemplo de consultas SQL, metadados de tabela e coluna 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 da tabela do Catálogo do Unity Nomes de tabela, descrições e relações de chave primária definida (PK) e FK (chave estrangeira). O Genie usa esses dados para converter prompts de linguagem natural em SQL.
Nomes e descrições de colunas O Genie filtra de forma inteligente os nomes e descrições de coluna relevantes.
Contexto do repositório de conhecimento Metadados específicos do agente que os autores adicionam localmente, incluindo valores de coluna relevantes para a geração de consulta. Não altera os metadados existentes do Catálogo do Unity. Consulte Criar um repositório de conhecimento.
Exemplo de consultas SQL O Genie seleciona de forma inteligente exemplos de SQL relevantes de consultas SQL.
Funções do SQL Todas as funções SQL que foram adicionadas ao agente.
Instruções Notas em texto simples fornecidas como instruções gerais.
Histórico de prompts e respostas Prompts e respostas do chat atual. Se necessário, por causa das limitações de token definidas , as partes mais antigas do registro de chat serão excluídas.

Note

Alguns detalhes da tabela, como o proprietário e o tamanho da tabela, não são incluídos por padrão. Para acessar essas informações, use exibições 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 consulta SQL que é executada no SQL Warehouse do agente. As consultas geradas são sempre somente leitura. As novas tentativas são tratadas automaticamente e o SQL warehouse trata 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 da Databricks.

Melhorar a precisão da resposta usando Inspecionar

Importante

Esse recurso está em Visualização Pública.

Inspect usa o raciocínio avançado para revisar e melhorar a precisão das consultas SQL geradas pelo Genie. Ao habilitar a Inspeção para uma resposta, o Genie:

  1. Analisa a consulta SQL gerada inicialmente.
  2. Cria de instruções SQL menores para verificar aspectos específicos da consulta, como:
    • A confirmação dos valores de filtro corretos está incluída.
    • Validação da lógica do intervalo de datas, como janelas móveis de 7 dias.
    • Verificando as condições de junção e as agregações.
  3. Identifica lacunas ou possíveis problemas na consulta original.
  4. Se os problemas forem identificados, gerará uma consulta SQL aprimorada que os resolve.
  5. Executa uma comparação final entre as consultas originais e aprimoradas.
  6. Retorna a consulta que responde com maior precisão à sua pergunta.

Use Inspeção quando quiser mais confiança na precisão da consulta, especialmente para consultas complexas que envolvem filtros, intervalos de datas ou várias tabelas.

Modo de agente

O modo de agente permite que os usuários obtenham respostas para perguntas complexas e exploratórias em um agente do Genie usando o raciocínio em várias etapas e testes de hipóteses. Quando você faz uma pergunta, o modo Agent cria e refina um plano de pesquisa, executa várias consultas SQL, aprende com cada resultado e itera até que tenha evidências suficientes para fornecer um relatório abrangente com citações, visualizações e tabelas de suporte.

Note

O modo de agente era anteriormente conhecido como Agente de Pesquisa. Esta seção aborda o modo agente do Genie Agents. Para o modo Agent voltado para desenvolvedores que automatiza código, pipelines e dashboards, consulte Genie Code Agent mode.

Modo agente no GIF do Genie Agents.

Ao contrário das consultas padrão do Genie, modo agente:

  • Cria planos de pesquisa: desenvolve uma abordagem estruturada e hipóteses para responder a perguntas complexas.
  • Executa várias consultas: executa várias consultas SQL para coletar evidências de diferentes ângulos.
  • Aprende e itera: ajusta continuamente sua abordagem com base no que descobre, refinando seu raciocínio até que ele esteja confiante na resposta.
  • Fornece relatórios abrangentes: fornece resumos detalhados com citações, visualizações e tabelas de suporte.

O modo de agente também pode responder perguntas sobre os arquivos não estruturados nos volumes do Catálogo do Unity que um autor anexa ao agente. Consulte Análise de arquivos em volumes com o Genie Agent.

Você também pode rodar o modo Agente programaticamente através das APIs do modo Agente. Veja a referência da API do modo Agente.

Disponibilidade regional

Region Disponibilidade
Espaços de trabalho américas e europa Disponível (não requer múltiplas regiões geográficas)
Espaços de trabalho na Austrália, Nova Zelândia e Japão Disponível (não requer múltiplas regiões geográficas)
Todas as outras regiões Disponível somente se o cross-Geo estiver habilitado. Veja Habilitar o processamento entre áreas geográficas.

Suporte ao idioma

Você pode usar o Genie Agents em idiomas diferentes do inglês, como português e francês. No entanto, a estrutura subjacente do agente envolve prompts em inglês.

Azure Databricks recomenda que os criadores de agente adicionem o máximo de metadados possível em sua linguagem de escolha. Às vezes, as respostas do Genie podem aparecer em inglês devido aos prompts do sistema subjacentes.

Como funciona o acesso a dados

Um Agente Gênio usa duas credenciais separadas para responder a uma pergunta:

  • Acesso de computação: A consulta SQL gerada roda no SQL warehouse usando as credenciais de computação incorporadas pelo autor do agente. Os usuários finais não precisam de permissões diretas do warehouse.
  • Acesso a dados: O Unity Catalog avalia o acesso aos dados como identidade do usuário final, não do autor. Cada usuário vê apenas os dados autorizados a acessar, e cada consulta é atribuída ao usuário final no histórico de consultas e na página de monitoramento do agente.

Qualquer pergunta sobre dados que um usuário não pode acessar retorna uma resposta vazia.

Isso significa que:

  • Você não precisa conceder aos usuários permissões diretas no armazém de dados.
  • Filtros de linha e máscaras de coluna definidos no Catálogo do Unity são automaticamente impostos para cada usuário.
  • Para implementar a filtragem de dados por usuário, aplique a segurança em nível de linha às tabelas subjacentes no Catálogo do Unity. Veja Filtros de linha e máscaras de coluna.

Para obter informações sobre como configurar permissões de usuário para um agente do Genie, consulte Compartilhar um agente do Genie. Para perguntas frequentes sobre privacidade e segurança, consulte Dados enviados para os modelos.

Próximas Etapas 

  • Last updated on