Lancer et planifier des tâches

Introduction

Une fois votre agent configuré et testé, vous pouvez l’exécuter de deux manières :

Exécution immédiate

Lancez une tâche maintenant et obtenez les résultats instantanément

Planification

Programmez des exécutions automatiques selon un calendrier

Exécution immédiate

Lancer une tâche manuellement

Dans la page des tâches, invoquez vos agents en utilisant le symbole ”@” pour sélectionner l’agent que vous souhaitez exécuter. Comment tester votre Agent

Sélectionnez votre agent

Dans la page des tâches, sélectionnez l’agent que vous souhaitez exécuter @nom_agent

Fournissez les paramètres

Si l’agent nécessite des données d’entrée, remplissez le formulaire

Lancez l'exécution

Cliquez sur “Exécuter” pour démarrer la tâche

Orchestration d’agents

Qu’est-ce que l’orchestration d’agents ?

L’orchestration d’agents vous permet de créer des équipes d’agents qui collaborent pour accomplir des tâches complexes. Chaque agent a son rôle spécialisé, et ensemble ils forment un système intelligent et coordonné.

@analyst lis ce document et donne un court résumé @planner utilise le résumé pour planifier les prochaines étapes

Pourquoi l’orchestration ?

Tâches complexes
Spécialisation
Scalabilité

Certaines tâches nécessitent plusieurs compétences :Exemple : Lancement de produit

Agent Marketing : Crée le contenu et les visuels
Agent Social Media : Planifie les publications
Agent Analytics : Suit les performances
Agent CRM : Met à jour les segments clients
Orchestrateur : Coordonne le tout

Suivre l’exécution en temps réel

Une fois lancée, vous pouvez surveiller votre tâche en direct :

Vue en temps réel
Détails techniques
Résultats

Statut

En cours, Réussi, Échoué, En attente

Progression

Étape actuelle et % d’avancement

Logs live

Chaque action effectuée en direct

Interface de monitoring

┌─────────────────────────────────────────────────┐
│  🤖 Agent : Analyse quotidienne des ventes      │
│  📊 Statut : En cours...                        │
│  ⏱️  Durée : 00:02:34                            │
│  💰 Coût : 0.23 crédits                         │
└─────────────────────────────────────────────────┘

✅ [00:00:05] Connexion à Shopify réussie
✅ [00:00:12] Récupération de 247 commandes
🔄 [00:01:45] Analyse des données en cours...
   └─ Modèle : GPT-4
   └─ Tokens : 1,234 / 4,000
   └─ Progression : 67%

⏳ En attente : Génération du rapport PDF

Planification de tâches

Créer une planification

Accédez à la planification

Dans la page de votre agent, cliquez sur “Planifier”

Choisissez la fréquence

Sélectionnez parmi les options prédéfinies ou créez une règle personnalisée

Définissez les paramètres

Heure, fuseau horaire, et éventuels paramètres d’entrée

Activez la planification

Sauvegardez et activez pour démarrer l’automatisation

Fréquences prédéfinies

Horaire
Quotidien
Hebdomadaire
Mensuel

⏰ Toutes les heures
⏰ Toutes les 2 heures
⏰ Toutes les 6 heures
⏰ Toutes les 12 heures

Cas d’usage : Monitoring, alertes temps réel, veille concurrentielle

📅 Tous les jours à 9h00
📅 Tous les jours ouvrés (Lun-Ven)
📅 Tous les jours à 8h et 18h
📅 Toutes les nuits à 2h00

Cas d’usage : Rapports quotidiens, synchronisation de données, sauvegardes

📆 Tous les lundis à 9h00
📆 Tous les vendredis à 17h00
📆 Mardi et jeudi à 14h00
📆 Chaque fin de semaine

Cas d’usage : Rapports hebdomadaires, nettoyage de données, récapitulatifs

📊 Le 1er de chaque mois à 8h00
📊 Le dernier jour du mois à 23h59
📊 Le 15 de chaque mois
📊 Début de trimestre

Cas d’usage : Facturation, rapports mensuels, analyses financières

Planification personnalisée (Cron)

Pour des besoins spécifiques, utilisez la syntaxe cron :

# Format : minute heure jour mois jour_semaine

# Tous les jours ouvrés à 9h00
0 9 * * 1-5

# Tous les lundis et mercredis à 14h30
30 14 * * 1,3

# Le 1er et le 15 de chaque mois à 8h00
0 8 1,15 * *

# Toutes les 15 minutes
*/15 * * * *

# Tous les jours à 9h, 12h et 18h
0 9,12,18 * * *

