Workflows de l'assistant

Lancer une compétence pilotée par un script, suivre son avancement sous budget, l'annuler et lire son rapport

À quoi ça sert

Certains travaux dépassent une seule réponse : lire quarante contrats et résumer chacun, comparer plusieurs dossiers, préparer un rapport en plusieurs phases. Un workflow découpe ce travail en appels à l'assistant, dont plusieurs tournent en parallèle, et en rend compte à la fin dans la conversation.

Un workflow est porté par une compétence : vous le lancez avec « / » comme une compétence ordinaire, mais au lieu d'une réponse, la conversation démarre une exécution qui travaille en arrière-plan. Pendant ce temps, une carte affiche l'avancement et ce que l'exécution a déjà consommé. Chaque exécution a un budget fixé par l'administrateur : elle s'arrête quand il est épuisé.

Le script d'un workflow est écrit par un administrateur du module Assistant IA. Pour l'utiliser, vous n'avez rien à programmer.

Concepts clés

Workflow — une compétence dont le champ « Piloté par un workflow » est activé : un script enchaîne des appels de modèle au lieu de simples instructions.
Exécution — un lancement du workflow, avec sa carte, son budget et son rapport.
Appel — une étape de l'exécution : une conversation de l'assistant qui travaille seule sur une tâche précise. On l'appelle aussi « sous-agent ».
Phase — un regroupement d'appels que le script nomme, par exemple « Collecte ».
Budget — le plafond de consommation de l'exécution, en tokens (entrée et sortie de tous les appels) ou en dollars.
Rapport — le message que l'assistant publie dans la conversation quand l'exécution se termine.

Comment faire

Lancer un workflow

Dans le champ de saisie, tapez « / » et choisissez la compétence qui porte le workflow. Voir Utiliser une compétence dans une conversation.
Écrivez la consigne qui accompagne le lancement.
Envoyez.

L'assistant répond « Le workflow /{nom} est lancé. » sans passer par un modèle, et la carte « Workflow » apparaît au-dessus du champ de saisie. Les autres compétences et l'agent éventuellement cités dans le même message ne s'appliquent pas à ce lancement.

Suivre une exécution

Lisez l'en-tête de la carte : un petit carré par appel (bleu clignotant en cours, orange en attente de validation, vert terminé, rouge en échec, gris interrompu), puis « Budget : 3,4 k / 8 k tokens » et l'état « En cours ».
Cliquez sur la flèche « Déplier le workflow » pour voir les appels, regroupés par phase, avec l'état, la consommation de chacun et un bouton « Afficher le résultat ».
Cliquez sur le nom d'un appel pour lire ses échanges dans le volet de droite (« Échanges : {nom} »).

La carte se met à jour toute seule. Les appels n'apparaissent qu'une fois démarrés : la rangée de carrés grandit avec l'exécution. Le budget est compté après chaque appel, il peut donc dépasser légèrement le plafond de ce que consomment les appels en cours. Une conversation partagée en lecture seule n'affiche pas la carte.

Valider une action demandée par un appel

Quand un appel veut écrire dans vos données, il passe « En attente d'une validation » et la carte affiche, sous son en-tête, la carte de validation habituelle, même repliée.
Cliquez sur « Valider » ou « Annuler » : les autres appels continuent pendant ce temps.

Cette carte n'a pas de champ pour répondre en mots, seulement approuver ou refuser. Si la décision n'a pas pu être transmise : « La décision n'a pas pu être transmise. » Voir Valider les actions de l'assistant.

Parler aux sous-agents pendant l'exécution

Écrivez un message dans la conversation pendant que l'exécution tourne, par exemple « Insistez sur les clauses de résiliation ».

L'assistant lit votre message et peut le transmettre aux appels en cours (action « transmettre une consigne aux sous-agents »). Un appel prend la consigne à sa prochaine étape ; un appel qui n'a pas encore commencé ou qui se termine avant ne la lit pas.

Annuler une exécution

Sur la carte, cliquez sur le bouton rond « Annuler » (un carré) à droite de l'en-tête.

