feat(rag): RAG Hermes — Qdrant + rag-ingest/rag-query + skill funk-ai

Indexation de admin/ (284 chunks) dans Qdrant via embeddings Qwen3-8B.
rag-query utilisable en CLI et depuis le profil funk-ai de Hermes.
Note: modèle d'embedding générique — qualité limitée, voir admin/ia/rag.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
alkatrazz 2026-05-14 22:16:06 +02:00
parent 3a013834aa
commit eae6e76645
9 changed files with 687 additions and 0 deletions

View file

@ -0,0 +1,97 @@
---
name: rag-docs
description: "Interroge la documentation Funk via RAG pour répondre aux questions sur le cluster, les services, les configs et les procédures admin."
version: 1.0.0
author: Funk Lab
license: MIT
platforms: [linux]
metadata:
hermes:
tags: [rag, documentation, funk, cluster, recherche]
---
# Documentation RAG — Cluster Funk
## Quand utiliser ce skill
Pour toute question sur :
- Procédures admin (comment faire X, commandes utiles)
- Configuration d'un service (dnsmasq, litellm, hermes, nftables, llama-server...)
- Architecture du cluster Funk
- Dépannage d'un composant (diagnostics, causes connues)
- Alertes et monitoring
**Ne pas utiliser** pour l'état en temps réel (logs live, métriques actuelles) — utiliser Terminal directement.
---
## Commande
```bash
rag-query "ta question"
```
Interroge la base vectorielle Qdrant avec la question, retourne les passages
de documentation les plus proches sémantiquement (score ≥ 0.60).
Options :
```bash
rag-query "question" --top 3 # limiter à 3 résultats (défaut: 5)
```
---
## Pattern obligatoire
**Étape 1** — Interroger la base RAG :
```
terminal: rag-query "comment relancer dnsmasq après un reboot ?"
```
**Étape 2** — Utiliser le contexte retourné pour formuler la réponse, en citant la source :
```
D'après la documentation Funk (admin/infra/dnsmasq.md § Dépannage) :
sudo systemctl restart dnsmasq
...
```
---
## Exemples
```bash
# Procédure de redémarrage d'un service
terminal: rag-query "comment redémarrer llama-server gpu ?"
# Dépannage
terminal: rag-query "dnsmasq failed après reboot causes"
# Configuration
terminal: rag-query "nftables règles firewall cluster pod cidr"
# Architecture
terminal: rag-query "hermes profils litellm modèles disponibles"
# Alertes
terminal: rag-query "GPUTemperatureCritical seuil alertmanager"
```
---
## Interpréter les résultats
Chaque résultat indique :
- **source** : `admin/ia/hermes.md § Configuration`
- **score** : pertinence sémantique (0.601.00) — un score > 0.75 est très pertinent
- **texte** : extrait du document
Si le score est < 0.65 ou les résultats hors sujet : répondre depuis ta connaissance générale
et le mentionner (`"Je n'ai pas trouvé de documentation spécifique sur ce point"`).
---
## Règles
- Toujours citer la source (`admin/ia/hermes.md § section`)
- Un seul appel `rag-query` suffit pour une question — ne pas enchaîner plusieurs requêtes
- Ne jamais inventer des commandes non trouvées dans les résultats RAG