# Le dernier jour de chaque mois à minuit
0 0 28-31 * *

Outil de test : Utilisez crontab.guru pour vérifier votre syntaxe cron et visualiser les prochaines exécutions.

Gestion du fuseau horaire

Important : Spécifiez toujours le fuseau horaire pour éviter les confusions, surtout si votre équipe est distribuée géographiquement.

Exemples de fuseaux horaires

timezone: "Europe/Paris"      # France
timezone: "Europe/London"     # UK
timezone: "America/New_York"  # EST
timezone: "America/Los_Angeles"  # PST
timezone: "Asia/Tokyo"        # Japon
timezone: "UTC"               # Temps universel

Gestion des planifications actives

Vue d’ensemble

Accédez à toutes vos planifications depuis le tableau de bord :

Actives

Planifications en cours d’exécution

Pausées

Temporairement désactivées

Historique

Exécutions passées

Actions disponibles

Pause / Reprise
Modification
Duplication
Suppression

Mettez en pause une planification sans la supprimer :

Utile pour les maintenances
Conserve tous les paramètres
Réactivation en un clic

Exécutions déclenchées par événement

Au-delà de la planification temporelle, vos agents peuvent être déclenchés par des événements.

Webhooks

Déclenchez votre agent depuis une application externe :

curl -X POST https://app.scalt.ai/api/webhook/your-agent-id \
  -H "Authorization: Bearer YOUR_WEBHOOK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_email": "[email protected]",
    "order_id": "ORD-12345",
    "amount": 299.99
  }'

Événements d’intégration

Déclenchez automatiquement sur des événements de vos outils :

Email reçu

trigger:
  type: "event"
  source: "gmail"
  event: "email_received"
  filters:
    from: "*@client-vip.com"
    subject_contains: "urgent"

Nouvelle commande

trigger:
  type: "event"
  source: "shopify"
  event: "order_created"
  filters:
    amount_greater_than: 1000
    status: "paid"

Message Slack

trigger:
  type: "event"
  source: "slack"
  event: "message_posted"
  filters:
    channel: "#support"
    mentions_bot: true

Formulaire soumis

trigger:
  type: "event"
  source: "typeform"
  event: "form_submitted"
  filters:
    form_id: "xyz123"

File d’attente et priorités

Gestion de la file d’attente

Quand plusieurs tâches sont déclenchées simultanément :

FIFO (First In, First Out)

Par défaut, ordre d’arrivée

Priorité

Tâches urgentes traitées en premier

Parallélisation

Exécutions simultanées si autorisé

Rate limiting

Limitation du nombre d’exécutions par période

Définir les priorités

Configuration des priorités

queue:
  strategy: "priority"  # fifo, priority, parallel
  
  priority_rules:
    - condition: ${input.customer_tier} == "vip"
      priority: 1  # Plus haut = plus prioritaire
    
    - condition: ${input.amount} > 10000
      priority: 2
    
    - default_priority: 5
  
  concurrency:
    max_parallel: 3  # Maximum 3 exécutions simultanées
    per_minute: 10   # Maximum 10 exécutions par minute

Arrêter une exécution en cours

Si vous devez interrompre une tâche :

Accédez à l'exécution

Depuis le tableau de bord ou la page de l’agent

Cliquez sur Arrêter

Bouton “Arrêter l’exécution”

Choisissez le mode

Gracieux : Termine l’étape en cours puis arrête
Immédiat : Arrête instantanément

Confirmez

L’exécution est marquée comme “Annulée”

Attention : Un arrêt immédiat peut laisser des actions incomplètes (email envoyé mais ticket non créé, etc.).

Historique d’exécution

Consulter l’historique

Toutes les exécutions sont enregistrées et consultables :

Vue liste
Vue détaillée
Analytics

Aperçu de toutes les exécutions :

Date et heure
Durée
Statut (Succès / Échec)
Coût en crédits
Déclencheur (Manuel / Planifié / Événement)

Filtrer et rechercher

Filtres disponibles :
- 📅 Période : Dernières 24h, 7 jours, 30 jours, Personnalisé
- ✅ Statut : Tous, Succès, Échoué, En cours, Annulé
- 🚀 Déclencheur : Tous, Manuel, Planifié, Webhook, Événement
- 🏷️ Tags : Filtrer par tags d'agent
- 💰 Coût : Min / Max crédits

Exporter l’historique

Sélectionnez la période

Choisissez la plage de dates à exporter

Choisissez le format

CSV, JSON, ou Excel

Configurez les colonnes

Sélectionnez les données à inclure

Exportez

Téléchargez ou recevez par email

Notifications (bientôt disponible)

