Gérer les exécutions de workflow

Lorsqu'une action workflow au sein d'un Process Flow échoue, se bloque ou doit être relancée après une correction, la plateforme vous offre des contrôles directement sur la carte de la vue Process — et dans la vue Logs pour les exécutions autonomes.

Consulter une exécution en échec

Lorsqu'une action workflow atteint l'état terminal failed, la carte de l'action dans la vue Process affiche :

• Un résumé de l'échec en ligne — la chaîne output.reason et les éventuelles erreurs par bloc collectées dans les spans de trace de l'exécution.
• Un bouton « Open full run » (actions adossées à un canevas uniquement), situé dans la section Workflow de la carte, qui ouvre un panneau latéral affichant la trace complète au niveau des blocs, les messages d'erreur par bloc et les durées — sans quitter la vue Process.

Le bouton « Open full run » n'est affiché que pour les actions adossées à un canevas (les étapes d'agent système @system/… n'ont pas d'exécution de canevas à ouvrir). L'ouverture du panneau ne nécessite qu'un accès en lecture.

Annuler une exécution bloquée

Une action workflow en cours d'exécution — y compris une action en attente sur une porte d'approbation Human-in-the-Loop (HITL) — affiche un bouton « Cancel run » sur la carte de l'action. Un clic ouvre une boîte de dialogue de confirmation ; la confirmation envoie une requête d'annulation au serveur.

Ce qui se passe lors de l'annulation :

1. La plateforme arrête immédiatement le workflow en cours, y compris toute porte d'approbation sur laquelle il est en attente — une exécution en attente HITL est entièrement arrêtée, et non laissée dans les limbes.
2. L'exécution est enregistrée comme annulée dans la vue Logs ; l'exécution et sa porte d'approbation sont nettoyées.
3. L'action workflow sur la carte Process est marquée failed avec output.reason = "Cancelled by <user>". C'est l'état terminal qui active également le bouton Rerun.

Le bouton « Cancel run » n'est visible que tant que l'action est in_progress. Il n'est pas affiché pour les actions terminées ou déjà en échec.

L'annulation depuis la vue Logs est également corrigée. Avant cette version, l'annulation depuis la vue Logs n'arrêtait pas complètement une exécution en cours ; elle se comporte désormais exactement comme l'annulation depuis la vue Process.

Relancer une action workflow (vue Process — sur place)

Lorsqu'une action workflow est dans un état terminal (failed, completed ou skipped), la section Workflow de la carte de l'action affiche un bouton « Rerun ». Un clic redistribue l'action sur place sur la même instance de Process Flow :

• La sortie, le contenu et l'id d'exécution précédents sont effacés.
• Le statut de l'action est réinitialisé à pending.
• La plateforme redistribue l'action par le même chemin que celui utilisé pour la distribution automatique à l'entrée d'une étape, de sorte que toute la logique d'ancrage, de récupération et de surface de sortie s'exécute à nouveau.

