AI Task Scheduler — Guide utilisateur | YoBench

À quoi sert le module « AI Task Scheduler »

AI Task Scheduler exécute l\'assistant IA selon un planning. Vous définissez un prompt, choisissez un fournisseur et un contexte, attachez un éventuel jeu d\'outils, puis indiquez au planificateur quand le lancer — chaque minute, chaque heure, chaque jour, chaque semaine ou chaque mois. L\'assistant s\'exécute de façon autonome ; s\'il propose un plan jugé dangereux, l\'exécution se met en pause sur une invite Approve / Deny claire au lieu d\'échouer.

Ce que vous obtenez :

• Exécutions IA pilotées par cron — cinq types de planning (minute, heure, jour, semaine, mois).
• Lancements manuels à la demande — Run Now sur n\'importe quelle tâche.
• Isolation par tâche — chaque tâche choisit son fournisseur, son contexte, son system prompt, sa température, son nombre maximum d\'itérations et ses outils autorisés.
• Flux d\'approbation — les plans dangereux sont conservés en pending_approval afin que vous puissiez les relire avant la suite.
• Timeline en direct — les messages et les résultats des outils s\'affichent en temps réel pendant l\'exécution.
• Historique des exécutions avec statut, type de déclencheur, durée, tokens et coût.
• Annulation liée au scope — chaque exécution porte une clé de scope unique ; les outils longs sont nettoyés en cas d\'annulation.

Concepts

Types de planning

Les plannings sont stockés sous forme de schedule_type plus quelques champs auxiliaires, et traduits en expression cron à la volée.

Les déclencheurs manuels (Run Now) ignorent le planning.

Contrôle des outils

Chaque tâche peut :

• S\'exécuter avec tous les outils disponibles (mode hérité / nouvelles tâches où tools_enabled est actif et la liste d\'outils est vide), ou
• S\'exécuter avec une liste blanche — choisissez les identifiants d\'outils que l\'assistant peut appeler (recherche web, automatisation navigateur, terminal, système de fichiers, outils documents, etc.), ou
• S\'exécuter avec les outils complètement désactivés — l\'assistant n\'a que son prompt et son contexte.

C\'est le levier principal pour rendre une tâche planifiée sûre : un rapport quotidien n\'a sans doute pas besoin d\'accès au terminal ; une tâche de revue de code ne voudra peut-être que web et browser.

Flux d\'approbation

Le pipeline tourne en mode autonome — chaque plan qui n\'est pas marqué comme dangereux s\'exécute sans demander. Quand l\'assistant émet un plan avec requiresConfirmation = true :

1. L\'exécution passe en pending_approval.
2. Le plan est sauvegardé ; l\'exécution est mise en pause.
3. L\'UI affiche le plan avec deux boutons : Approve et Deny.
4. Approve — le pipeline reprend depuis le point sauvegardé.
5. Deny — l\'exécution se termine avec le statut cancelled et la raison « Rejected by user ».

Les approbations en attente sont visibles à la fois sur la vue de l\'exécution et dans une liste dédiée Pending Approvals en haut de la page, pour qu\'aucune ne se perde.

Cycle de vie d\'une exécution

le planning se déclenche (ou Run Now)
        │
        ▼
   création de l\'exécution
   status = running
        │
        ▼
  ─── les messages arrivent dans la timeline ───
        │
        ├─ done            → status = done
        ├─ error           → status = error  (message d\'erreur sauvegardé)
        ├─ annulation user → status = cancelled
        └─ plan dangereux  → status = pending_approval
                                  │
                                  ├─ approve → status = running → reprend
                                  └─ deny    → status = cancelled

Chaque exécution enregistre : le déclencheur, les horodatages de début et de fin, la durée, l\'usage de tokens, le coût en dollars, le message d\'erreur (s\'il y en a un) et le journal complet des messages.

Réglages

On crée une tâche depuis Scheduler → Create, qui ouvre le drawer du formulaire. Champs :

• Title — nom d\'affichage.
• Prompt — l\'instruction principale que l\'assistant exécute à chaque tic.
• System Prompt — rôle / comportement persistant optionnel. Vide par défaut.
• Provider — le fournisseur IA utilisé par l\'exécution.
• Context — contexte RAG optionnel injecté dans l\'exécution.
• Temperature — 0.0 – 1.0, 0.3 par défaut.
• Max auto-iterations — plafond de tours d\'utilisation d\'outils dans une exécution, 5 par défaut.
• Schedule type + les champs heure / jour de la semaine / jour du mois correspondants.
• Is active — interrupteur pour mettre le planning en pause sans supprimer la tâche.
• Tools enabled — interrupteur global pour le jeu d\'outils.
• Allowed tools — multi-sélection, utilisée quand les outils sont activés.

Le formulaire peut aussi enregistrer un brouillon de la tâche sans l\'activer.

Flux d\'utilisation

1. Créez une tâche planifiée

1. Ouvrez Scheduler depuis la barre latérale.
2. Cliquez sur Create → le drawer de la tâche apparaît.
3. Renseignez le titre, le prompt et choisissez un fournisseur.
4. (Optionnel) attachez un contexte, durcissez le system prompt, baissez la température.
5. Choisissez le type de planning et l\'horaire.
6. Choisissez la politique d\'outils : activés + liste blanche, activés + ouverte, ou désactivés.
7. Activez Is active et enregistrez.

2. Lancez à la demande

• Ouvrez la tâche → Run Now → l\'exécution apparaît immédiatement dans la timeline.
• Regardez les messages et les résultats d\'outils défiler en direct.
• Arrêtez à tout moment avec Stop — le scope est annulé, les outils longs sont arrêtés.

3. Traitez une approbation en attente

1. Soit le badge de l\'exécution passe en jaune (pending), soit la liste Pending Approvals affiche un nouvel élément.
2. Ouvrez l\'exécution → relisez le plan proposé.
3. Approve — l\'exécution reprend. Deny — l\'exécution est annulée.

4. Examinez l\'historique

• La vue de la tâche liste chaque exécution avec son statut, son déclencheur, sa durée, son usage de tokens et son coût.
• Cliquez sur une exécution pour ouvrir le journal complet des messages et les sorties d\'outils.
• Les erreurs incluent le message complet ; les annulations enregistrent qui ou quoi les a annulées.

Astuces et limites

• Utilisez les lancements manuels pour tester un prompt avant d\'activer le planning.
• Gardez le system prompt spécifique à la tâche — la persona globale a sa place dans les réglages d\'AI Chat.
• Les chiffres de tokens / coût viennent de la réponse du fournisseur ; pour les modèles locaux auto-hébergés, le coût est affiché à zéro.
• Le planificateur tourne dans l\'application desktop — quand YoBench est fermé, le cron ne se déclenche pas. Tenez-en compte ou laissez l\'application ouverte dans le tray.
• Réglez max auto-iterations prudemment au début ; augmentez-le quand vous avez confiance dans le prompt.

Étapes suivantes

• Connectez un fournisseur IA et au moins un contexte.
• Associez une tâche planifiée au DB Manager — par exemple, un run nocturne qui résume les logs des requêtes lentes.
• Pour du travail périodique non IA (cron pur + scripts), utilisez les DB tasks embarquées ou le module Scenarios.

Aide et retour

Bug trouvé ou nouveau type de planning à proposer ? Contactez-nous via le formulaire de retour.