L'exécution s'arrête et le rapport indique « Le workflow a été annulé. ». Seule la personne qui l'a lancée peut l'annuler.

Lire le rapport

Quand l'exécution se termine, la carte quitte le haut du champ de saisie et se place dans le fil, à l'endroit du lancement, repliée.
Lisez le message de l'assistant juste en dessous.

Le rapport est écrit sans modèle et entre dans l'historique de la conversation : vos messages suivants s'appuient dessus. Selon l'issue, il donne le résultat, ou :

« Le workflow a échoué : {raison} » ;
« Le workflow a été annulé. » ;
« Le workflow s'est arrêté : le budget est épuisé (3 000 / 3 000 tokens). »

Dans les trois derniers cas, le rapport liste aussi chaque appel — « {nom} : terminé », « : en échec », « : interrompu », « : en attente d'une validation » — et le « résultat partiel » de ceux qui avaient déjà répondu.

Écrire un workflow

Réservé aux administrateurs du module Assistant IA.

Créez ou ouvrez une compétence. Voir Compétences.
Activez « Piloté par un workflow » : « Un script enchaîne des appels de modèle au lieu de simples instructions ; les instructions deviennent la consigne commune de ses appels. »
Dans « Script du workflow », écrivez le script en JavaScript.
Dans « Modèles autorisés », cochez au moins un modèle. Le premier de la liste est le modèle par défaut des appels ; le script ne peut nommer que ceux-là.
Choisissez l'« Unité du budget » : « Tokens » ou « Dollars ».
Renseignez le « Budget », un nombre strictement positif.
Enregistrez, puis publiez.

En dollars, tous les modèles autorisés doivent passer par OpenRouter. À l'enregistrement, le script est vérifié et refusé s'il contient une erreur de syntaxe. Le modèle propre de la compétence n'est plus proposé : il est remplacé par les modèles du workflow.

Le script s'exécute dans un bac à sable. Il dispose de agent(prompt, options) (options : label, model, agent, schema), de phase(titre), de input.message (votre consigne), de input.values et de Promise.all pour paralléliser. Un appel peut répondre sous l'identité d'un agent publié, avec son portrait et ses outils : voir Agents. Sans agent, l'appel applique les instructions de la compétence et sa liste d'outils.

Référence

États d'une exécution

État	Signification
En cours	Les appels travaillent
Terminé	Le script est arrivé au bout
Échec	Le script ou un appel a échoué
Budget épuisé	Le plafond de consommation est atteint ; l'exécution est arrêtée
Annulé	La personne qui l'a lancée l'a arrêtée

États d'un appel

État	Signification
En cours	L'appel travaille
En attente d'une validation	Une écriture attend votre décision
Terminé	L'appel a répondu
Échec	L'appel a échoué
Interrompu	L'exécution s'est arrêtée avant la fin de l'appel

Limites d'une exécution

Élément	Limite
Appels en même temps	4
Appels au total	100
Durée	30 minutes
Calcul du script lui-même	5 secondes
Consigne d'un appel	200 000 caractères
Budget	Fixé par l'administrateur dans la compétence, jamais choisi au lancement

Droits

Une exécution agit avec les droits de la personne qui l'a lancée, revérifiés tout au long de l'exécution : si elle perd l'accès au module, l'exécution échoue. Elle n'est lisible et annulable que par elle. Les appels héritent de la liste d'outils de la compétence, ou de celle de l'agent qu'ils incarnent.

Les conversations de travail des appels n'apparaissent pas dans l'historique ni dans la recherche : on les ouvre depuis la carte.

Lancement automatique

Une règle d'automatisation qui lance la compétence démarre l'exécution sans personne devant l'écran, avec les droits de la personne qui a publié la version. Une conversation titrée « /{nom} » est alors créée dans l'historique de cette personne, avec le message « Le workflow /{nom} a été lancé automatiquement. », la carte et le rapport. Une écriture à valider y attend cette personne, dans la limite des 30 minutes de l'exécution. Voir Lancer une compétence.