C'est le bon choix lorsque le workflow a échoué en raison d'un problème passager (configuration d'extension manquante, appel externe instable) ou lorsque vous avez corrigé la cause racine et souhaitez relancer sans recommencer tout le processus.

Relancer une exécution de workflow (vue Logs — nouvelle exécution)

Dans la vue Logs, une exécution terminée affiche un bouton « Rerun » dans l'en-tête du panneau de détail de l'exécution. Cela crée une nouvelle exécution autonome à partir de l'entrée stockée de l'exécution précédente :

• Un nouvel id d'exécution est généré.
• L'exécution est planifiée comme une nouvelle instance avec les mêmes données d'entrée que l'exécution d'origine.
• La nouvelle exécution apparaît sur une ligne distincte de la vue Logs et peut être inspectée indépendamment.

Elle se distingue de la relance de la vue Process : elle crée une nouvelle exécution de premier niveau, non rattachée à l'état de l'action du processus. Utilisez-la lorsque vous souhaitez réexécuter le workflow de manière autonome à des fins de diagnostic ou de test, ou lorsque l'exécution d'origine a été lancée depuis la vue Logs plutôt que depuis une action de processus.

Quelle relance utiliser

Quand une étape antérieure change

Une étape qui a lu la sortie d'une autre étape peut prendre du retard sur celle-ci. Cela se produit lorsque quelqu'un modifie un document ou une liste terminés, ajoute ou retire un fichier d'une étape de téléversement terminée, régénère un document, applique un raffinement ou modifie la sortie d'une étape d'IA. Les étapes qui la lisent, directement ou par l'intermédiaire d'autres étapes, affichent alors Plus à jour dans le rail du Wizard. Cocher un élément de checklist ou statuer sur une approbation ne compte pas comme un changement.

Lorsque vous enregistrez un tel changement dans le Wizard et qu'au moins une étape d'IA ultérieure a déjà été exécutée sur l'ancienne entrée, la plateforme demande Relancer les étapes concernées ? et indique combien de ces étapes d'IA seraient relancées avec les nouvelles entrées. Elle indique aussi combien elle en laisse de côté : les étapes dont une personne est responsable, et celles qui n'ont pas encore terminé une exécution. Seules les étapes d'IA sont relancées ; une modification ne renvoie jamais une distribution. Lorsqu'il n'y a rien à relancer, par exemple au premier téléversement d'une exécution, personne n'est sollicité. Votre modification est enregistrée dans tous les cas : Annuler la conserve sans rien relancer, et ces étapes restent marquées comme n'étant plus à jour jusqu'à leur prochaine exécution.

Lire la sortie d'une action Document

Les actions document vous permettent de rédiger ou de Generate with AI (puis Regenerate) le corps du document. Le contenu est rédigé en Markdown, mais vous voulez rarement le lire en Markdown brut — les titres, listes et tableaux sont difficiles à parcourir, et coller la source dans un outil qui ne comprend pas le Markdown (par ex. Outlook) transporte les caractères #, * et |.

Chaque carte d'action Document dispose donc d'une bascule Edit / Preview :

• Preview (par défaut dès que l'action a déjà du contenu) rend le Markdown sous forme de document propre et mis en forme — le même moteur de rendu que celui utilisé pour la sortie des agents IA. C'est la vue à partir de laquelle lire et copier-coller du texte enrichi dans un e-mail ou un éditeur de documents. Un simple saut de ligne est conservé : un compte rendu saisi à raison d'un fait par ligne (**Date:** sous **Performed by:**) se lit ligne par ligne, comme dans Edit. Une ligne vide commence toujours un nouveau paragraphe. Le HTML brut du texte est affiché comme du texte, jamais exécuté.
• Edit ouvre le même éditeur Markdown à aperçu en direct que celui de la base de connaissances : titres, gras, listes et tableaux s'affichent au fil de la saisie au lieu de montrer les caractères bruts #, * et |. Sélectionner du texte (ou placer le curseur sur une ligne vide) fait apparaître une barre d'outils de mise en forme avec gras, italique, barré, code en ligne, titres, listes, citation, lien et tableau — vous n'avez donc jamais besoin de connaître la syntaxe Markdown pour mettre en forme un document.

Cliquer sur Generate with AI ou Regenerate bascule automatiquement vers Preview dès que le résultat est prêt, afin que vous voyiez le document final mis en forme plutôt que la source Markdown. Une action vide s'ouvre en Edit pour que vous puissiez commencer à écrire immédiatement.

Lire et discuter la sortie dans le Wizard

Le Wizard conserve le rail des étapes/tâches à gauche, l'action active au centre, et la conversation partagée de l'action avec son onglet Sources à droite. Sur les écrans plus étroits, la conversation passe dans un panneau afin que l'action reste lisible. L'en-tête de l'action affiche le type d'action canonique, le statut, le caractère requis/facultatif et l'attribution ; l'en-tête de la tâche indique à qui la tâche est attribuée.

Une étape que l'auteur a marquée facultative (isRequired: false) affiche Skip tant que personne ne l'a commencée, à côté de la mention This step is optional. Sur une étape de distribution, le bouton se trouve à côté du bouton d'envoi ; sur toute autre étape, il occupe sa propre ligne sous le panneau. Ignorer règle l'étape sans l'exécuter : un e-mail facultatif sans rien à dire ne bloque donc plus sa tâche, et la tâche suivante s'ouvre dès que chaque action de la tâche est réglée. Une étape requise n'offre pas Skip, et l'API refuse de l'ignorer (required_action_not_skippable, HTTP 409).

Une personne assignée est affichée avec le rôle qu'elle occupe, par exemple Lisa De Mol · Security Lead, sur la carte Kanban, dans la liste, dans la ligne d'attribution de la tâche et dans l'en-tête de l'action. Une même personne peut occuper plusieurs rôles dans un flow, et le rôle indique pour lequel une étape lui revient.

Une tâche comportant plusieurs actions se parcourt une action à la fois :

• Le rail affiche la progression de chaque tâche à plusieurs actions, par exemple 1/3. Sous la tâche en cours, il liste ses actions, avec une coche pour chaque action terminée. Choisissez-y une action pour ouvrir sa carte et y faire défiler la vue.
• Une action terminée affiche une coche verte dans l'en-tête de sa carte, de sorte qu'une carte repliée indique encore qu'elle est faite. La ligne d'attribution de la tâche affiche le même décompte, par exemple 1/3 completed.
• Une tâche s'ouvre sur sa première action restant à faire. Terminer une action replie sa carte, ouvre l'action suivante restant à faire et y déplace la conversation partagée de l'action. Vous pouvez toujours ouvrir ou replier vous-même n'importe quelle carte.

Utilisez la conversation partagée pour poser des questions de suivi sur l'action courante et ses connaissances gouvernées. Toutes les personnes actuellement autorisées pour l'action voient le même fil. Poser une question ne modifie pas la sortie ; sur les réponses IA éligibles, Apply as refinement est une action explicite distincte qui relance le chemin d'affinage.

La conversation connaît également les exécutions antérieures terminées du flow dans le même environnement d'espace de travail — par défaut les cinq plus récentes. Leurs synthèses de clôture font partie du contexte de chaque réponse, de sorte qu'une question telle que « qu'avons-nous décidé lors des réunions précédentes ? » reçoit une réponse fondée sur ces exécutions et les cite, et une recherche dans les connaissances couvre également leurs pages ; un résultat issu d'une exécution antérieure nomme cette exécution. Les exécutions encore en cours ne sont jamais incluses, et une synthèse classifiée au-dessus de l'habilitation de la conversation est écartée. L'auteur du flow définit le nombre d'exécutions reprises avec knowledge.priorCycles.

Les sorties Workflow, Document et Assessment proposent une vue Focus pour une lecture en pleine page. Utilisez A− / A+ pour ajuster la taille du texte, et appuyez sur Échap ou revenez en arrière pour retrouver la même position dans le Wizard. Les sorties IA ancrées incluent une section References dont les liens sont autorisés à l'ouverture ; une source inaccessible ou supprimée est affichée comme indisponible.

Les contrôles Previous/Next centrés réservent la zone sûre en bas à droite au lanceur flottant privé de Cortex, de sorte que la navigation reste utilisable sans masquer l'assistant.

Quand une exécution compte comme terminée

Une exécution de Process Flow est Non démarrée, En cours, En attente, Annulée ou Terminée. Ces règles décident du moment où elle devient Terminée :

• Une exécution active se termine d'elle-même. Lorsque la dernière étape d'une exécution Non démarrée ou En cours se termine, l'exécution devient Terminée. Son heure de fin est celle où ce travail s'est terminé.
• Les exécutions en attente et annulées ne sont jamais terminées automatiquement. Si la dernière étape ouverte se règle alors que l'exécution est en attente ou annulée — un workflow encore en cours, par exemple — chaque étape peut apparaître comme terminée alors que l'exécution reste En attente ou Annulée. Mettre une exécution en attente ou l'annuler est une décision que la plateforme ne remplace pas.
• Reprendre une exécution dont tout le travail est fait la termine. Lorsqu'une exécution en attente repasse En cours (ou Non démarrée) et que chaque étape est déjà terminée, elle devient Terminée immédiatement, avec l'heure de fin de sa dernière étape. Si du travail reste ouvert, elle reprend simplement.
• Terminer une exécution en attente ou annulée est refusé. Demander de terminer une exécution En attente ou Annulée — en définissant son statut à completed via l'API, ou en la terminant — est refusé avec HTTP 409 et l'erreur instance_not_finishable. Reprenez-la d'abord ; une exécution déjà Terminée reste un succès idempotent.
• Déplacer une tâche vers une étape déjà terminée rouvre cette étape. L'étape repasse En cours jusqu'à ce que le travail de la tâche déplacée soit fait ; l'exécution ne se termine donc pas tant que cette tâche a encore du travail requis.

Télécharger la sortie en PDF

Lorsqu'une action workflow se termine avec une sortie textuelle, un bouton « Download as PDF » apparaît dans la section Output de la carte de l'action. Un clic ouvre la boîte de dialogue d'impression native de votre navigateur, préréglée sur le contenu de la sortie — choisissez « Save as PDF » comme destination pour exporter le résultat.

Le même bouton apparaît dans la Preview d'une action Document (voir ci-dessus) et dans le panneau « View Output » (ouvert via le bouton « View output ») pour les actions qui écrivent leur résultat dans la base de connaissances de l'instance.

Conseils :

• Dans Chrome et Edge, sélectionnez « Save as PDF » dans la liste déroulante Destination de la boîte de dialogue d'impression.
• Dans Firefox, choisissez « Microsoft Print to PDF » ou « Save to PDF » dans la liste des imprimantes.
• Dans Safari sur macOS, cliquez sur la liste déroulante PDF en bas à gauche de la boîte de dialogue d'impression et sélectionnez « Save as PDF ».
• Le PDF exporté n'inclut que le contenu de la sortie — l'interface du processus et la navigation environnantes sont masquées automatiquement.

Voir aussi