Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O agente de dados do Fabric permite que você faça perguntas em linguagem natural sobre dados SQL no OneLake — Lakehouse, Data Warehouse, Fabric SQL Database e Mirrored Databases — e receba respostas controladas e somente leitura. Nos bastidores, o agente usa uma ferramenta nativa para SQL (NL2SQL) embutida para traduzir cada pergunta em uma consulta T-SQL, validá-la contra o esquema selecionado e executá-la pelo endpoint de análise SQL da fonte.
Este artigo descreve as duas ferramentas de geração de consulta que o agente pode usar para fontes SQL:
- NL2SQL — a ferramenta GA (geralmente disponível), usada por agentes de dados no runtime padrão.
- NL2SQL avançado — uma ferramenta de visualização com raciocínio de várias etapas, usada por agentes de dados no runtime de visualização.
Ambas as ferramentas se baseiam na mesma configuração que você fornece para cada fonte do SQL – seleção de esquema, instruções de fonte de dados e consultas de exemplo. Para obter detalhes sobre como configurar essas entradas, consulte Adicionar e configurar fontes de dados em Fabric agente de dados.
NL2SQL
NL2SQL é a ferramenta de geração de consulta padrão para fontes SQL e é a ferramenta usada por agentes de dados no runtime padrão. Ele gera uma consulta T-SQL em uma única passagem:
- Ele lê o esquema selecionado e as instruções da fonte de dados fornecidas.
- Ele recupera as principais consultas de exemplo que são mais semelhantes à pergunta do usuário, usando a similaridade de vetor em sua biblioteca de consultas de exemplo.
- Ele gera uma consulta SQL com base nesse contexto, valida-a em relação ao esquema aprovado e a executa por meio do endpoint de análise de SQL.
O NL2SQL é otimizado para um comportamento estável e previsível e é a opção recomendada para agentes de dados de produção, em que a saída consistente entre as versões é importante. Para obter detalhes sobre a seleção de esquema, instruções de fonte de dados e consultas de exemplo que alimentam NL2SQL, consulte Adicionar e configurar fontes de dados no agente de dados Fabric.
NL2SQL avançado (versão prévia)
O NL2SQL avançado é uma nova versão da ferramenta NL2SQL, disponível no runtime de prévia. É a mesma ferramenta — linguagem natural para SQL sobre suas fontes SQL — com uma diferença fundamental: em vez de gerar a consulta em uma única passagem, ela planeja e executa várias etapas de raciocínio antes de retornar a consulta. Por exemplo, ele pode inspecionar o esquema, escolher exemplos relevantes, resolver valores de filtro ambíguos ou fazer uma pergunta esclarecedora antes de se comprometer com uma consulta.
O Advanced NL2SQL oferece melhorias de qualidade e experiências de configuração que não estão disponíveis no NL2SQL:
- Consultas de exemplo a seguir de forma mais consistente. O NL2SQL nem sempre segue suas consultas de exemplo de perto e, às vezes, adiciona lógica ou restrições que não estavam nos exemplos. O NL2SQL avançado adere mais de perto aos padrões demonstrados em sua biblioteca de consultas de exemplo.
- Substituindo valores de filtro corretamente. Quando uma pergunta implica vários filtros categóricos ou booleanos, em vez de declará-los explicitamente, o NL2SQL pode deixar de considerar alguns deles ou aplicá-los incorretamente. O NL2SQL avançado explica os filtros implícitos e substitui os valores certos na consulta.
- Lidar com perguntas ambíguas. Quando uma pergunta é ambígua, NL2SQL tende a se comprometer com uma suposição e gerar uma consulta de qualquer maneira. O NL2SQL avançado pode detectar a ambiguidade e fazer ao usuário uma pergunta esclarecedora antes de gerar o SQL, reduzindo respostas incorretas causadas por intenção mal lida.
- Entende detalhes do esquema. Nomes de objetos sozinhos podem não explicar o significado dos elementos de esquema, e instruções de fonte de dados podem não ter espaço suficiente para descrever todos os objetos. Ao usar descrições de objetos de esquema, os criadores podem fornecer contexto para tabelas individuais, colunas e outros elementos de esquema para que o Advanced NL2SQL possa interpretar o esquema e gerar consultas mais precisas.
O Advanced NL2SQL usa a seleção de esquema, instruções da fonte de dados e consultas de exemplo que você já configurou para o NL2SQL. Também pode usar configurações disponíveis apenas em Advanced NL2SQL, como descrições de objetos de esquema.
Usar NL2SQL Avançado
O NL2SQL avançado faz parte do ambiente de execução de pré-visualização. Para usá-lo, mude seu agente de dados para o ambiente de execução da versão prévia. Consulte runtime do agente de dados do Fabric para saber como alternar entre runtimes e o que mais muda quando você faz isso.
Como o ADVANCED NL2SQL está em versão prévia, seu comportamento pode mudar entre versões. Use-o para avaliar as melhorias futuras e fazer comentários antes de se formarem em GA; para agentes de dados de produção que precisam de uma saída consistente, mantenha-se no runtime padrão com NL2SQL.