saearch-v2 / 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 |