---
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.60–1.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