Files
nas-runbooks/common/ecriture-naturelle-firecrawl-4-instances.md

3.2 KiB

Écriture naturelle + accès Firecrawl sur les 4 instances Hermes (19/07/2026)

Contexte

Nabil a demandé d'appliquer deux choses à hermes-tt, hermes-nyora, hermes-perso (NAS) et hermes-nabil (VPS) : bannir les tics d'écriture IA, et donner accès à Firecrawl (scraping/recherche web) en usage de dernier recours, pour préserver le quota gratuit (1000 crédits/mois, un seul compte partagé entre les 4).

Règle d'écriture naturelle

Bloc "## ÉCRITURE — RÈGLE ABSOLUE" inséré dans les 4 SOUL.md, juste après le bloc "## LANGUE — RÈGLE ABSOLUE" existant. Bannit : tirets longs en cascade, formules de remplissage ("il est important de noter"), tricolons artificiels, hedging systématique, symétrie parfaite de listes, intros/conclusions génériques.

Fichier de référence livré à Nabil : HUMANISE.md (pour diffusion à d'autres agents, ex. hermes-yesmine, hors infra gérée ici).

Sauvegardes : SOUL.md.bak_ecriture_20260719 sur les 4 instances.

Accès Firecrawl

  • Clé unique FIRECRAWL_API_KEY (un seul compte Firecrawl, quota partagé) :
    • VPS hermes-nabil : dans /data/.env
    • NAS TT/Nyora/Perso : dans hermes-platform/.env (racine), injectée via docker-compose.yml (bloc environment: des 3 services hermes-agent-*)
  • Script partagé firecrawl_scrape.py (identique sur les 4 instances, seul le chemin de dépôt change) :
    • VPS hermes-nabil : /data/nyora/firecrawl_scrape.py
    • NAS TT/Perso : data/scripts/firecrawl_scrape.py (dossier déjà existant)
    • NAS Nyora : data/scripts/firecrawl_scrape.py (dossier créé, n'existait pas)
    • Usage : python3 .../firecrawl_scrape.py <url> (scrape) ou --search "requête" [n] (recherche)
  • Consigne SOUL.md ("## RECHERCHE WEB (Firecrawl)") : dernier recours seulement, pas par réflexe, pour préserver le quota partagé entre les 4 instances.

Pièges rencontrés

  • hermes-nyora/data/ n'avait pas de dossier scripts/ (contrairement à TT et Perso) — créé manuellement, cohérent avec la convention des deux autres.
  • docker compose up -d <services> interrompu par un timeout côté outil a laissé hermes-agent-nyora et hermes-agent-perso en état Created (pas démarrés) — docker start <container> explicite a suffi à débloquer, pas de recreate nécessaire une deuxième fois.
  • hermes-tt/data/, hermes-nyora/data/, hermes-perso/data/ sont dans le .gitignore de hermes-platform (volumes runtime + secrets) — aucun commit Git à faire pour les SOUL.md, seule la sauvegarde .bak_* fait foi. Seul docker-compose.yml (hors data/) a été commité.
  • Une insertion de bloc dans le SOUL.md de hermes-nabil avait été faite sans accents par accident (héritage du style non accentué du reste du fichier, qui n'a jamais été ré-accentué au-delà des blocs de règles eux-mêmes) — corrigé immédiatement. Le corps du SOUL.md hermes-nabil hors blocs de règles reste globalement non accentué : ré-accentuation complète non faite, à prévoir si ça devient gênant.

Vérification

Testé en réel sur les 4 instances après déploiement : script exécuté avec --search "test", résultat renvoyé correctement partout, FIRECRAWL_API_KEY confirmée présente dans l'environnement des containers NAS.