saearch-v3 / docs /demo_script.md
xia
docs: refonte complete v1.1 + glossaire/demo/faq + corrections
b0ea9c4
|
Raw History Blame Contribute Delete
8.67 kB

Script de démo soutenance — SAEARCH / DooMax

Scénario pas-à-pas pour la soutenance, avec les questions exactes à taper, les outils attendus en réponse, et les points à commenter à voix haute. Durée totale visée : ~15-20 min.


Préparation (avant de commencer)

  • HF Spaces ouvert dans un onglet : https://xbizot-saearch.hf.space
  • Connecté avec un compte (demo@saearch.ai / demo ou ton compte perso)
  • docs/architecture_pour_slides.md ouvert dans un autre onglet ou en PDF
  • SAEARCH_architecture.html ouvert en parallèle (double-clic local) si tu veux montrer le diagramme
  • Dashboard MLflow lancé en parallèle si possible : mlflow ui --backend-store-uri sqlite:///mlflow.db --port 5000
  • Volume audio activé pour le STT/TTS
  • Une question vocale préparée mentalement

Plan de démo (10 séquences)

1. Présentation rapide de l'UI (1 min)

À montrer : page d'accueil après login.

À commenter :

  • Sidebar à gauche : multi-conversations, persistées en SQLite
  • Donut central qui visualise les outils appelés (vide pour l'instant)
  • Footer noir : tokens, coût USD, version du prompt
  • Géoloc auto-détectée (ex : "Houplines, Hauts-de-France")

2. Chat simple en français (1 min)

À taper :

Bonjour, qui es-tu ?

Réponse attendue : DooMax se présente (jamais "Claude"), explique son rôle, propose ses capacités. Aucun outil appelé (donut reste vide).

À commenter :

  • Le prompt système l'oblige à dire "DooMax", jamais "Claude"
  • Vouvoiement par défaut
  • Le routeur a tranché "chat" en quelques millisecondes (pas d'appel LLM de classification, juste keywords)

3. RAG sur le corpus GIEC (2 min)

À taper :

Que dit le GIEC sur l'intensification des inondations en Europe méditerranéenne ?

Réponse attendue :

  • L'agent appelle search_corpus
  • Réponse synthétique avec citations [Source: IPCC_AR6_WGII_SummaryForPolicymakers.pdf, Page: X]
  • Donut affiche le segment "RAG"

À commenter :

  • Pipeline hybride BM25 + Dense + reranking CrossEncoder
  • Bridge lexical FR↔EN : la question en français a retrouvé des passages dans des PDFs en anglais
  • Diversité forcée : maximum 3 chunks par PDF, pour éviter qu'un seul document monopolise la réponse

4. Question multilingue (1 min, optionnel)

À taper (en anglais) :

What does the IPCC say about heat waves in Europe?

Ou en espagnol :

¿Qué dice el IPCC sobre las olas de calor en Europa?

Réponse attendue : Réponse intégralement dans la langue de la question, citations toujours présentes.

À commenter :

  • Embedding multilingue paraphrase-multilingual-MiniLM-L12-v2 (50+ langues)
  • Le prompt impose la cohérence linguistique stricte

5. Agent météo (1-2 min)

À taper :

Quel est le temps prévu à Marseille la semaine prochaine ?

Réponse attendue :

  • Appel get_forecast
  • Résumé jour par jour des températures, précipitations, vent
  • Donut affiche le segment "Météo"

À commenter :

  • API OpenMeteo, gratuite, sans clé
  • Géocodage automatique (ville → coordonnées)
  • Pattern ReAct : Reason ("c'est une question météo prévisionnelle") → Act (get_forecast) → Observe (JSON OpenMeteo) → Answer (synthèse en langage naturel)

6. Multi-outils chaînés (2 min)

À taper :

Quel temps fait-il à Paris aujourd'hui, et combien font 23.5 + 18.7 ?

Réponse attendue :

  • Appel get_weather (Paris) puis calculator (23.5 + 18.7)
  • Donut montre 2 segments différents allumés

À commenter :

  • L'agent enchaîne plusieurs outils en une seule requête
  • Le calculator passe par une sandbox AST (anti-injection)

7. ML prédictif (1 min)

À taper :

Quel est le risque catastrophe prédit au Bangladesh pour 2030 ?

Réponse attendue :

  • Appel predict_risk (ou predict_risk_by_type selon le détail)
  • Niveau de risque + impact humain moyen prédit
  • Citation du modèle (Quantile Regression EM-DAT)

À commenter :

  • Modèle entraîné sur EM-DAT décadal (1900-2020, 14 625 lignes)
  • Quantile Regression robuste aux outliers (sinon canicule France 2003 fausserait tout)
  • Clipping 1.5× max historique : empêche les prédictions extrêmes par extrapolation
  • Comparatif MLflow : 16 modèles testés, ce GBQR est le meilleur sur MAE_test

8. Scoring multi-sources (2 min, point fort)

À taper :

Calcule le score de risque inondation à Bangkok à horizon court terme

Réponse attendue :

  • L'agent enchaîne 4 outils : get_forecast + predict_risk + search_corpus + (historique)
  • Puis appelle calculer_score_risque
  • Score 0-1 + interprétation qualitative + sources

À commenter :

  • C'est l'outil emblématique : il croise 4 sources en une seule passe
  • Pondération dépendante de l'horizon : court_terme privilégie la météo, long_terme privilégie ML + corpus
  • Le donut affiche 5 segments allumés simultanément

9. Mode décisionnel + HITL (2 min)

À cliquer : un des 4 boutons d'action décisionnelle (par exemple "Événementiel"), puis suivre le dialogue guidé.

Réponse attendue :

  • Dialogue qui pose 2-3 questions (lieu, date, type d'événement)
  • Réponse finale avec recommandation GO / NO-GO
  • Guide de lecture intégré : DECISION = ... | HORIZON = ... | SCORE = ... | RISQUE = ... | CONFIANCE = ...
  • Boutons d'action : Approuver / Enrichir / Rejeter

À commenter :

  • Boucle Human-in-the-Loop : aucun système ne décide seul d'annuler un événement
  • Toute décision finale est loggée dans MLflow comme feedback humain
  • Le guide de lecture rend la sortie auto-explicative — pas besoin de glossaire séparé pour comprendre

10. Multimodal (2 min)

Au choix selon le temps :

10a. Upload PDF

  • Glisser-déposer un PDF de ton choix dans le chat
  • Taper : Résume-moi ce document en 5 points
  • Commenter : indexation FAISS in-memory session-scoped → pas de pollution du corpus officiel

10b. Upload image

  • Glisser-déposer une image (carte météo, schéma, etc.)
  • Taper : Que vois-tu sur cette image ?
  • Commenter : Claude vision natif, pas d'OCR séparé

10c. STT (vocal)

  • Cliquer sur le micro, dire : "Quel temps fait-il à Lyon ?" (ou en anglais/espagnol pour montrer l'autodétection)
  • Commenter : Faster-Whisper en local, sans API tierce, autodétection de langue

10d. TTS (lecture vocale)

  • Sur n'importe quelle réponse, cliquer le bouton 🔊 en bas à gauche
  • Commenter : Web Speech API du navigateur, gratuit, instantané

Bonus si temps restant

MCP via Claude Desktop

Si tu as configuré le tunnel Cloudflare avant la soutenance :

  • Ouvre Claude Desktop sur ta machine
  • Montre les 11 outils SAEARCH disponibles
  • Demande à Claude Desktop : "Cherche dans le corpus SAEARCH ce que disent les rapports sur les feux de forêt en Europe"
  • Commenter : pas de duplication de code, mêmes fonctions @tool partagées entre Chainlit et MCP

Dashboard MLflow

Si tu as lancé MLflow UI :

  • Onglet rag-catastrophes-climatiques → un run par requête
  • Filtrer par prompt_version v1.0 vs v2.0 pour montrer l'A/B testing
  • Onglet Model Registry : versions NB10_regression v1+, NB10_classification v1+

Conclusion (1 min)

Points à clore :

  • Architecture complète disponible dans docs/architecture.md, slides dans docs/architecture_pour_slides.md
  • Diagramme interactif consultable séparément (SAEARCH_architecture.html)
  • 25 décisions techniques justifiées dans docs/decisions.md
  • Code et image disponibles : GitHub, Docker Hub, AWS ECR, HF Spaces

Phrase de clôture suggérée :

"Le projet combine 4 capacités — RAG scientifique, agents à outils, ML prédictif, aide à la décision humaine — sur les fondations posées par toute l'équipe en P1, P2 et P3. Toutes les décisions techniques sont justifiées et reproductibles via les workflows CI/CD."


Erreurs probables et plans B

Si... Plan B
L'API Anthropic timeout / 429 Le fallback Haiku s'active automatiquement → continuer la démo, juste mentionner que la résilience marche
HF Spaces lent / timeout Lancer une démo en local en backup (port 8090)
Une question RAG ne trouve rien Reformuler avec un terme plus spécifique (GIEC au lieu de IPCC)
Le STT ne détecte pas le micro Vérifier autorisation navigateur, sinon skip et passer au suivant
Le diagramme HTML ne s'ouvre pas Ouvrir directement le fichier en double-clic depuis l'explorateur