Ajouter des instructions personnalisées à une rubrique

S’applique à : édition Enterprise

Public cible : administrateurs et auteurs d'Amazon Quick

Les instructions personnalisées sont des règles de langage naturel persistantes qui guident le moteur d'IA dans l'interprétation de la terminologie spécifique à un domaine et de la logique interensembles de données. Sans eux, le moteur interprète les termes littéralement. Par exemple, « cette année » correspond par défaut à l'année civile. Toutefois, si votre organisation fonctionne au cours d'un exercice financier commençant le 1er avril, vous avez besoin d'une instruction pour modifier cette valeur par défaut.

Les instructions personnalisées sont particulièrement utiles pour :

• Règles de désambiguïsation. Lorsque le même terme commercial peut correspondre à plusieurs ensembles de données ou champs, indiquez à l'IA lequel préférer. Par exemple : « Lorsque l'utilisateur pose des questions sur les « ventes », utilisez SALES_FACT. Lorsque l'utilisateur pose des questions sur les « retours » ou les « remboursements », utilisez RETURNS_FACT. »

• Cross-dataset définitions. Définissez des mesures qui couvrent plusieurs ensembles de données. Par exemple : « Revenu net = SOMME (VENTES_ FACT.total _montant) - SOMME (RETURNS_ _amountFACT.refund) ».

• Comportement de jointure par défaut. Spécifiez la direction de jointure qui préserve la sémantique voulue. Par exemple : « Préférez LEFT JOIN des tables de faits aux tables de dimensions afin que les informations ne correspondant pas aux enregistrements de dimensions ne soient pas supprimées silencieusement. »

• Logique de date personnalisée. Par exemple : « L'année fiscale commence le 1er avril. Interprétez « cette année » en utilisant les limites de l'année fiscale. »

Pour ajouter des instructions personnalisées

1. Ouvrez la rubrique que vous souhaitez configurer.

2. Accédez à l'onglet Instructions personnalisées.

3. Choisissez Modifier.

4. Entrez vos instructions sous forme de règles de langage naturel. Utilisez le style à puces pour plus de clarté.

5. Sélectionnez Enregistrer les modifications.

Exemples d'instructions personnalisées

L'exemple suivant présente un ensemble d'instructions thématiques prêtes à être mises en production pour un sujet d'analyse du commerce de détail :

Disambiguation:
- "sales", "revenue", "orders" -> use SALES_FACT
- "returns", "refunds" -> use RETURNS_FACT
- "net sales", "net revenue" -> join SALES_FACT LEFT JOIN RETURNS_FACT on order_line_id

Cross-dataset metrics:
- Net Revenue = SUM(SALES_FACT.total_amount) - SUM(RETURNS_FACT.refund_amount)
- Return Rate = COUNT(RETURNS_FACT.return_id) / COUNT(SALES_FACT.order_line_id)

Default joins:
- SALES_FACT LEFT JOIN CUSTOMER_DIM on customer_id
- SALES_FACT LEFT JOIN PRODUCT_DIM on product_id

Date handling:
- Fiscal year starts April 1. Interpret "this year" using fiscal year boundaries.
- YTD: current fiscal year up to and including today.

Meilleures pratiques pour les instructions personnalisées

• Gardez les instructions concises. Préférez les listes de règles à puces aux paragraphes en prose.

• Utilisez les instructions au niveau de la rubrique pour la logique entre ensembles de données uniquement. Single-datasetla sémantique (grain, clés, règles d'agrégation) fait partie des métadonnées d'enrichissement propres à l'ensemble de données.

• Évitez les contradictions entre les instructions au niveau de l'ensemble de données et celles au niveau du sujet.

• Testez vos instructions en posant des questions dans le chat et en consultant le code SQL généré dans le panneau d'explication.