docs(hermes): rapport analyse 2026-06-09_04-30 — 5 fichiers

Analysés : litellm.md, llama_server.md, rag.md, rocm.md, incidents.md
À améliorer : 0/5

Co-Authored-By: Hermes <hermes@funk.lab>
This commit is contained in:
Hermes Bot 2026-06-09 04:33:02 +02:00
parent cf0eb70450
commit fb8ae46633

View file

@ -0,0 +1,111 @@
# Rapport Hermes — 2026-06-09_04-30
> Branche : `hermes/daily-work` · Fichiers analysés : 5
---
## Résumé
- ✅ À jour : 5
- ⚠️ À améliorer : 0
## ✅ `admin/ia/litellm.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète sur la configuration et l'utilisation de LiteLLM avec des modèles LLM, mais présente des lacunes dans la gestion IaC des modèles CPU
**Problèmes :**
- Le template Ansible litellm/config.yaml.j2 manque les modèles CPU qwen3-1.7b-system et qwen3-1.7b-monitor
- Les modifications manuelles dans /etc/litellm/config.yaml ne sont pas reflétées dans le template Ansible
- Le coût des modèles Claude est décrit de manière incomplète (manque les tarifs par token)
- Le script hermes-switch n'est pas documenté en détail dans la section 'Switch rapide'
**Suggestions :**
- Mettre à jour le template Ansible pour inclure les modèles CPU manquants
- Ajouter une section explicite sur la gestion des modèles via hermes-switch
- Préciser les tarifs par token pour les modèles Claude
- Documenter les étapes de déploiement du script hermes-switch
**État réel connu de Hermes :**
Les modèles CPU sont manuellement ajoutés dans la configuration, ce qui crée une dépendance fragile. Le déploiement via Ansible ne configure pas correctement les routes pour ask-agent system/monitor
---
## ✅ `admin/ia/llama_server.md` — 8/10
**Statut** : ok
**Résumé** : Document complet décrivant la configuration et les performances des instances llama-server sur gpu-01, avec des commandes de test et des métriques Prometheus.
**Problèmes :**
- Manque de détails sur la configuration exacte des services systemd (ex: paramètres de démarrage)
- Aucune mention des dépendances requises (ex: jq, ROCm 7.x)
- Le tableau des performances ne montre pas les débits en tok/s pour les modèles CPU
- La section des métriques Prometheus ne précise pas comment activer le flag --metrics
**Suggestions :**
- Ajouter une section 'Configuration requise' avec les dépendances et prérequis
- Mettre à jour le tableau des performances avec les débits réels pour Qwen3-1.7B CPU
- Expliciter les étapes pour activer les métriques Prometheus dans le service systemd
- Ajouter un exemple de sortie attendue pour les tests d'API
- Inclure une section 'Dépannage' pour les cas d'erreur courants
**État réel connu de Hermes :**
Les instances sont actives et fonctionnent selon les spécifications. Le modèle Qwen3-8B utilise ~9GB VRAM sans surcharger la RX 6700XT. Les métriques Prometheus sont disponibles via /metrics après activation du flag --metrics.
---
## ✅ `admin/ia/rag.md` — 9/10
**Statut** : à_jour
**Résumé** : Documentation complète du système RAG avec architecture, composants, modèles et procédures de mise à jour, bien que quelques limitations soient documentées.
**Problèmes :**
- Utilisation du Qwen3-8B (modèle génératif) pour les embeddings, ce qui limite la discrimination sémantique
- Temps long d'ingestion (5-10 minutes) pour 339 chunks
**Suggestions :**
- Évaluer le déploiement de modèles d'embedding dédiés comme bge-m3 pour améliorer la pertinence
- Optimiser le processus d'ingestion avec des techniques de batch ou de parallélisation
- Ajouter des exemples concrets de requêtes RAG dans la section d'utilisation
**État réel connu de Hermes :**
Le système RAG est opérationnel avec les composants déployés (Qdrant, rag-ingest, rag-query) et les procédures documentées, mais les limitations du modèle d'embedding restent critiques pour la qualité des résultats.
---
## ✅ `admin/ia/rocm.md` — 9/10
**Statut** : à_jour
**Résumé** : Le document ROCm.md est complet et à jour, couvrant les vérifications clés, les variables d'environnement, les modules kernel et les bonnes pratiques pour le fonctionnement de ROCm sur RX 6700XT.
**Problèmes :**
- Le statut de 'rocm-smi' manque une explication sur son absence sur gpu-01 (peut être un point d'ombre technique)
- Les commandes 'watch' et 'cat /sys/class/drm/' dépendent de la version du kernel et peuvent échouer si les paths ne correspondent plus
**Suggestions :**
- Ajouter une note explicite sur l'absence de 'rocm-smi' et son impact potentiel
- Mettre à jour les paths sysfs pour la version du kernel 5.14.0-687.el9_8
- Inclure un exemple de sortie attendue pour 'rocminfo' pour clarifier le format de vérification
**État réel connu de Hermes :**
ROCm fonctionne correctement sur gpu-01 avec RX 6700XT (gfx1031) grâce à HSA_OVERRIDE_GFX_VERSION=10.3.0. Aucun crash détecté, NFS exporté, configuration conforme. Le manque de 'rocm-smi' reste un point à surveiller.
---
## ✅ `admin/incidents.md` — 9/10
**Statut** : à_jour
**Résumé** : Document structuré avec historique des incidents critiques et résolutions détaillées, format markdown clair.
**Problèmes :**
- Manque d'icons/visuel pour les niveaux de sévérité (Critique/Warning)
- Certains résolutions sont très techniques et pourraient être fragmentés en sous-sections
- Aucune mention des états actuels des composants post-résolution
**Suggestions :**
- Ajouter un légende visuel pour les niveaux de sévérité (⚠️/❗)
- Structurer les résolutions avec des sous-titres (Ex: 🛠️ Étape 1 - Stopper les services)
- Mettre à jour la section 'État réel' avec les statuts actuels des composants
**État réel connu de Hermes :**
Le RAID5 a été migré vers NVMe avec succès. Les composants cités dans les incidents historiques sont tous résolus, sauf les alertes de monitoring qui nécessitent une vérification périodique.
---