Générer des flux avec une IA

Un flux Maillon tient dans un fichier : le fichier de flux Maillon, au format JSON. Vous pouvez l'exporter pour le garder ou le reprendre chez un autre client, l'importer dans la console, et surtout le faire écrire par un assistant IA à partir d'une demande en français : « chaque nuit, copie dans Sage les clients modifiés dans Odoo ».

Faire écrire un flux par une IA

Les instructions sont produites à partir du code de Maillon à chaque version : les noms d'outils, d'actions et de réglages qu'elles donnent sont exacts. Reprenez-les ici quand vous commencez une nouvelle conversation, pour avoir la dernière version.

Exporter un flux

Dans la page Flux, l'icône de téléchargement d'une ligne enregistre le flux dans un fichier nom-du-flux.maillon-flux.json. Le fichier ne contient aucun secret :

• les comptes connectés y sont désignés par leur nom, jamais par leurs identifiants ;
• le mot de passe ou le jeton d'une étape Requête HTTP est retiré ;
• l'exemple de données d'un point d'entrée API est retiré, il pouvait contenir de vraies données.

Pour faire modifier un flux par une IA, exportez-le et donnez le fichier à l'assistant avec les instructions.

Importer un fichier

Le bouton Importer de la page Flux accepte un texte collé ou un fichier, jusqu'à 50 flux à la fois. Le rapport s'affiche pendant que vous collez :

Dossier Sage. Le dossier nommé dans le fichier est utilisé s'il existe chez le client. Sinon, si le client n'a qu'un dossier, Maillon prend celui-là ; s'il en a plusieurs, vous choisissez lequel avant d'importer.

Comptes connectés. Une étape garde le compte du client qui a le même logiciel et le même nom. Sinon, vous choisissez parmi les comptes du client, ou plus tard dans l'éditeur.

Plusieurs sociétés dans Odoo. Si le compte Odoo du flux a le réglage Plusieurs sociétés, le flux prend la société Odoo reliée à son dossier Sage, comme un flux créé depuis la galerie : l'assistant n'a pas à la connaître. Un dossier relié à aucune société est refusé : reliez-le d'abord sur le compte Odoo (voir Plusieurs sociétés dans Odoo).

L'import crée toujours de nouveaux flux, désactivés : il ne remplace jamais un flux existant. Supprimez l'ancien une fois le nouveau vérifié.

Le format en bref

{
  "format": "maillon-flux",
  "version": 1,
  "flows": [
    {
      "name": "Relance des factures",
      "graph": {
        "nodes": [
          { "id": "depart", "type": "trigger", "data": { "mode": "schedule", "schedule": { "frequency": "weekly", "time": "08:00", "weekday": 1 } } },
          { "id": "retards", "type": "sage", "data": { "tool": "sage_finance", "arguments": { "dossier": "BIJOU", "action": "open_items", "overdue_only": true } } }
        ],
        "edges": [{ "source": "depart", "target": "retards" }]
      }
    }
  ]
}

Le détail de chaque étape, des références {{ }} et des filtres est dans les instructions ci-dessus. Voir aussi Boucles, listes et filtres, Lancer un flux par API et Modèles de flux Odoo et Sage 100.