docs(hermes): rapport analyse 2026-06-03_23-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-03 23:33:07 +02:00
parent 541822dfe7
commit 72422b3906

View file

@ -0,0 +1,110 @@
# Rapport Hermes — 2026-06-03_23-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é** : Document complet sur la configuration et l'utilisation de LiteLLM comme proxy LLM, avec des informations sur les modèles, coûts et scripts d'administration
**Problèmes :**
- Le template Ansible manque les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) nécessaires aux agents ask-agent
- Les coûts Claude sont présentés sous forme de tableaux avec des valeurs incomplètes (ex: "~-bash.24")
- Le script hermes-switch n'est pas décrit en détail dans le document
**Suggestions :**
- Mettre à jour le template Ansible pour inclure les modèles CPU manquants
- Corriger les formats de tableau pour les coûts Claude
- Ajouter une explication détaillée du fonctionnement de hermes-switch
**État réel connu de Hermes :**
Les modèles CPU sont ajoutés manuellement dans /etc/litellm/config.yaml, ce qui crée une dépendance fragile. Le script hermes-switch fonctionne mais nécessite une documentation complémentaire.
---
## ✅ `admin/ia/llama_server.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète des trois instances llama-server sur gpu-01 avec configurations, API OpenAI, performances et métriques Prometheus, mais manque des détails sur l'état actuel des services dans Funk
**Problèmes :**
- La section sur les métriques Prometheus indique que le flag --metrics est requis mais ne vérifie pas si cela est activé dans la configuration systemd
- Mention d'un bug 'parallel' pour Hermes sans détails supplémentaires
- Aucune mention des dépendances requises pour les modèles Qwen3-8B/Q4_K_M
**Suggestions :**
- Ajouter une vérification des prérequis système (ROCm 7.x, VRAM, etc.)
- Inclure la commande pour vérifier l'état des services systemd
- Mettre à jour les métriques avec les valeurs actuelles du cluster
- Ajouter une note sur la gestion des quotas VRAM pour les modèles
**État réel connu de Hermes :**
Les trois instances sont configurées correctement avec les modèles Qwen3-8B/Q4_K_M, mais les métriques Prometheus nécessitent le flag --metrics activé dans le service systemd
---
## ✅ `admin/ia/rag.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète sur l'implémentation RAG dans Funk, expliquant l'architecture, les composants et les procédures d'utilisation avec des exemples concrets.
**Problèmes :**
- Le modèle d'embedding Qwen3-8B présente des limitations de discrimination sémantique (scores cosinus uniformément élevés)
- La procédure manuelle de re-indexage est coûteuse en temps (5-10 minutes pour 339 chunks)
**Suggestions :**
- Ajouter des instructions pour déployer des modèles d'embedding dédiés comme nomic-embed-text-v1.5
- Proposer une optimisation du processus d'ingestion via batch processing ou parallélisation
- Mettre en avant les alternatives multilingues comme bge-m3 pour les recherches en français
**État réel connu de Hermes :**
Le système RAG est opérationnel avec Qdrant et rag-query, mais les résultats de recherche souffrent de la limitation du modèle d'embedding. L'index est maintenu via Ansible et processus manuels.
---
## ✅ `admin/ia/rocm.md` — 8/10
**Statut** : à_jour
**Résumé** : Document complet sur la configuration ROCm pour RX 6700XT, avec des vérifications clés et des commandes d'analyse, mais nécessite quelques ajustements mineurs.
**Problèmes :**
- Utilisation de 'g01' comme hostname (devrait être 'gpu-01' ou '192.168.10.20')
- Absence de mention des dépendances nécessaires (ex: packages AMD ROCm)
- Commandes 'watch' et 'cat /sys/class/drm' peuvent nécessiter des droits root
- Pas de note sur la compatibilité avec les conteneurs (ROCm exécuté directement sur l'hôte)
**Suggestions :**
- Mettre à jour les hostnames vers 'gpu-01' ou l'IP 192.168.10.20
- Ajouter une section sur la configuration des dépôts AMD ROCm
- Préciser les prérequis système (ex: kernel 5.x, modules amdgpu)
- Ajouter des explications sur l'override HSA_VERSION et ses implications
**État réel connu de Hermes :**
ROCm est configuré avec HSA_OVERRIDE_GFX_VERSION=10.3.0 sur gpu-01, les modules amdgpu sont chargés, et les commandes de vérification fonctionnent. Les groupes utilisateur 'video'/'render' sont correctement configurés.
---
## ✅ `admin/incidents.md` — 9/10
**Statut** : à_jour
**Résumé** : Document complet et structuré avec historique des incidents et résolutions détaillées, mais manque d'informations sur l'état actuel des composants post-résolution.
**Problèmes :**
- L'entrée 'État post-migration' ne fournit pas de métriques ou de vérifications post-incident
- Aucune mention des états actuels des composants comme Grafana ou AlertManager après leurs incidents
- La section '2026-05-13' mentionne une erreur `/metrics` non corrigée
**Suggestions :**
- Ajouter une section 'État actuel' pour chaque composant mentionné avec vérifications post-résolution
- Mettre à jour les entrées avec des dates de validation (ex: 'Corrigé le 2026-06-01')
- Utiliser des listes à puces pour les étapes de résolution pour améliorer la lisibilité
**État réel connu de Hermes :**
Le document reflète correctement les incidents historiques, mais ne fournit pas d'informations actualisées sur l'état des systèmes post-résolution
---