Vocabulaire Apicole
BeePass integre un glossaire apicole centralise qui alimente deux systemes :
- Voice Agent : les termes sont injectes dans le keyword boosting de Deepgram (reconnaissance vocale amelioree) et dans le prompt d'extraction Claude Haiku
- Support IA (Oracle) : les termes enrichissent le contexte du chatbot RAG pour mieux comprendre le jargon apicole
La page de gestion du vocabulaire se trouve dans le backoffice a /backoffice/vocabulary.
Fonctionnement
Quand un eleveur dicte une evaluation vocalement ("B326 douceur 4 miel 28 kilos"), le systeme a besoin de comprendre que "B326" est une reine, "douceur" est un trait, et "4" est un score. Le vocabulaire apicole fournit cette connaissance :
- Reconnaissance : les termes et synonymes sont envoyes a Deepgram comme "keyword boost" — le moteur de reconnaissance vocale accorde une priorite plus elevee a ces mots
- Extraction : Claude Haiku recoit la liste complete des termes pour matcher les noms de reines, les traits et les valeurs
- Support : quand un eleveur ecrit "J'ai un probleme de varroa sur mes BF", Oracle comprend que "BF" = Buckfast et "varroa" = maladie parasitaire
Interface admin
Vue d'ensemble
La page affiche un tableau de tous les termes avec :
- Statistiques : nombre total de termes, nombre injectes en Voice, nombre injectes en Support
- Filtres : par categorie (race, trait, disease, equipment...) et recherche texte
- Actions : ajouter, modifier, supprimer, importer en masse (CSV)
Categories
Les termes sont organises en 9 categories :
| Categorie | Exemples | Usage |
|---|---|---|
race | Buckfast, Carnica, Mellifera | Reconnaissance des races d'abeilles |
trait | Douceur, Vigueur, Hivernage | Traits d'evaluation |
disease | Varroa, Loque americaine | Maladies et parasites |
equipment | Dadant, Langstroth, Nicot | Materiel apicole |
technique | Greffage, Insemination, Pin Test | Techniques d'elevage |
anatomy | Couvain, Cellule royale, Hausse | Anatomie de la ruche |
genetics | EBV, BLUP, SDI, F0, F1 | Genetique apicole |
queen_name | B326, CA-2024-001 | Noms de reines (auto-sync) |
product | BeePass, Passeport genetique | Termes produit |
Termes auto-synchronises
Les noms de reines F0 sont automatiquement synchronises depuis la table queens_f0. Quand vous ajoutez ou modifiez une reine, un terme est automatiquement cree ou mis a jour dans le vocabulaire avec :
- Terme : le numero de serie (serial_number)
- Synonymes : le nom de la reine (queen_name)
- Definition : "Reine B326 — Race : Buckfast — Eleveur : MP"
Ces termes sont marques avec un badge 🔒 dans l'interface et ne peuvent pas etre supprimes manuellement. Vous pouvez toutefois modifier les toggles voice/RAG.
Toggles Voice et RAG
Chaque terme a deux toggles :
- 🎤 Saisie vocale (
boost_voice) : si active, le terme est injecte dans le keyword boosting Deepgram et dans le prompt d'extraction - 🎫 Support IA (
boost_rag) : si active, le terme est inclus dans le glossaire envoye au chatbot Oracle et au support RAG
Par defaut, les deux sont actives. Vous pouvez les desactiver individuellement — par exemple, un terme tres technique comme "BLUPF90" est utile en support mais pas forcement en reconnaissance vocale.
Import CSV
Vous pouvez importer des termes en masse via un fichier CSV. Le format attendu :
category,term,synonyms,definition,context
race,Buckfast,buck|BF|buckfast,Race hybride creee par Frere Adam,L'eleveur dit : la B326 c'est une buck
disease,Varroa,varroa destructor|varroase,Acarien parasite principal,J'ai un taux de varroa eleve
- Les synonymes sont separes par le caractere
| - La premiere ligne peut etre un en-tete (detecte automatiquement)
- Les termes existants sont mis a jour (upsert sur term + category + locale)
- Les termes auto-synchronises ne sont pas ecrases
Cache
Le vocabulaire est cache en memoire pendant 5 minutes cote serveur. Quand vous ajoutez, modifiez ou supprimez un terme, le cache est automatiquement invalide. Le changement est donc visible par le Voice Agent et Oracle dans les secondes qui suivent.
Tout changement dans le vocabulaire admin est immediatement repercute sur le Voice Agent et le support IA — aucun redemarrage, rebuild ou redeploiement n'est necessaire.
API
Les routes suivantes sont disponibles :
| Route | Methode | Acces | Description |
|---|---|---|---|
/api/admin/vocabulary | GET | Admin | Liste paginee avec filtres et stats |
/api/admin/vocabulary | POST | Admin | Ajouter un terme |
/api/admin/vocabulary/[id] | PUT | Admin | Modifier un terme |
/api/admin/vocabulary/[id] | DELETE | Admin | Supprimer (interdit si auto-sync) |
/api/admin/vocabulary/import-csv | POST | Admin | Import CSV en masse |
/api/vocabulary/voice-context | GET | Authentifie | Termes pour le voice agent |
/api/vocabulary/rag-context | GET | Authentifie | Termes pour le support IA |
Seed initial
BeePass est livre avec 50+ termes pre-configures couvrant les 9 categories. Ce vocabulaire de base permet au Voice Agent et a Oracle de fonctionner immediatement. Vous pouvez ajouter, modifier ou supprimer des termes a tout moment selon vos besoins.