diff --git a/_INDEX.md b/_INDEX.md index 91027d7..4abd0ac 100644 --- a/_INDEX.md +++ b/_INDEX.md @@ -35,6 +35,7 @@ | Runbook | Date | Tags | |---------|------|------| +| [Écriture naturelle + accès Firecrawl sur les 4 instances Hermes (TT/Nyora/Perso/Nabil)](common/ecriture-naturelle-firecrawl-4-instances.md) | 2026-07-19 | hermes, soul-md, firecrawl, ecriture | | [Telegram duplication (flood control overflow-split) + Gitea auth (GITEA_DEPLOY_TOKEN)](common/telegram-flood-control-overflow-split-et-gitea-deploy-token.md) | 2026-07-16 | telegram, gitea, git, hermes | | [Fragilités de dépendances stack 43 containers](common/fragilites-dependances-stack-20260703.md) | 2026-07-03 | stack, restart, couplage | | [Correctifs fragilités appliqués (rla-api, n8n, bifrost-proxy)](common/correctifs-fragilites-application-20260704.md) | 2026-07-04 | correctifs, healthcheck | diff --git a/common/ecriture-naturelle-firecrawl-4-instances.md b/common/ecriture-naturelle-firecrawl-4-instances.md new file mode 100644 index 0000000..1746fc5 --- /dev/null +++ b/common/ecriture-naturelle-firecrawl-4-instances.md @@ -0,0 +1,56 @@ +# É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 ` (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 ` 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 ` 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.