nas-runbooks/common/tourisme-tunisie-skill.md

2.1 KiB

Runbook — Skill hermes tourisme-tunisie

Date : 2026-07-16 | Instance : common (tap partage) | Statut : Deploye

Objet

Skill donnant aux agents Hermes la capacite de proposer des lieux a visiter en Tunisie autour d'un point (sites historiques, musees, plages, parcs). Usage perso/famille.

Emplacement

Tap Gitea bolbol/hermes-skills, dossier skills/tourisme-tunisie/ :

  • SKILL.md : quand l'utiliser + methodologie de presentation (proximite d'abord, melange des registres, time-sensitive musees ~16h, sites isoles = lampe/pas seul, fusion doublons FR/AR, pas d'accents sur Gabes/Kebili/Medenine).
  • find_places.py : script autonome, Python stdlib seulement.

Chaine technique (0 cle API, 0 cout)

  • Geocodage : Nominatim (countrycodes=tn, 1 req/s).
  • POI : Overpass QL (tourism|historic|natural=beach|leisure=park, around:rayon).
  • PIEGE EGRESS NAS : depuis les conteneurs, les miroirs Overpass classiques (overpass-api.de, kumi, private.coffee) timeout (>20-120 s). Seul https://maps.mail.ru/osm/tools/overpass/api/interpreter repond vite (~5 s). → il est mis EN TETE de la liste OVERPASS, ne pas retirer. Bascule auto ensuite.
  • Sortie : liste triee par distance, categorie, lien OSM, horaires si dispo. --json pour l'agent.

Usage

python3 find_places.py --near "Salakta, Mahdia" --radius 12 --limit 18
python3 find_places.py --lat 35.39 --lon 11.04 --radius 15
python3 find_places.py --near "Mahdia" --json

Rayons conseilles

Littoral Sahel dense : 10-12 km. Zone rurale / gouvernorats sud : 25-40 km.

Deploiement (git absent du NAS → API Gitea)

Push via POST /api/v1/repos/bolbol/hermes-skills/contents/<path> (token GITEA_DEPLOY_TOKEN, base64, branche main). Le tap est pull au demarrage de session : nouveau skill visible a la session suivante sans restart (si absent, recreer le conteneur force le re-pull).

Valide le 16/07/2026

Tests reels OK sur Salakta (musee + necropole + thermes + plages) et Mahdia (Skifa El Kahla, musee regional avec horaires, forts, palais fatimide).

Limites

Horaires OSM peu fiables → confirmer sur place. Villes industrielles (Ksar Hellal) = vide normal.