Workflows et tâches

Un workflow est une suite d'étapes que vos agents exécutent pour vous : lire chaque matin les nouveaux messages d'un contexte et publier un résumé, lire les documents qui arrivent et en extraire les données, répondre à un webhook d'un autre système. Vous le construisez une fois dans SweetHive et il tourne tout seul.

Les workflows s'exécutent sur vos propres ordinateurs, pas dans le cloud : sur votre SweetHive Agents Node ou sur l'Agents Server de votre entreprise. Les modèles d'IA, les documents et les données qu'ils traitent restent sur ces machines.

Tout ce qui s'exécute pour vous est listé dans My agents, Tâches : vos workflows et les demandes venant des apps SweetHive (par exemple SweetTimetable qui lit vos tickets, ou SweetReach qui crée une vidéo).

Créer un workflow

1. Ouvrez My agents et choisissez l'onglet Workflows.
2. Cliquez sur Nouveau workflow. L'éditeur s'ouvre avec une zone de travail :
   • à gauche, la liste des étapes que vous pouvez ajouter ;
   • au centre, la zone de travail avec vos étapes et les liens entre elles ;
   • à droite, les réglages de l'étape sélectionnée.
3. Cliquez sur une étape de la liste pour l'ajouter après celle qui est sélectionnée. Pour relier deux étapes, faites glisser le point à droite d'une étape vers une autre étape.
4. Choisissez l'agent avec lequel le workflow s'exécute (barre du haut). Les étapes qui lisent ou publient dans vos hives utilisent cet agent : le workflow ne voit donc jamais plus que ce que l'agent peut voir.
5. Enregistrez. Chaque modification des étapes enregistre une nouvelle version ; les exécutions déjà lancées gardent la version avec laquelle elles ont commencé.
6. Appuyez sur Exécuter pour l'essayer : chaque étape de la zone de travail affiche son état en direct (en attente, en cours, terminée, échouée) et, une fois finie, son résultat.

Quand un workflow démarre

Sélectionnez la première étape (le déclencheur) pour choisir comment le workflow démarre :

• Manuel - quand vous appuyez sur Exécuter, dans l'éditeur ou dans la liste des Workflows.
• Planifié - à heures fixes : toutes les heures, tous les jours à 8h00, du lundi au vendredi à 9h00, ou toute planification que vous écrivez (cron) dans votre fuseau horaire.
• Événement de la hive - quand il y a un nouveau message, fichier, tâche, événement ou e-mail dans un hive (éventuellement dans un seul contexte).
• Webhook - quand un autre système appelle l'URL du workflow. Le secret n'est affiché qu'une fois : copiez-le au moment de sa création.
• Événement d'une app - quand une app connectée émet un événement (par exemple un nouveau lead dans SweetCRM).

Vous pouvez mettre un workflow en pause à tout moment avec son interrupteur Actif.

Les étapes

Une étape peut utiliser les résultats des précédentes. Dans n'importe quel champ de texte, insérez une variable avec les boutons sous les réglages, par exemple {{ $steps.summary.output.text }} (le texte généré par l'étape nommée summary) ou {{ $trigger }} (ce qui a démarré le workflow). Il n'y a pas de code à écrire.

Où s'exécutent les étapes

Chaque étape s'exécute sur l'un de vos ordinateurs :

• par défaut, elle reste sur le même ordinateur que l'étape précédente (le modèle est déjà chargé, les fichiers sont déjà là) ;
• elle passe sur un autre ordinateur quand elle a besoin de quelque chose que le premier n'a pas : un modèle qui voit les images, un contexte plus grand, un render worker. Vous pouvez aussi laisser une étape s'exécuter sur n'importe quel ordinateur disponible (Où elle s'exécute dans ses réglages).

Si aucun de vos ordinateurs ne peut exécuter une étape pour le moment, la tâche attend et vous explique pourquoi (par exemple En attente d'un de vos ordinateurs : ouvrez SweetHive Agents Node et elle démarre toute seule). Elle démarre d'elle-même dès qu'un ordinateur adapté est en ligne.

Suivre vos tâches

My agents, Tâches liste ce qui est en cours et ce qui a été exécuté, les plus récentes en premier. Chaque tâche indique qui l'a lancée (un workflow ou une app), combien d'étapes sont terminées, quel ordinateur l'exécute et, quand quelque chose ne va pas, la raison en mots simples : le modèle n'est pas installé, le document est trop long pour le modèle, le lien du fichier a expiré, l'ordinateur a cessé de répondre.

• Annuler arrête une tâche en attente ou en cours.
• Réessayer relance une tâche échouée ou annulée.
• Ouvrez une tâche pour voir chaque étape, l'ordinateur et le modèle utilisés, sa durée et son résultat.

Quand le problème vient de l'ordinateur (un modèle manquant, un contexte trop petit, l'ordinateur éteint), la tâche n'épuise pas ses tentatives : elle passe sur un autre ordinateur ou elle attend. Quand le problème vient des données d'entrée (un document illisible, une réponse que le modèle n'a pas su mettre en forme), elle est relancée une fois puis signalée.

Le SweetHive Agents Node affiche la même liste dans sa section Tâches : ce qu'il fait maintenant et ce qu'il a fait récemment.

Confidentialité

• Un workflow s'exécute en tant que l'un de vos agents : il ne voit que les hives et les contextes que cet agent peut voir, et il ne peut publier que si cet agent peut publier.
• Les étapes d'IA s'exécutent sur vos ordinateurs avec des modèles locaux.
• Les fichiers passés d'une étape à l'autre sont conservés 7 jours puis supprimés. Les liens vers les documents envoyés par les apps ne sont jamais affichés dans les listes de tâches.