docs(hermes): rapport analyse 2026-06-05_05-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-05 05:32:51 +02:00
parent 7608b2bdac
commit 083bb12660

View file

@ -0,0 +1,109 @@
# Rapport Hermes — 2026-06-05_05-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 comme proxy LLM, avec des exemples pratiques et des informations sur les modèles disponibles.
**Problèmes :**
- Le template Ansible manque les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) nécessaires pour ask-agent
- Référence vers hermes.md manquante dans le document
- Le script hermes-switch modifie manuellement le config.yaml au lieu d'utiliser un template Ansible
**Suggestions :**
- Ajouter les modèles CPU dans le template Ansible (config.yaml.j2)
- Inclure le fichier hermes.md référencé dans la documentation
- Réaliser un audit des scripts de gestion (hermes-switch) pour utiliser des templates Ansible standardisés
**État réel connu de Hermes :**
Configuration fonctionnelle avec modèles GPU principaux, mais dépendante de modifications manuelles pour les modèles CPU. Le déploiement automatique via Ansible ne garantit pas la complète conformité des routes nécessaires à ask-agent.
---
## ✅ `admin/ia/llama_server.md` — 9/10
**Statut** : à_jour
**Résumé** : Documentation complète et structurée sur la configuration des instances llama-server sur gpu-01, incluant paramètres, métriques et tests API
**Problèmes :**
- Manque la version précise de ROCm 7.x utilisée
- Le paragraphe sur les embeddings pourrait préciser le type de pooling requis (mean) pour éviter les erreurs 400
- Le tableau des performances contient une typo dans la colonne 'TTFT Hermes' (doublon de TTFT)
**Suggestions :**
- Ajouter la version exacte de ROCm 7.x pour la compatibilité
- Mettre en évidence le flag --pooling mean dans la section embeddings
- Corriger la typo dans le tableau des performances
**État réel connu de Hermes :**
Les instances sont actives sur gpu-01 avec les modèles Qwen3-8B (GPU) et Qwen3-1.7B (CPU). Les métriques Prometheus sont disponibles avec le flag --metrics. Les tests API fonctionnent comme attendu.
---
## ✅ `admin/ia/rag.md` — 9/10
**Statut** : à_jour
**Résumé** : Documentation complète sur l'implémentation RAG de Funk, avec architecture, composants, usage et processus de mise à jour
**Problèmes :**
- Limite connue avec Qwen3-8B : scores de similarité cosinus uniformément hauts (0.90-0.95) avec peu de discrimination sémantique
- Temps d'ingestion long (5-10 minutes pour 339 chunks via GPU)
**Suggestions :**
- Tester le déploiement d'un modèle d'embedding dédié (nomic-embed-text-v1.5 ou bge-m3) pour améliorer la recherche sémantique
- Optimiser le processus d'ingestion avec un modèle CPU-only pour réduire le temps de traitement
**État réel connu de Hermes :**
Le système RAG est actif sur storage-01 avec Qdrant (collection funk-docs), les outils rag-query/rag-ingest sont disponibles, et le processus d'indexation fonctionne via Ansible
---
## ✅ `admin/ia/rocm.md` — 8/10
**Statut** : à_jour
**Résumé** : Document complet sur la configuration ROCm pour RX 6700XT avec vérifications clés, mais manque de contexte technique et de précautions
**Problèmes :**
- Aucune explication sur pourquoi HSA_OVERRIDE_GFX_VERSION est nécessaire
- Absence de précautions lors du rechargement des modules kernel
- Commandes de vérification manquantes pour les drivers AMD
- Pas de conseils sur la gestion des erreurs courantes
**Suggestions :**
- Ajouter une explication technique sur le besoin de HSA_OVERRIDE_GFX_VERSION
- Inclure des avertissements pour les opérations risquées (reload module)
- Ajouter des vérifications supplémentaires pour les drivers AMD
- Proposer des solutions pour les erreurs courantes rencontrées
**État réel connu de Hermes :**
La configuration ROCm est fonctionnelle sur gpu-01 avec les paramètres documentés, mais nécessite des améliorations pour la robustesse
---
## ✅ `admin/incidents.md` — 8/10
**Statut** : à_jour
**Résumé** : Document bien structuré avec historique des incidents et résolutions détaillées, mais contient une erreur de typo dans la table d'état post-migration.
**Problèmes :**
- La ligne 'Espace disponibl' dans la table d'état post-migration est incomplète (tronquée)
- Absence de vérification des autres tables d'incidents pour garantir leur complétude
- Manque de mention sur la validation des données après migration (rsync exit code 23)
**Suggestions :**
- Corriger la typo dans 'Espace disponibl' et compléter la ligne
- Ajouter un vérification post-migration des données critiques (ex: checksums)
- Mettre à jour la date de dernière modification du document
- Ajouter une note de mise à jour sur la décommission du RAID5
**État réel connu de Hermes :**
Le composant /srv/data a été migré vers le NVMe avec succès, les services fonctionnent normalement, la corruption Qdrant a été corrigée. Le RAID5 a été décommissionné.
---