Utilizar tópicos num agente de dados do Fabric (pré-visualização)

Ao usar tópicos, 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 questão.

Use os tópicos quando tiver um grande conjunto de orientações que possa organizar por disciplina. Por exemplo, pode criar secções para vendas, inventário e retenção de clientes, e depois fornecer as definições de negócio e orientações de consulta que se aplicam a cada assunto.

Note

Os tópicos estão em pré-visualização e só estão disponíveis para fontes de dados SQL no ambiente de execução de pré-visualização.

Tópicos e instruções para 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 secções relevantes para o NL2SQL. Use instruções grandes que possa dividir por assuntos e que só precise quando uma pergunta estiver relacionada com um assunto.
Instruções da fonte de dados O agente de dados envia as instruções para a ferramenta de geração de consultas sempre que utiliza a fonte de dados. Utilize para regras e contexto que se devem aplicar a todas as perguntas enviadas para a fonte de dados.

Por exemplo, coloque uma definição de ano fiscal a nível organizacional nas instruções da fonte de dados se todas as consultas tiverem de a utilizar. Coloque orientações detalhadas para calcular a retenção de clientes num tópico de retenção de clientes se a orientação for necessária apenas para questões sobre retenção.

Pode usar tópicos e instruções de origem de dados em conjunto. Quando uma pergunta requer 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

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

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

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

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

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

  5. Perguntas de teste que correspondem a tópicos individuais e perguntas que requerem mais do que um tema.

    Captura de ecrã do editor de tópicos da fonte de dados a mostrar instruções de tópicos Markdown e um esboço.

Estrutura do conteúdo do tema

Use títulos Markdown descritivos para que o agente de dados possa encontrar a secção correta para uma pergunta. Mantenha todas as orientações relativas a um assunto sob o cabeçalho 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 utilizador pergunta sobre o churn, o agente de dados pode obter 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 em run steps

Depois de testar uma pergunta, analise a etapa de execução Open Data Source Topic para ver que 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 ecrã do passo de execução Open Data Source Topic mostrando o caminho de cabeçalho selecionado e as instruções recuperadas.

Melhores práticas

  • Use títulos que correspondam aos termos que as pessoas usam nas suas perguntas.
  • Manter cada tópico independente. Inclua as definições de negócio relevantes, tabelas, colunas, relações, 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 tenham de se aplicar a todas as perguntas SQL nas instruções da fonte de dados em vez de as repetir em vários tópicos.
  • Evite duplicar ou contradizer orientações entre tópicos e instruções de fontes de dados.
  • Teste perguntas diretas, formulações alternativas e perguntas que exijam conteúdos de vários temas.

Conteúdo relacionado

  • Last updated on