Use tópicos em um agente de dados Fabric (prévia)

Ao usar tópicos, você pode fornecer instruções grandes baseadas em tópicos que ajudam um agente de dados Fabric a gerar SQL. Em vez de enviar todo o conteúdo do tópico com cada pergunta, o agente de dados pesquisa o conteúdo e fornece à ferramenta NL2SQL apenas as partes relevantes para a pergunta.

Use tópicos quando você tiver um grande conjunto de orientações que possa organizar por matéria. Por exemplo, você pode criar seções para vendas, estoque e retenção de clientes, e então fornecer as definições de negócios e orientações de consulta que se aplicam a cada assunto.

Note

Os tópicos estão em versão preliminar e disponíveis apenas para fontes de dados SQL no ambiente de execução de versão preliminar.

Tópicos e instruções sobre fontes de dados

Tópicos e instruções de fontes de dados fornecem diferentes tipos de contexto para ferramentas de geração de consultas:

Configuration Como o agente de dados o utiliza Quando utilizá-lo
Tópicos O agente de dados pesquisa o conteúdo do tema e envia as seções relevantes para o NL2SQL. Use instruções grandes que você pode dividir em assuntos e que você só precisa quando uma pergunta estiver relacionada a um assunto.
Instruções da fonte de dados O agente de dados envia as instruções para a ferramenta de geração de consultas toda vez que utiliza a fonte de dados. Use para definir regras e contexto que devem ser aplicados a cada pergunta enviada à fonte de dados.

Por exemplo, coloque uma definição de ano fiscal para toda a organização nas instruções da fonte de dados se toda consulta precisar usá-la. Coloque orientações detalhadas para calcular a retenção de clientes em um tópico sobre retenção de clientes se a orientação for necessária apenas para perguntas sobre retenção.

Você pode usar tópicos e instruções da fonte de dados em conjunto. Quando uma pergunta exige ambos, o NL2SQL recebe as instruções da fonte de dados e o conteúdo relevante do tema.

Adicionar instruções baseadas em tópicos

Você pode adicionar até 1 milhão de caracteres de conteúdo de tópico a cada fonte de dados SQL suportada.

  1. Abra seu agente de dados Fabric e selecione uma fonte de dados SQL.

  2. Na configuração da fonte de dados, abra Tópicos da fonte de dados.

  3. Insira suas instruções baseadas em tópicos. Use títulos Markdown para organizar o conteúdo em assuntos distintos.

  4. Salve a configuração do agente de dados.

  5. Questões de teste que correspondem a tópicos individuais e perguntas que exigem mais de um tópico.

    Captura de tela do editor de tópicos de fonte de dados mostrando instruções de tópicos Markdown e um esboço completo.

Estruture o conteúdo do tópico

Use títulos Markdown descritivos para que o agente de dados possa encontrar a seção correta para uma pergunta. Mantenha todas as orientações de um assunto sob o título correspondente.

## Customer retention

Use the CustomerSubscription table for retention questions.

### Retained customers

A customer is retained when IsActive is 1 and RenewalDate is after the reporting date.

### Churn rate

Calculate churn rate as the number of subscriptions canceled during the period divided by the number of active subscriptions at the start of the period.

## Inventory

Use the InventorySnapshot table for current inventory questions.

### Low-stock products

A product is low in stock when QuantityOnHand is less than ReorderPoint.

Quando um usuário pergunta sobre churn, o agente de dados pode recuperar a orientação de retenção de clientes sem enviar a orientação de inventário não relacionada para o NL2SQL.

Revise os tópicos recuperados nas etapas da execução

Após testar uma pergunta, revise a etapa de execução Open Data Source Topic para ver qual conteúdo de tópico o agente de dados selecionou. O campo de entrada mostra o caminho do cabeçalho e o motivo pelo qual o tópico foi selecionado. A saída mostra as instruções fornecidas ao NL2SQL.

Captura de tela da etapa de execução do tópico da fonte de dados aberta mostrando o caminho do cabeçalho selecionado e as instruções recuperadas.

Práticas recomendadas

  • Use títulos que correspondam aos termos que as pessoas usam em suas perguntas.
  • Mantenha cada tema autossuficiente. Inclua as definições de negócio relevantes, tabelas, colunas, relacionamentos, filtros e regras de cálculo sob o mesmo título de tópico.
  • Use subtítulos para separar cenários relacionados dentro de um tema amplo.
  • Coloque regras que devem se aplicar a todas as perguntas de SQL nas instruções da fonte de dados, em vez de repeti-las em múltiplos tópicos.
  • Evite duplicar ou contradizer orientações entre tópicos e instruções de fontes de dados.
  • Teste perguntas diretas, frases alternativas e questões que exijam conteúdo de vários tópicos.

Conteúdo relacionado

  • Last updated on