Automatisation et planification
Tâches cron
Planifiez des réveils d'agents avec une précision temporelle. Les tâches cron persistent après les redémarrages du Gateway et prennent en charge des modèles de planification flexibles.
Types de planification
| Type | Description | Exemple |
|---|---|---|
| Expression cron | Syntaxe cron standard avec fuseau horaire | 0 7 * * * (tous les jours à 7h) |
| Intervalle | Répéter à intervalles fixes | 30m, 2h, 1d |
| Ponctuel | Exécuter une fois à un moment précis | 2026-03-15T16:00:00Z |
Cibles de session
- Session principale, Mettre en file d'attente comme événement système dans la conversation principale de l'agent
- Session isolée, Exécuter dans une session dédiée (
cron:<jobId>) pour éviter de contaminer les conversations principales
Modes de livraison
| Mode | Description |
|---|---|
| Aucun | Exécution silencieuse (aucune sortie publiée) |
| Annoncer | Publier le résultat sur un canal spécifique |
| Webhook | HTTP POST du résultat vers une URL externe |
Rappels ponctuels
Définissez un rappel pour un moment précis. L'agent se réveille, traite le rappel et supprime optionnellement la tâche après exécution.
Tâches récurrentes
Planifiez des tâches répétitives avec des expressions cron et la prise en charge des fuseaux horaires. Les tâches suivent leur historique d'exécution (succès, échec, timing).
Webhooks
Recevez des événements de services externes et acheminez-les vers des agents.
Gmail Pub/Sub
Intégrez le système de notification push de Gmail pour déclencher des actions d'agent lorsque des e-mails arrivent :
- Configurez un sujet et un abonnement GCP Pub/Sub
- Configurez le filtrage des étiquettes Gmail
- Dirigez la livraison push vers votre URL de webhook
- Neotask reçoit les messages et met en file d'attente les événements d'agent
Webhooks personnalisés
Enregistrez des points de terminaison HTTP qui déclenchent des tours d'agent lorsqu'ils sont appelés. Utile pour l'intégration avec des pipelines CI/CD, des systèmes de surveillance ou tout service pouvant envoyer des requêtes HTTP.
Événements système
Les événements système sont des signaux qui réveillent un agent pour traitement :
- Immédiat, Traiter au prochain battement de cœur
- Prochain battement de cœur, Mettre en file d'attente pour la prochaine vérification planifiée
Utilisez les événements système pour les workflows réactifs, les agents se réveillent quand quelque chose se produit plutôt que sur un calendrier fixe.
Battement de cœur
Le battement de cœur est un signal périodique (environ 15 secondes par défaut) qui donne aux agents la possibilité de traiter le travail en attente :
- Vérifier les nouveaux événements système
- Traiter les messages en file d'attente
- Exécuter les automatisations en attente
Le battement de cœur peut être activé, désactivé ou configuré par agent.
Hooks
Automatisation pilotée par événements qui déclenche des commandes shell ou des scripts en réponse aux événements du Gateway :
- Sur message, Exécuter lorsqu'un message est reçu
- Sur un tour d'agent, Exécuter avant ou après qu'un agent traite un message
- Sur un événement de canal, Exécuter sur des événements spécifiques au canal (rejoindre, quitter, réaction)
Les hooks s'exécutent sur l'hôte du Gateway et ont accès aux données de contexte de l'événement.
Cas d'utilisation
| Scénario | Solution |
|---|---|
| Briefing matinal quotidien | Tâche cron à 7h → l'agent résume les mises à jour nocturnes |
| Génération de rapport hebdomadaire | Tâche cron tous les lundis → l'agent génère et envoie le rapport par e-mail |
| Surveillance des e-mails | Webhook Gmail → l'agent traite les e-mails entrants |
| Notifications de build | Webhook CI/CD → l'agent annonce les résultats de build sur Discord |
| Vérification horaire des données | Cron basé sur un intervalle → l'agent vérifie le tableau de bord et alerte sur les anomalies |
| Publications sociales planifiées | Tâche cron → l'agent rédige et publie du contenu aux moments optimaux |