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, »	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 »)

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 · détails : admin/ia/stt.md.