Flux d'agents

Un flux est une suite d'étapes définie à l'avance, construite visuellement, et exécutée toujours dans le même ordre. Là où un agent décide de ce qu'il fait, un flux fait ce qui a été prévu.


Quand préférer un flux à un agent

Agent Flux
Décide des étapes Le modèle Vous
Reproductibilité Variable Mêmes étapes à chaque exécution ; le texte produit par un bloc d'instruction peut varier
Adaptation à l'imprévu Bonne Nulle
Nombre d'appels au modèle Élevé Réduit aux étapes qui en ont besoin
Débogage Difficile Étape par étape

Prenez un flux quand la procédure est stable et que le résultat doit être constant : une extraction quotidienne, un traitement standardisé, un appel d'API suivi d'une mise en forme.

Prenez un agent quand la démarche dépend de ce qu'on trouve en chemin.


Le constructeur

Réglages → Agent → Compétences de l'agent, section Flux d'agent, puis « Créer un flux ». Réservé aux administrateurs.

Les blocs disponibles

Démarrage. Déclare les variables d'entrée du flux — ce qu'on lui fournit au lancement. Une variable est obligatoire, facultative ou fixe ; une variable fixe reste invisible pour le modèle.

Appel d'API. Émet une requête HTTP : URL, méthode, en-têtes, corps de requête. La réponse est rangée dans une variable. Une option permet de renvoyer la réponse directement à l'utilisateur, sans la faire passer par le modèle — utile quand le résultat est déjà exploitable tel quel. Ce bloc n'est soumis à aucune approbation : la requête part sans validation humaine, quelle qu'en soit la méthode.

Instruction au modèle. Confie une consigne au modèle, appliquée aux variables disponibles : résumer, extraire, reformater, classer. Le résultat est rangé dans une variable.

Extraction web. Récupère le contenu d'une URL et le range dans une variable. La même option de renvoi direct est disponible.

Les blocs s'enchaînent autant de fois que nécessaire. Dès qu'un bloc échoue, le flux s'arrête et renvoie l'erreur.


Un exemple

Objectif : chaque matin, relever les nouvelles publications d'une source réglementaire et en produire une note interne.

  • Démarrage — variable source_url.
  • Extraction web — récupère le contenu de source_url → contenu_brut.
  • Instruction — « Extrais uniquement les publications datées d'hier ou d'aujourd'hui. Si aucune, réponds exactement : AUCUNE. » → nouveautes.
  • Instruction — « Rédige une note interne de dix lignes maximum à partir de nouveautes, en citant les références. » → note.
  • Appel d'API — publie note dans l'outil interne de diffusion.

Ce flux, associé à une tâche planifiée, s'exécute chaque matin sans intervention (en mode mono-utilisateur, seul mode où les tâches planifiées existent). Il part alors sans qu'aucun humain ne relise la note : un flux n'a pas de condition, et l'Appel d'API s'exécutera même si l'instruction a répondu AUCUNE.


Utiliser un flux

Un flux enregistré et actif devient une compétence utilisable par les agents de toute l'instance. Il est actif dès sa création, et se désactive depuis la section Flux d'agent. Un flux est donc appelable :

  • depuis une conversation, en confiant la tâche à l'agent, qui décide de le lancer et lui fournit les variables ;
  • depuis une tâche planifiée.

Un flux ne peut pas en appeler un autre.


Bonnes pratiques

Testez bloc par bloc. Le constructeur n'a pas de bouton d'exécution : ajoutez une étape, enregistrez, lancez le flux depuis une conversation avec @agent et vérifiez sa sortie dans le déroulé, plutôt que d'écrire l'ensemble avant le premier essai.

Nommez explicitement vos variables. liste_factures_impayees vaut mieux que resultat2 — la lisibilité du flux en dépend, et vous y reviendrez dans six mois.

Prévoyez le cas vide. Que doit-il se passer si l'API ne renvoie rien, si la page est inaccessible, si aucune nouveauté n'existe ? Une instruction explicite sur ce cas évite des sorties absurdes.

Contraignez le format des sorties du modèle. « Réponds uniquement par une liste à puces, sans introduction » produit un résultat exploitable par l'étape suivante ; une consigne vague produit un texte à retraiter.

Attention aux secrets. Un appel d'API peut nécessiter une clé. Elle est visible des administrateurs dans la définition du flux, et le corps de la requête s'affiche dans le déroulé de la conversation : utilisez une clé dédiée, aux droits limités. Traitez ces flux avec la même prudence qu'un script de production.