Funk-lab/docs/asa-commandes.md

# Ce que tu peux demander à Asa

Catalogue des demandes possibles à l'assistant vocal **Asa** (par la voix ou en tapant dans le
HUD). La plupart passent par le contexte agentique **`asa`** (par défaut) : Asa **choisit seule**
le bon outil. Quelques demandes sont des **intents déterministes** traités côté client (avant
même d'appeler le modèle) — signalés par 🎯.

> Tu n'as pas besoin de dire le mot « outil » ni de choisir un contexte : formule naturellement.
> Astuce : commence par « Asa, … » pour la réveiller si elle est en veille.

---

## 🗣️ Réveil / veille

| Demande | Effet |
|---|---|
| « **Asa** » | Réveille l'assistante (sort de veille) |
| « Asa, <ta question> » | Réveille **et** exécute la question |
| « **Asa stop** », « dors », « au revoir », « bonne nuit », « silence » | La remet en **veille** (n'écoute plus que le mot de réveil) |

---

## 🩺 État & santé du homelab  *(outils `host_health`, `cluster_status`)*

Données **live** (Prometheus) — Asa va chercher l'info réelle, pas la doc.

- « Est-ce que **gpu-01** tourne bien ? »
- « Et **storage-01** ? »
- « Donne-moi la **température**, la **VRAM** et la **puissance** du GPU »
- « Quelle est l'**utilisation CPU** de gpu-01 ? » · « Combien de **RAM libre** sur storage-01 ? »
- « Quel est l'**uptime** de storage-01 ? » · « L'espace **disque** est‑il ok ? »
- « Est-ce que le **cluster** va bien ? » · « Combien de **pods** tournent ? »
- « Y a-t-il des **pods en erreur** / en CrashLoop ? » · « Les **nœuds Kubernetes** sont‑ils prêts ? »
- « Est-ce que **llama-server** est en ligne ? »

## 📈 Métriques précises  *(outil `prometheus_query`)*

Pour une métrique pointue non couverte ci-dessus, Asa peut écrire une requête PromQL :

- « Combien de **cibles Prometheus** sont up ? »
- « Quelle est la **charge** des nœuds du cluster ? »
- « Montre-moi la **consommation mémoire** des pods du namespace ai. »

## 🚨 Alertes  *(contexte alerting / Alertmanager)*

- « Y a-t-il des **alertes** actives ? » · « Qu'est-ce qui **ne va pas** en ce moment ? »

---

## 📚 Documentation Funk  *(outil `search_docs` — RAG)*

Questions sur la **conception / la config** du homelab (répond depuis la doc `admin/`) :

- « Comment **relancer dnsmasq** ? »
- « Quelle est la config **nftables** pour le cluster ? »
- « Quels **profils Hermes** existent et quels modèles utilisent-ils ? »
- « Comment fonctionne le **RAG** / l'ingestion de la doc ? »
- « Quelle est l'architecture **réseau / VLAN** de Funk ? »
- « C'est quoi le **watchdog** de llama-server ? »

---

## 🌐 Recherche web  *(outil `web_search` — SearXNG privé)*

Pour tout ce qui est **hors homelab** ou **récent** :

- « **Cherche sur le web** la dernière version de Kubernetes. »
- « Quelles sont les **nouveautés** de ROCm 7 ? »
- « Trouve la **doc officielle** de SearXNG. »
- « C'est quoi le **CVE** récent sur … ? »

---

## 🤖 Actions d'administration  *(outil `admin_action` — confirmation requise)*

Asa **propose** l'action puis attend ton **« confirme »** avant d'exécuter (via Hermes). Dis
« annule » pour abandonner.

- « **Redémarre** le déploiement open-webui. » → *« Tu veux que j'exécute : … ? »* → « **confirme** »
- « **Relance** le pod n8n. » · « **Redémarre** litellm sur storage-01. »
- « **Ré-ingère** la doc dans le RAG. »

> ⚠️ Réservé aux demandes explicites d'agir, toujours derrière confirmation + jeton. Pour de la
> simple lecture, Asa n'utilise jamais cet outil.

---

## 🧭 Ouvrir un service  🎯  *(intent client : « ouvre / lance / montre <service> »)*

Ouvre la page du service dans le navigateur. Le `<service>` accepte plusieurs **alias** :

| Service | Dis par ex. |
|---|---|
| **Ghostfolio** | « ouvre le **portefeuille** », « ouvre **ghosto** », « montre la **bourse** » |
| **Grafana** | « ouvre **grafana** », « affiche le **monitoring** / **dashboard** » |
| **ArgoCD** | « ouvre **argo** », « montre les **déploiements** / **gitops** » |
| **n8n** | « ouvre **n8n** », « lance les **workflows** / l'**automatisation** » |
| **Open WebUI** | « ouvre le **chat** / **webui** / l'**interface IA** » |
| **Prometheus** | « ouvre **prometheus** / les **métriques brutes** » |
| **Alertmanager** | « ouvre les **alertes** / **alarmes** » |

## 🟢 Santé du portail  🎯  *(intent : « état du cluster / des services »)*

- « **État du cluster** » · « État des **services** » · « Comment va l'**infra** ? » → résumé santé live des tuiles du portail.

---

## 💰 Portefeuille Ghostfolio  🎯  *(intent : « combien sur mon ghostfolio »)*

- « **Combien** sur mon **ghostfolio** ? » · « Quelle est la **valeur** de mon **portefeuille** ? »
- « Combien je **vaux** en bourse ? »

---

## 🧠 Mémoire & conversation

Asa garde le **fil** de la session et une **mémoire long terme** (Qdrant). Tu peux donc enchaîner :

- « Et **storage-01** ? » (après avoir parlé de gpu-01)
- « **Rappelle-toi** que je préfère les réponses courtes. »
- Pour repartir de zéro : bouton **reset** du HUD (ou « **réinitialise** la conversation »).

---

## 🧩 Contextes (avancé)

Par défaut Asa est en contexte **`asa`** (outils). Le HUD permet d'en présélectionner d'autres
(sélecteur en haut à droite) pour cadrer la réponse :

| Contexte | Pour |
|---|---|
| **asa** | Tout — Asa choisit ses outils *(défaut)* |
| **funk** | Q&A strict sur la **doc** uniquement (grounding strict) |
| **ghostfolio** / **grafana** / **alerting** / **cluster** | Réponses cadrées sur une source live précise |

---

> Catalogue lié à l'implémentation réelle (`stt/client/stt/portal/intents.py`,
> `stt/server/stt_server/tools.py`, `contexts.py`). Vue d'ensemble :
> [`docs/stt-presentation.md`](stt-presentation.md) · détails : [`admin/ia/stt.md`](../admin/ia/stt.md).