Ce guide explique comment utiliser l'interface d'administration de Voice Coach.
L'interface est organisée en 4 onglets, accessibles depuis la barre en bas de l'écran.
Comment naviguer
En bas de l'écran, vous trouverez une barre avec 4 boutons :
- 🔧 Maintenance — surveiller l'état du système
- 📊 Sessions — consulter l'historique des sessions de coaching
- 🧠 RAG — gérer les documents de connaissance
- 🤖 Prompt — modifier les prompts des agents
Cliquez sur un onglet pour y accéder. L'onglet actif est souligné en violet.
🔧 Onglet Maintenance
Cet onglet permet de vérifier que tout fonctionne et d'effectuer des opérations de maintenance.
Statut du Backend
Affiche l'état du serveur Voice Coach avec un indicateur coloré :
- ● Vert = le service fonctionne
- ● Rouge = problème détecté
APIs externes
Affiche l'état de connexion de chaque service externe utilisé par Voice Coach :
- Anthropic — le moteur d'intelligence artificielle (LLM)
- Deepgram — la reconnaissance vocale (voix → texte)
- ElevenLabs / Cartesia — la synthèse vocale (texte → voix)
- Prometheus, Grafana, Loki, Tempo — outils de monitoring (technique)
Chaque carte affiche aussi le temps de réponse en millisecondes.
Si un service est marqué "skipped", c'est qu'il n'est pas configuré — ce n'est pas une erreur.
Actions
Quatre boutons d'action sont disponibles :
-
📦 Backup Voice-Coach
Crée une sauvegarde complète de l'application. Le fichier de backup sera téléchargeable.
-
🔄 Restart Server
Redémarre le serveur Voice Coach. La page se recharge automatiquement après 2 secondes.
-
⚠️ Restart Container
Redémarre le conteneur Docker entier. Plus complet qu'un simple restart serveur.
-
🔨 Rebuild Container
Reconstruit et redéploie entièrement le conteneur. Utilisez ceci après une mise à jour du code.
Chaque action demande une confirmation avant de s'exécuter. Le bouton "Rebuild" est en rouge car c'est l'opération la plus lourde (plusieurs minutes).
📊 Onglet Sessions
Cet onglet permet de consulter et télécharger les données des sessions de coaching.
Fichier Master
Le bouton ⬇️ Download sessions.xlsx télécharge un fichier Excel
qui contient toutes les sessions de coaching consolidées en un seul fichier.
C'est le fichier à utiliser pour analyser l'ensemble des sessions dans Excel ou Google Sheets.
Historique des sessions
Un tableau affiche les 5 dernières sessions avec les informations suivantes :
- Session ID — identifiant unique (cliquable pour télécharger les détails)
- Date et Heure — quand la session a eu lieu
- Durée — durée totale de la session
- Émotion principale — l'émotion détectée pendant la phase de découverte
- Score — score d'efficacité de la session
- Mode / Langue / Modèle — paramètres techniques de la session
En cliquant sur un Session ID, deux fichiers Excel sont téléchargés automatiquement :
le résumé de la session et le détail tour par tour.
🧠 Onglet RAG
RAG signifie Retrieval-Augmented Generation. C'est le système qui permet à l'IA
de s'appuyer sur vos documents (PDFs et micro-actions) pour enrichir ses réponses.
Informations de l'index
Une carte affiche les statistiques de l'index actuel :
- Built — date de la dernière construction de l'index
- Chunks — nombre de morceaux de texte indexés
- Files Indexed — nombre de fichiers traités
- Build Duration — temps de construction en secondes
Gestion des PDFs
Cette section liste tous les PDFs actuellement indexés (nom + taille).
Pour ajouter un nouveau PDF : cliquez sur la zone d'upload
"📄 Click to upload PDF" et sélectionnez votre fichier.
Seuls les fichiers .pdf sont acceptés. Après l'upload, pensez à reconstruire l'index (voir ci-dessous).
Micro-actions
Cliquez sur "📋 Click to upload microactions.xlsx" pour remplacer le fichier
de micro-actions existant par une nouvelle version.
L'upload remplace le fichier existant. Assurez-vous que votre nouveau fichier est complet.
Reconstruire l'index
Le bouton 🔨 Rebuild Complete Index reconstruit entièrement
l'index de recherche à partir de tous les PDFs et micro-actions.
Quand l'utiliser :
- Après avoir uploadé un nouveau PDF
- Après avoir remplacé le fichier de micro-actions
- Si l'IA ne semble pas trouver les bonnes informations dans les documents
La reconstruction prend quelques secondes. Un journal de progression s'affiche pendant l'opération.
🤖 Onglet Prompt (Agents)
C'est ici que vous gérez les prompts des agents de coaching.
Chaque agent est défini par un fichier YAML qui contient ses instructions.
Les agents
Vous verrez une carte pour chaque fichier d'agent :
- base.yaml — les instructions communes à tous les agents (personnalité, éthique, objectif global)
- decouverte.yaml — Agent 1 : phase de découverte (identifier l'émotion)
- conscience.yaml — Agent 2 : phase de prise de conscience (explorer le mécanisme)
- microaction.yaml — Agent 3 : phase de micro-action (proposer un exercice)
- evaluation.yaml — Agent 4 : phase d'évaluation (mesurer l'efficacité)
Télécharger un prompt
Cliquez sur le bouton ⬇️ Download d'un agent pour
récupérer son fichier YAML actuel. Vous pourrez ensuite l'ouvrir et le modifier
dans un éditeur de texte.
Modifier un prompt
Pour mettre à jour le prompt d'un agent :
- Téléchargez le fichier YAML actuel
- Modifiez-le dans un éditeur de texte
- Cliquez sur ⬆️ Upload pour envoyer la nouvelle version
Le système vérifie automatiquement que le fichier YAML est valide avant de l'accepter.
Si le format est incorrect, un message d'erreur s'affichera.
Après un upload réussi, les agents sont rechargés automatiquement en mémoire.
Le changement est immédiat pour les prochaines sessions.
Questions fréquentes
J'ai modifié un prompt mais rien n'a changé ?
Les modifications s'appliquent uniquement aux nouvelles sessions.
Si une session est déjà en cours, elle utilise l'ancien prompt jusqu'à sa fin.
J'ai uploadé un PDF mais l'IA ne l'utilise pas ?
Après l'upload d'un PDF, il faut reconstruire l'index RAG
(bouton "🔨 Rebuild Complete Index" dans l'onglet RAG).
Un service externe est en rouge, que faire ?
Vérifiez que la clé API du service est correctement configurée.
Si le problème persiste, essayez un Restart Server.
Comment revenir à l'interface d'administration ?
Cliquez sur le bouton "← Retour à l'admin" en haut à droite de cette page.
Voice Coach — Guide d'utilisation