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

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 → Agents → Constructeur de flux.

L'interface est un enchaînement de blocs. Chaque bloc reçoit ce que le précédent a produit et transmet son propre résultat au suivant, via des variables.

Les blocs disponibles

Démarrage. Déclare les variables d'entrée du flux — ce qu'on lui fournit au lancement.

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.

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.

Les blocs s'enchaînent autant de fois que nécessaire.

Un exemple

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

1. Démarrage — variable source_url.
2. Extraction web — récupère le contenu de source_url → contenu_brut.
3. Instruction — « Extrais uniquement les publications datées d'hier ou d'aujourd'hui. Si aucune, réponds exactement : AUCUNE. » → nouveautes.
4. Instruction — « Rédige une note interne de dix lignes maximum à partir de nouveautes, en citant les références. » → note.
5. 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.

Utiliser un flux

Un flux publié devient une compétence utilisable par les agents. Il est donc appelable :

• depuis une conversation, en confiant la tâche à l'agent ;
• depuis une tâche planifiée ;
• au sein d'un autre enchaînement.

Bonnes pratiques

Testez bloc par bloc. Un flux se construit en ajoutant une étape à la fois et en vérifiant sa sortie, plutôt qu'en écrivant 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é. Traitez ces flux avec la même prudence qu'un script de production, et limitez qui peut les modifier.