Skip to main content
Un agent planifié s’exécute seul, sans que vous ouvriez de conversation. Vous choisissez quand il s’exécute et ce qu’il doit faire. Chaque exécution crée une conversation dans votre compte, que vous pouvez ouvrir plus tard. Il existe deux types de déclencheurs :
  • Planning (Cron) : l’agent s’exécute à des horaires fixes, par exemple chaque jour ouvré à 08h00.
  • Événement externe : l’agent s’exécute lorsqu’un événement se produit dans une application connectée, par exemple à la réception d’un nouvel e-mail.
Les agents planifiés doivent être activés pour votre organisation (fonctionnalité Agents planifiés). Les déclencheurs d’événements externes sont une fonctionnalité distincte (Agents déclenchés). Si vous ne voyez pas la section Planification dans le constructeur d’agent, demandez à votre administrateur de l’activer.

​
Configurer un planning

Vous devez disposer des droits d’édition sur l’agent (vous l’avez créé, ou vous êtes Editor ou Propriétaire).
1

Ouvrez l'agent dans le constructeur

Ouvrez l’agent que vous souhaitez automatiser et allez dans la section Planification (« Exécuter cet agent automatiquement selon un planning. »).
2

Activez le planning

Activez le curseur à côté de Planification.
3

Choisissez le type de déclencheur

Si votre organisation a activé les déclencheurs d’événements, choisissez Planning (Cron) ou Événement externe dans Type de déclencheur. Sinon, le planning est basé sur le temps.
4

Définissez la fréquence

Choisissez une Période, puis renseignez les champs nécessaires (voir le tableau ci-dessous). Définissez la Date et heure de début si le planning doit commencer plus tard.
5

Rédigez l'invite

Dans Invite, indiquez à l’agent ce qu’il doit faire à chaque exécution, par exemple « Résumez les nouveaux tickets de support d’hier et listez les urgents. »
6

Enregistrez l'agent

Cliquez sur Enregistrer. Le planning est enregistré avec l’agent.

​
Fréquences prises en charge

Les heures utilisent le fuseau horaire de votre navigateur. Pour d’autres fréquences, ouvrez Avancé et sélectionnez Utiliser une expression cron personnalisée. Saisissez cinq champs : minute, heure, jour du mois, mois, jour de la semaine. Exemple : 0 9 * * 1 s’exécute chaque lundi à 09h00. Un planning ne peut pas s’exécuter plus souvent qu’une fois toutes les 5 minutes.

​
Déclencher un agent depuis un événement externe

Avec un déclencheur Événement externe, l’agent s’exécute lorsqu’un événement se produit dans une application que vous avez connectée, au lieu d’un horaire fixe.
1

Choisissez l'événement

Sous Événement de déclenchement, cliquez sur Sélectionner une application et un déclencheur et recherchez l’événement souhaité.
2

Connectez l'application

Si votre compte n’est pas encore connecté à cette application, cliquez sur Se connecter et authentifiez-vous. Le statut passe à Connecté.
3

Configurez le déclencheur

Renseignez les champs de Configuration du déclencheur, si l’événement en a.
4

Utilisez les données de l'événement dans l'invite

Dans Invite, tapez {{metadata}} à l’endroit où les données de l’événement (objet, expéditeur, message…) doivent apparaître. Puis cliquez sur Enregistrer.
Les déclencheurs d’événements fonctionnent via les applications que vous connectez dans WonkaChat. Il n’y a aucune URL de webhook ni aucun secret à copier ou à gérer — la connexion entre l’application et votre agent est entièrement prise en charge par la plateforme. Si aucun événement n’est listé, connectez une application prise en charge ou demandez à votre administrateur d’activer les connecteurs.

​
Consulter les résultats

Chaque exécution crée une conversation dans votre compte. Pour consulter les exécutions, ouvrez le menu ⋯ de l’agent (sur sa carte dans Agents → Tous les agents, ou dans le constructeur) et choisissez Agents planifiés · Historique. La fenêtre Historique des exécutions affiche :
  • La dernière exécution, la prochaine exécution, le nombre d’exécutions et d’échecs.
  • Une ligne par exécution avec son statut (terminée, échouée, en cours ou en attente) et son heure de début.
  • Ouvrir la conversation pour lire la conversation créée par l’exécution. Aucun message signifie que l’exécution n’a rien produit.
Depuis la même fenêtre, vous pouvez mettre en pause, reprendre ou supprimer un planning.

​
Agents partagés : pour qui le planning s’exécute

Un planning exécute l’agent sur votre propre compte, avec vos propres connexions. Lorsque quelqu’un partage avec vous un agent qui a un planning, celui-ci ne s’exécute pas pour vous par défaut. Pour l’activer, ouvrez l’agent et activez Exécuter cette planification sur mon compte. Vous pouvez le désactiver à tout moment.

​
Quand un agent est modifié, ses plannings se mettent en pause

Lorsque quelqu’un modifie un agent (instructions, outils, fichiers de connaissances…), tous les plannings de cet agent sont désactivés. Le planning affiche Agent modifié. Cela vous protège d’un agent qui se comporterait soudainement différemment pendant qu’il s’exécute sans surveillance. Vérifiez ce que fait désormais l’agent, puis réactivez le planning. Enregistrer un agent sans modification ne met pas ses plannings en pause.

​
Dépannage

Votre organisation n’a pas activé les Agents planifiés, ou vous ne pouvez pas modifier cet agent. Demandez au propriétaire de l’agent ou à votre administrateur.
Quelqu’un l’a mis en pause, ou l’agent a été modifié. Ouvrez le planning, vérifiez l’agent, puis réactivez-le.
Ouvrez l’historique des exécutions. L’erreur apparaît sous le nom de l’agent. Une cause fréquente est une application déconnectée : reconnectez-la dans Personnaliser → Connecteurs.

​
Voir aussi