Clustraly
Cocon sémantique & topic clusters

Vos grandes cartes se construisent seules avec le worker de file d'attente (cocon_build auto-replanifiée)

Worker de file d'attente (tâche cocon_build auto-replanifiée) est une fonctionnalité du module Cocon sémantique & topic clusters de Clustraly. Le worker de file d'attente est une tâche cocon_build auto-replanifiée qui construit votre carte topique par lots, en tâche de fond, résumable au crash.

Vous lancez le build, le worker fait le reste : il revendique le job, étend l'arbre par tranches courtes, cède la main, puis reprend au tick suivant jusqu'à l'achèvement. L'IA propose les branches, vous gardez la main sur le rythme, le plafond et le budget.

Sans blocage

Vos grandes cartes se construisent en tâche de fond, pas dans votre navigateur

Fini l'onglet qui tourne pendant que l'arbre se génère. Le worker prend le relais côté serveur : il étend la frontière de votre carte par tranches d'environ 45 secondes, puis se remet en file pour continuer au tick suivant. Vous fermez l'écran, le build avance.

Le worker travaille en largeur d'abord (breadth-first), niveau par niveau, pour que la structure prenne forme de façon lisible dès les premiers nœuds.

  • Traitement côté serveur, jamais bloqué dans votre onglet
  • Tranches d'environ 45 s qui rendent la main proprement
  • Construction breadth-first, niveau par niveau
Chaîne auto-replanifiée

Une chaîne qui se relance toute seule et ne perd jamais le fil

À chaque tick, cronTick sélectionne le prochain job en file et maintient la chaîne vivante. processJob revendique le job de façon atomique (queued → running), crée la racine une seule fois, avance, puis se re-met en file au lieu de tout faire d'un coup.

Si un job « running » se fige (heartbeat périmé au-delà de 5 minutes), le worker le récupère au tick suivant. Rien ne reste coincé en silence.

  • Revendication atomique queued → running
  • Racine créée une seule fois, sans doublon
  • Jobs figés récupérés après heartbeat périmé (> 5 min)
Expansion par lots

Chaque lot appelle l'IA une fois et propose jusqu'à 12 enfants déjà typés

expandBatch regroupe les parents et fait un seul appel IA par lot, qui propose jusqu'à 12 enfants chacun. Chaque nœud arrive déjà cadré : page_type, funnel_stage et schema_type sont assainis par ENUM, et les mots-clés sont dédupliqués à l'échelle du projet.

L'IA propose les branches ; vos garde-fous de typage et de déduplication décident de ce qui entre réellement dans l'arbre.

  • Un seul appel IA par lot de parents
  • page_type, funnel_stage et schema_type validés par ENUM
  • Déduplication des mots-clés sur tout le projet
Garde-fous

Budget respecté, plafond fixé, reprise après un crash

Le worker est budget-aware : quand le budget IA est bloqué, il passe en « waiting_budget » et attend au lieu de dépenser. Un garde anti-poison arrête le job après 10 échecs de lot consécutifs, pour ne pas s'acharner. Et comme le build est checkpointé, il reprend là où il s'était arrêté après un crash ou un redémarrage serveur.

Vous fixez le plafond absolu de nœuds (advanced.cocon_max_nodes, 20 000 par défaut) : l'arbre ne dépasse jamais la taille que vous autorisez.

  • Mise en attente propre sur blocage budget (waiting_budget)
  • Arrêt anti-poison après 10 échecs de lot consécutifs
  • Reprise au point d'arrêt après un crash
  • Plafond de nœuds sous votre contrôle
Anticipation

Vous connaissez l'effort avant de lancer, pas après

estimate() pré-calcule la cible, le nombre effectif de nœuds, le facteur de branchement et une approximation des appels IA nécessaires. Vous décidez de lancer, d'ajuster le plafond ou la profondeur en connaissance de cause.

  • Cible et nœuds effectifs calculés d'avance
  • Facteur de branchement estimé
  • Nombre d'appels IA approximatif annoncé
Clôture propre

À l'achèvement, une version est sauvegardée et le projet passe en « ready »

Quand la frontière est entièrement étendue, complete() enregistre un instantané de l'arbre et bascule le projet en « ready ». Vous repartez d'un état net et versionné, prêt pour l'édition manuelle ou la rédaction.

L'IA a construit la structure ; à vous de valider, retoucher ou lancer la suite quand la carte est prête.

  • Instantané de l'arbre sauvegardé automatiquement
  • Projet basculé en statut « ready »
  • Base saine pour éditer ou rédiger ensuite
Pourquoi ça compte

Pensé pour les cartes que la requête HTTP ne peut pas finir toute seule

Des dizaines aux dizaines de milliers de nœuds : le worker prend en charge les builds trop gros pour une seule requête, les découpe en lots, les cadence sur votre budget IA et les reprend au moindre incident. Vous pilotez depuis le dashboard de la file de builds ; l'IA construit, vous décidez du rythme et des limites.

FAQ

Questions fréquentes

Que signifie « auto-replanifiée » pour la tâche cocon_build ?
Au lieu de tout construire d'un seul coup, processJob avance par tranches d'environ 45 secondes puis se re-met en file. cronTick relance ensuite le prochain job et maintient la chaîne vivante, tick après tick, jusqu'à l'achèvement.
Que se passe-t-il si le serveur redémarre ou crashe pendant un build ?
Le build est checkpointé et résumable : il reprend là où il s'était arrêté. Si un job « running » reste figé au-delà de 5 minutes (heartbeat périmé), le worker le récupère au tick suivant.
Le worker peut-il dépasser mon budget IA ?
Non. Le worker est budget-aware : quand le budget IA est bloqué, il passe en « waiting_budget » et attend, au lieu de continuer à dépenser. Il reprend l'expansion une fois le budget de nouveau disponible.
Puis-je limiter la taille de l'arbre généré ?
Oui. Vous fixez un plafond absolu de nœuds via advanced.cocon_max_nodes (20 000 par défaut). estimate() vous donne aussi, en amont, la cible, le branchement et le nombre approximatif d'appels IA pour décider avant de lancer.
Prêt à commencer ?

Lancez un build, laissez le worker faire le reste

Mettez votre carte en file depuis le module Cocon Sémantique : le worker la construit par lots, en tâche de fond, dans les limites que vous fixez, se met en pause sur votre budget si besoin, reprend après un incident, puis sauvegarde une version et bascule le projet en « ready » une fois terminé. L'IA propose, vous décidez.