docs(hermes): rapport analyse 2026-06-10_07-00 — 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-10 07:02:58 +02:00
parent bccaf244a3
commit 2313cf5ae1

View file

@ -0,0 +1,108 @@
# Rapport Hermes — 2026-06-10_07-00
> Branche : `hermes/daily-work` · Fichiers analysés : 5
---
## Résumé
- ✅ À jour : 5
- ⚠️ À améliorer : 0
## ✅ `admin/ia/litellm.md` — 9/10
**Statut** : à_jour
**Résumé** : Documentation complète sur la configuration et l'utilisation de LiteLLM avec des modèles locaux et cloud, mais présente un gap IaC sur les modèles CPU.
**Problèmes :**
- Les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) sont manuellement ajoutés au config.yaml alors que le template Ansible ne les inclut pas
- Les coûts Claude sont présentés sous forme de tableaux avec des valeurs non numériques (ex: ~-bash.24)
- Le script hermes-switch modifie directement le config.yaml sans utiliser un mécanisme versionné
**Suggestions :**
- Mettre à jour le template Ansible pour inclure les modèles CPU dans la configuration
- Formater les coûts Claude avec des valeurs numériques claires (ex: $0.024 par million de tokens)
- Implémenter un système de versionnage pour les modifications du config.yaml (ex: avec Git)
**État réel connu de Hermes :**
Les modèles CPU sont actuellement manuellement ajoutés sur storage-01, créant un point de défaillance dans la gestion IaC. Le script hermes-switch fonctionne mais n'est pas idéal pour la gestion de configuration décentralisée.
---
## ✅ `admin/ia/llama_server.md` — 8/10
**Statut** : à_jour
**Résumé** : Document complet sur la configuration et l'utilisation de llama-server sur gpu-01, avec paramètres, performances et métriques.
**Problèmes :**
- Manque de mention sur la gestion thermique du RX 6700XT (12 GB VRAM)
- La section 'Performances' ne compare pas avec d'autres modèles/architectures
- Le bug 'parallel' lié à Hermes n'est pas décrit avec des solutions de contournement
- Aucune mention des limites de tokens pour les requêtes API
**Suggestions :**
- Ajouter une section sur la surveillance thermique et la gestion de la VRAM
- Inclure des benchmarks avec d'autres modèles (ex: Qwen3-1.7B vs Qwen3-8B)
- Expliquer le bug 'parallel' et proposer des workarounds
- Spécifier les limites de tokens pour les requêtes API
**État réel connu de Hermes :**
Le composant est actif sur gpu-01 avec les trois instances systemd. Les métriques Prometheus sont disponibles via /metrics quand le flag --metrics est activé. Les performances mesurées correspondent aux spécifications techniques fournies.
---
## ✅ `admin/ia/rag.md` — 7/10
**Statut** : ok
**Résumé** : Documentation complète sur l'implémentation RAG dans Funk, incluant architecture, composants, modèles et processus d'indexation.
**Problèmes :**
- Le modèle Qwen3-8B utilisé pour les embeddings n'est pas optimisé pour la recherche sémantique (scores de similarité uniformément élevés)
- Manque de détails concrets sur les étapes pour migrer vers des modèles d'embedding dédiés comme nomic-embed-text-v1.5
**Suggestions :**
- Ajouter un exemple concret de migration vers nomic-embed-text-v1.5 avec les commandes exactes à exécuter
- Proposer un script d'auto-évaluation des résultats de recherche pour vérifier l'efficacité du modèle
- Mettre en avant les avantages du modèle bge-m3 pour le français dans la section 'Quand améliorer'
**État réel connu de Hermes :**
Le système RAG est opérationnel avec Qwen3-8B, mais les résultats de recherche souffrent de perte de pertinence due au modèle non optimisé. La migration vers un modèle d'embedding dédié est techniquement possible via les instructions fournies, mais non encore implémentée.
---
## ✅ `admin/ia/rocm.md` — 9/10
**Statut** : à_jour
**Résumé** : Le document ROCm.md est complet et à jour avec les vérifications nécessaires pour la RX 6700XT sur gpu-01
**Problèmes :**
- Aucun problème critique détecté
- Manque une section sur la gestion des mises à jour ROCm
**Suggestions :**
- Ajouter une section sur la gestion des mises à jour ROCm
- Mettre à jour les commandes pour vérifier la version ROCm actuelle
**État réel connu de Hermes :**
ROCm fonctionne correctement sur gpu-01 avec les configurations requises, aucun incident signalé
---
## ✅ `admin/incidents.md` — 9/10
**Statut** : à_jour
**Résumé** : Document complet et structuré avec historique des incidents critiques et résolutions détaillées. Les informations techniques sont précises et les étapes de résolution sont bien documentées.
**Problèmes :**
- Format de date incohérent dans le tableau (ex: '2026-05-29' vs '2026-05-14')
- Manque de références externes vers tickets ou suivi des incidents
- Le champ 'état_réel' pour certains composants n'est pas mis à jour (ex: AlertManager)
**Suggestions :**
- Ajouter des indicateurs de résolution (ex: dates de résolution, statuts actuels)
- Normaliser le format des dates dans tout le document
- Lier les incidents à des tickets de suivi ou des références externes
- Mettre à jour le champ 'état_réel' avec la configuration actuelle des composants (ex: RAID dégradé vs NVMe)
**État réel connu de Hermes :**
Le composant /srv/data a été migré vers le NVMe (XFS) et le RAID5 est désormais en lecture seule. Le disque sdd a été remplacé et le système a subi une réinstallation de hermes-agent. Les alertes AlertManager sont maintenant configurées avec des receivers valides.
---