mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-08 10:14:42 +02:00
eae6e76645
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>
97 lines
2.5 KiB
Markdown
97 lines
2.5 KiB
Markdown
---
|
||
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
|