Aller au contenu

04 — Première requête — SQL en langage naturel via ADEN

Durée : 5 min  ·  Persona : alice (ou tout persona avec accès ADEN)  ·  Voie : A ou B

ADEN est la surface de requêtes en langage naturel d'AKKO. Vous tapez une question en français/anglais, ADEN propose un plan SQL, l'exécute via le moteur de requête gouverné, et retourne une table de résultats plus une suggestion de dashboard optionnelle.

Pré-requis

  • Vous avez terminé le chapitre 03 et savez vous connecter.
  • Le catalogue banking est injecté (par défaut sur la démo live et après bash helm/scripts/seed-demos.sh en local).

Étape 1 — Se connecter en tant qu'alice

Ouvrez DEMO_HOST. Connectez-vous avec alice / alice123.

Résultat attendu : la Home du cockpit charge avec le badge akko-admin.

Étape 2 — Ouvrir ADEN

Cliquez sur ADEN dans la sidebar. L'en-tête de la page lit ADEN — Ask, Discover, ENrich.

Vous voyez :

  • Un champ Topic.
  • Un chip Scope affichant le scope data courant (par défaut : banking_curated).
  • Un chip Model affichant le LLM qui rédigera le SQL (par défaut : qwen-coder-7b).
  • Un panneau History à droite.

État vide ADEN

Étape 3 — Poser votre première question

Tapez :

list 5 fraudulent transactions

Cliquez sur Generate.

Résultat attendu : en 5 à 15 secondes vous voyez quatre panneaux :

Panneau Contenu
Generated SQL Un plan SELECT … FROM banking_curated.fact_transactions WHERE is_fraud = TRUE LIMIT 5.
Trust bar Score de match semantic layer, scope chip, modèle utilisé, notes de rédaction.
Result table 5 lignes de transactions frauduleuses avec id, montant, marchand, timestamp.
Suggested dashboard Un bouton « Apply suggested dashboard ».

Résultat ADEN

Pourquoi une trust bar ? ADEN ne renvoie jamais un résultat sans vous dire quel scope, quels termes sémantiques et quel modèle l'ont produit. Vous pouvez auditer chaque étape.

Étape 4 — Inspecter le SQL

Cliquez sur Show SQL dans le panneau Generated SQL. Le plan complet se déplie.

Vous pouvez :

  • Copier le SQL en un clic (icône presse-papier).
  • L'ouvrir dans le SQL Lab (surface BI) pour l'éditer.
  • L'enregistrer dans vos Saved Queries personnels.

Résultat attendu : le SQL est valide, préfixé par le catalogue choisi, et respecte les filtres de lignes de votre scope. Pour alice (admin) aucune ligne n'est masquée.

Essayez la même requête en tant que carol et regardez apparaître une clause WHERE region = 'EU' — c'est le filtre de ligne du scope de carol. Voir chapitre 07.

Étape 5 — Appliquer le dashboard suggéré

Cliquez sur Apply suggested dashboard.

ADEN :

  1. Crée un nouveau dashboard BI nommé « Fraudulent transactions — top 5 ».
  2. Ajoute trois charts : une tuile chiffre (count), un bar chart (top marchands), un line chart (tendance 24h).
  3. Ouvre le dashboard dans la surface BI.

Résultat attendu : vous arrivez sur le nouveau dashboard. Les trois charts s'affichent en moins de 3 secondes.

Dashboard suggestion ADEN

Étape 6 — Sauvegarder et partager

Dans l'en-tête du dashboard BI :

  • Cliquez sur Save → le dashboard est ajouté à My dashboards.
  • Cliquez sur Share → copiez le lien.

Carol (ou tout analyste) ouvre le lien, se connecte et voit le même dashboard avec ses propres filtres de lignes appliqués.

Résultat attendu : le lien de partage est DEMO_HOST/bi/dashboards/<id> et passe par le fournisseur d'identité.

Ce qu'ADEN vous protège

  • Noms de tables hallucinés — ADEN refuse d'appeler une table qui n'existe pas dans votre scope.
  • Drift de schéma — quand une colonne est renommée, la prochaine suggestion utilise le nouveau nom.
  • Fuites de permissions — le SQL tourne avec votre identité, pas un compte de service. Les filtres ligne/colonne s'appliquent côté serveur.

Pourquoi c'est important. Une interface en langage naturel sans gouvernance est un risque. ADEN lie chaque requête à votre identité et à votre scope.

Dépannage

Symptôme Cause probable Fix
« No catalogs in scope » Aucun catalogue mappé à votre scope Suivre le chapitre 06 pour en ajouter un.
Le SQL généré référence une table inconnue Semantic layer non injecté Lancer bash helm/scripts/seed-demos.sh (local).
La requête prend > 30 sec Modèle + moteur à froid Attendre 30 sec et retenter — second run < 3 sec.
Suggestion de dashboard 500 Surface BI dégradée Vérifier l'entrée Alerts dans la sidebar.
Carol voit moins de lignes qu'alice Filtre de ligne de son scope Attendu — voir chapitre 07.

Ce que vous venez d'apprendre

  • ADEN transforme du français courant en SQL gouverné en moins de 15 secondes.
  • Chaque résultat est traçable : scope, modèle, termes sémantiques.
  • Un seul clic promeut une requête en dashboard partageable.

Suivant : 05 — Premier dashboard (surface BI).