Docs · La doctrine · Section 08
Travail asynchrone et ordonnancement
Un système agentique de qualité fait peu de choses pendant que l'utilisateur attend, et beaucoup de choses quand il a le dos tourné. Le tour interactif reste mince ; le travail lourd, coûteux ou différé est repoussé en arrière-plan. Cette section est le runbook de cette séparation : ce qui se fait en synchrone, ce qui se fait en asynchrone, par quels déclencheurs, et sous quels garde-fous.
Règle directrice : tout ce qui n'est pas nécessaire à la réponse du tour courant sort du tour. Extraction, consolidation, synchronisation, résumés, rappels : en arrière-plan. Le tour interactif ne paie que la latence indispensable.
Deux régimes : événementiel et ordonnancé
| Régime | Déclencheur | Usage |
|---|---|---|
| Événementiel | Un événement métier est émis (fin de tour, fin de session, rappel créé) | Réaction immédiate mais hors tour : on traite dès que possible, sans bloquer l'utilisateur. |
| Ordonnancé | Une horloge (expression cron) déclenche à heure fixe | Entretien périodique : décroissance, élagage, nettoyage, détection de tendances. |
Schéma, le pipeline post-tour et l'ordonnanceur
1 Le pipeline post-tour
Après chaque tour, un événement est émis et un pipeline asynchrone se déclenche. Il enchaîne des étapes indépendantes : détecter les engagements pris, détecter les suivis à programmer, extraire les faits à mémoriser, décider si un résumé de conversation est nécessaire, et préchauffer le contexte profond pour le prochain tour. Chaque étape est isolée : elle a son propre nouvel essai, et l'échec d'une étape ne fait pas échouer les autres. C'est aussi ici que se calcule l'importance des souvenirs, comme sous-produit de l'extraction, sans appel de modèle dédié.
Le tour dépose enfin, à l'émission, son empreinte de provenance : un identifiant de requête et la signature de ce qui a été réellement injecté dans le contexte. C'est elle qui permet de rejouer exactement ce que le modèle a vu, même après que la mémoire de travail a oublié (cf. section 07). Et cette même trace alimente l'évaluation comportementale : un seul flux émis par le middleware, plusieurs consommateurs, provenance, évaluation (section 12) et observabilité.
2 Le pipeline de fin de session
À la clôture d'une session, un second pipeline archive la session, extrait et structure son contenu vers le graphe de connaissances, en dérive les faits durables, et journalise l'activité. Les opérations indépendantes y sont lancées en parallèle, puis recombinées.
3 L'ordonnanceur périodique
L'entretien du système est confié à des tâches planifiées par expression cron. Exemples de cadence, lisibles directement dans la configuration :
| Tâche | Cadence (cron) | Rôle |
|---|---|---|
| Décroissance mémoire | 0 4 * * * (quotidien, 04:00) | Met à jour le score de valeur des souvenirs ; gate la récupération, ne supprime pas. |
| Élagage des liens | 0 5 * * 0 (hebdo, dimanche 05:00) | Élague les seuls liens dérivés invalidés et anciens, sous rétention. |
| Archivage à froid | 0 2 * * 0 (hebdo, dimanche 02:00) | Compacte et refroidit les segments anciens du journal, conservés pour l'audit. |
| Détection de tendances | 0 3 * * 1 (hebdo, lundi 03:00) | Repère des patterns récurrents à capitaliser. |
| Rappels d'expiration | 0 9 * * * (quotidien, 09:00) | Émet les rappels arrivés à échéance. |
| Effacement imposé | Sur demande | Rend illisible la donnée d'un sujet (effacement légal) sans rompre la chaîne d'audit. |
4 Garde-fous de l'asynchrone
Un travail de fond mal gardé est pire que pas de travail de fond. Quatre garde-fous sont systématiques :
- Nouvel essai par étape : chaque étape se rejoue indépendamment, avec un nombre d'essais borné, sans rejouer ce qui a réussi.
- Idempotence : une tâche rejouée ne produit pas de doublon ; l'effet est le même qu'elle tourne une ou trois fois. C'est elle qui protège la cohérence quand une tâche est livrée ou rejouée plusieurs fois, y compris sous concurrence. La question de l'ordre, distincte, relève de la causalité (section 07), pas de l'idempotence.
- Concurrence bornée : le nombre de tâches simultanées est plafonné, et souvent cloisonné par utilisateur, pour éviter qu'un acteur sature la file.
- Observabilité des jobs : chaque exécution est tracée, le retard de la file et le taux d'échec sont des métriques de premier plan.
Runbook, synchrone ou asynchrone
| Opération | Où |
|---|---|
| Produire la réponse du tour | Synchrone |
| Récupération mémoire du niveau requis pour répondre | Synchrone, étagée |
| Extraction de faits, consolidation, mise au graphe | Asynchrone, post-tour |
| Archivage et résumé de session | Asynchrone, fin de session |
| Décroissance, élagage, nettoyage, tendances | Asynchrone, ordonnancé |
| Préchauffage du contexte du prochain tour | Asynchrone, post-tour |