Utilisez les sujets dans un agent de données Fabric (aperçu)

En utilisant des sujets, vous pouvez fournir de grandes instructions basées sur des sujets qui aident un agent de données Fabric à générer SQL. Au lieu d’envoyer tout le contenu du sujet avec chaque question, l’agent de données recherche le contenu et fournit à l’outil NL2SQL uniquement les parties pertinentes pour la question.

Utilisez les sujets lorsque vous disposez d’un large éventail de conseils que vous pouvez organiser par matière. Par exemple, vous pouvez créer des sections pour les ventes, les stocks et la fidélisation des clients, puis fournir les définitions d’entreprise et les conseils de requête applicables à chaque sujet.

Note

Les rubriques sont en préversion et sont disponibles uniquement pour les sources de données SQL avec le runtime en préversion.

Sujets et instructions de source de données

Les sujets et les instructions de source de données fournissent différents types de contexte aux outils de génération de requêtes :

Configuration Comment l’agent de données l’utilise Quand l′utiliser ?
Rubriques L’agent de données recherche le contenu du sujet et envoie les sections concernées à NL2SQL. Utilisez pour de grandes instructions que vous pouvez diviser en matières et que vous n’avez besoin que lorsqu’une question concerne un sujet.
Instructions de source de données L’agent de données envoie les instructions à l’outil de génération de requêtes à chaque utilisation de la source de données. Utilisez-le pour les règles et le contexte qui doivent s’appliquer à chaque question envoyée à la source de données.

Par exemple, mettez une définition de l’exercice à l’échelle de l’organisation dans les instructions de la source de données si chaque requête doit l’utiliser. Mettez des directives détaillées pour calculer la rétention client dans un sujet de rétention si ces conseils ne sont nécessaires que pour des questions sur la rétention.

Vous pouvez utiliser ensemble des rubriques et des instructions relatives aux sources de données. Lorsqu’une question nécessite les deux, NL2SQL reçoit les instructions de la source de données ainsi que le contenu pertinent du sujet.

Ajouter des instructions basées sur le sujet

Vous pouvez ajouter jusqu’à 1 million de caractères de contenu thématique à chaque source de données SQL prise en charge.

  1. Ouvrez votre agent de données Fabric et sélectionnez une source de données SQL.

  2. Dans la configuration de la source de données, ouvrez Data source topics.

  3. Saisissez vos instructions basées sur le sujet. Utilisez des titres Markdown pour organiser le contenu en sujets distincts.

  4. Sauvegardez la configuration de l’agent de données.

  5. Des questions d’examen qui correspondent à des sujets individuels et des questions nécessitant plus d’un sujet.

    Capture d’écran de l’éditeur de sujets de source de données montrant les instructions du sujet Markdown et un plan.

Structure du contenu du sujet

Utilisez des titres descriptifs Markdown afin que l’agent de données puisse trouver la section correcte pour une question. Gardez toutes les consignes pour une matière sous le titre correspondant.

## 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.

Lorsqu’un utilisateur demande des informations sur le churn, l’agent de données peut récupérer les directives de rétention client sans envoyer les directives d’inventaire non liées à NL2SQL.

Consultez les sujets récupérés dans run steps

Après avoir testé une question, consultez l’étape de course Open Data Source Topic pour voir quel contenu thématique l’agent de données a choisi. Le champ de saisie affiche le chemin d’accès du titre et la raison pour laquelle le sujet a été sélectionné. La sortie affiche les instructions fournies à NL2SQL.

Capture d’écran de l’étape d’exécution Open Data Source Topic montrant le chemin de titre sélectionné et les instructions récupérées.

Bonnes pratiques

  • Utilisez des titres correspondant aux termes utilisés par les gens dans leurs questions.
  • Veillez à ce que chaque sujet soit indépendant. Incluez les définitions métier pertinentes, tableaux, colonnes, relations, filtres et règles de calcul sous le même titre thématique.
  • Utilisez des sous-titres pour séparer des scénarios liés au sein d’un sujet large.
  • Mettez des règles qui doivent s’appliquer à chaque question SQL dans les instructions de la source de données au lieu de les répéter dans plusieurs sujets.
  • Évitez de dupliquer les consignes ou de les rendre contradictoires d’une rubrique à l’autre et dans les instructions relatives aux sources de données.
  • Testez les questions directes, les formulations alternatives et les questions qui nécessitent du contenu issu de plusieurs sujets.

Contenu connexe

  • Last updated on