Restez informé des exécutions de vos agents.

Événements de notification

on_start

Quand l’exécution démarre

on_success

Exécution réussie

on_failure

Exécution échouée

on_retry

Lors d’une nouvelle tentative

on_timeout

Dépassement du timeout

on_cancel

Exécution annulée

Quotas et limites

Surveillez votre consommation :

Crédits

Consommation mensuelle de crédits

Exécutions

Nombre d’exécutions par jour/mois

Durée

Temps d’exécution total

Alertes de quota

Configurez des alertes avant d’atteindre vos limites :

quota_alerts:
  credits:
    threshold: 80  # Alert at 80% of monthly quota
    recipients: ["[email protected]"]
  
  executions:
    threshold: 90  # Alert at 90% of monthly executions
    recipients: ["[email protected]"]

Bonnes pratiques

Planification

Évitez les heures de pointe pour les tâches lourdes
Espacez les exécutions pour ne pas surcharger les APIs tierces
Utilisez des fuseaux horaires explicites
Testez d’abord avec une fréquence faible

Fiabilité

Configurez toujours une stratégie de réessai
Activez les notifications d’échec
Surveillez régulièrement l’historique
Gardez un agent de secours (fallback)

Coûts

Utilisez des modèles économiques pour les tâches simples
Limitez le nombre d’exécutions parallèles
Archivez les agents obsolètes
Surveillez la consommation de crédits

Performance

Optimisez les workflows pour réduire le temps d’exécution
Utilisez le cache quand possible
Évitez les boucles infinies
Limitez la taille des données traitées

Dépannage

L’agent ne s’exécute pas

Vérifiez que la planification est active

Statut “Activé” dans la liste des planifications

Contrôlez la syntaxe cron

Utilisez un validateur de cron

Vérifiez le fuseau horaire

Assurez-vous qu’il correspond à vos attentes

Consultez les quotas

Vérifiez que vous n’avez pas atteint vos limites

Exécutions qui échouent

Checklist de diagnostic

✅ Toutes les intégrations sont connectées
✅ Les credentials sont valides et à jour
✅ Les paramètres d’entrée sont corrects
✅ Le timeout est suffisant
✅ Les APIs tierces sont accessibles
✅ Les quotas des services externes ne sont pas atteints

Commencer

Guides essentiels

À venir

​Introduction

Exécution immédiate

Planification

​Exécution immédiate

​Lancer une tâche manuellement

​Orchestration d’agents

​Qu’est-ce que l’orchestration d’agents ?

​Pourquoi l’orchestration ?

​Suivre l’exécution en temps réel

Statut

Progression

Logs live

​Interface de monitoring

​Planification de tâches

​Créer une planification

​Fréquences prédéfinies

​Planification personnalisée (Cron)

​Gestion du fuseau horaire

​Gestion des planifications actives

​Vue d’ensemble

Actives

Pausées

Historique

​Actions disponibles

​Exécutions déclenchées par événement

​Webhooks

​Événements d’intégration

​File d’attente et priorités

​Gestion de la file d’attente

FIFO (First In, First Out)

Priorité

Parallélisation

Rate limiting

​Définir les priorités

​Arrêter une exécution en cours

​Historique d’exécution

​Consulter l’historique

​Filtrer et rechercher

​Exporter l’historique

​Notifications (bientôt disponible)

​Événements de notification

on_start

on_success

on_failure

on_retry

on_timeout

on_cancel

​Quotas et limites

Crédits

Exécutions

Durée

​Alertes de quota

​Bonnes pratiques

​Dépannage

​L’agent ne s’exécute pas

​Exécutions qui échouent

​Prochaines étapes

Surveiller les performances

API Reference

Introduction

Exécution immédiate

Lancer une tâche manuellement

Orchestration d’agents

Qu’est-ce que l’orchestration d’agents ?

Pourquoi l’orchestration ?

Suivre l’exécution en temps réel

Interface de monitoring

Planification de tâches

Créer une planification

Fréquences prédéfinies

Planification personnalisée (Cron)

Gestion du fuseau horaire

Gestion des planifications actives

Vue d’ensemble

Actions disponibles

Exécutions déclenchées par événement

Webhooks

Événements d’intégration

File d’attente et priorités

Gestion de la file d’attente

Définir les priorités

Arrêter une exécution en cours

Historique d’exécution

Consulter l’historique

Filtrer et rechercher

Exporter l’historique

Notifications (bientôt disponible)

Événements de notification

Quotas et limites

Alertes de quota

Bonnes pratiques

Dépannage

L’agent ne s’exécute pas

Exécutions qui échouent

Prochaines étapes