mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-08 11:14:43 +02:00
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:
parent
3a013834aa
commit
eae6e76645
9 changed files with 687 additions and 0 deletions
97
hermes-skills/funk/rag-docs/SKILL.md
Normal file
97
hermes-skills/funk/rag-docs/SKILL.md
Normal 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.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
|
||||
Loading…
Add table
Add a link
Reference in a new issue