Instruction libre (IA)

Donne une consigne libre au modèle sur le mail et les données de travail. Le nœud produit du texte ou du JSON : il n’envoie rien et ne modifie rien — ajoutez un nœud d’action en aval pour agir.

Instruction libre (IA) est le nœud IA à tout faire : vous écrivez ce que le modèle doit faire, et il répond par du texte ou par un objet JSON que vous décrivez. Utilisez-le pour ce que les nœuds dédiés ne couvrent pas : reformuler un texte, juger l’urgence d’une demande, transformer une liste en tableau, comparer deux valeurs.

Le nœud ne produit que de la donnée. Il n’envoie rien, ne modifie rien et ne déclenche rien, et ses consignes interdisent au modèle de prétendre avoir agi. Pour agir sur la réponse, branchez un nœud d’action en aval : Rédiger puis Envoyer, une écriture dans une table, un Notifier. Pour les cas courants, préférez les nœuds dédiés : Catégoriser, Extraire, Résumer, Rédiger (IA).

En bref

• Type : ai.prompt · version 1
• Catégorie : IA
• Nature : Étape — s’exécute pendant une exécution
• Effet : Sans effet externe (none) — rien n’est écrit hors de Mankomail ; rejouable sans risque
• Exige un mail porteur : Non
• Connexion : Aucune
• Entrées : main
• Sorties : main
• Ports de service : model (llm.model, facultatif)

Paramètres

prompt

Instruction — Ce que le modèle doit faire. Accepte des expressions {{ }} : {{ email.subject }}, {{ data.extract_1.montant }}. Le contenu du mail est fourni séparément, en données délimitées.

• Type : Texte long (text)
• Requis : Oui
• Défaut : "" (vide)
• 10000 caractères au plus
• Expressions : {{ }} accepté

outputFormat

Format de sortie

• Type : Un choix (options)
• Requis : Oui
• Défaut : text
• Options :
  • text — Texte : Le texte du modèle dans text.
  • json — JSON structuré : Un objet conforme au schéma, dans json.

jsonSchemaText

Schéma JSON — Un JSON Schema d’objet : { "type": "object", "properties": { "urgence": { "type": "string" } } }.

• Type : Texte long (text)
• Requis : Oui
• Défaut : "" (vide)
• 20000 caractères au plus
• Affiché quand : outputFormat vaut json
• Expressions : {{ }} refusé

Sorties

• main

Données produites

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

• {{ data.<step>.text }} — string. Écrit quand le « Format de sortie » est « Texte » : la réponse du modèle, sans espaces superflus en tête et en fin.
• {{ data.<step>.json.<property> }} — object. Écrit quand le « Format de sortie » est « JSON structuré » : l’objet rendu par le modèle, selon votre schéma JSON. Lisez chaque propriété par son nom.
• {{ data.<step>.simulated }} — boolean. true quand la sortie a été fabriquée au lieu de venir d’un modèle (essai sur une instance sans fournisseur d’IA utilisable). false pour une vraie réponse de modèle.

Exemple

Une équipe support veut un niveau d’urgence sur chaque demande. Ajoutez un nœud Instruction libre (IA) nommé Urgence :

prompt: "Évalue l’urgence de cette demande pour notre équipe support, et justifie-la en une phrase."
outputFormat: json
jsonSchemaText: |
  {
    "type": "object",
    "properties": {
      "niveau": { "type": "string", "enum": ["faible", "normal", "haut"] },
      "raison": { "type": "string" }
    },
    "required": ["niveau", "raison"]
  }

Les données de l’étape sont :

{
  "json": { "niveau": "haut", "raison": "Le site de production du client est à l’arrêt." },
  "simulated": false
}

Un Aiguillage sur {{ data.urgence.json.niveau }} envoie ensuite les demandes urgentes à l’équipe d’astreinte.

Texte ou JSON

• Texte : la réponse arrive dans text. Le modèle reçoit la consigne de répondre en texte brut, sans balisage, et d’écrire dans la langue du mail reçu, quelle que soit la langue de votre instruction.
• JSON structuré : la réponse arrive dans json. Le champ « Schéma JSON » doit décrire un objet ("type": "object"), avec des properties typées (string, number, integer, boolean, object, array, null) et une liste required facultative. C’est un sous-ensemble simple de JSON Schema, pas la spécification complète. Le schéma est vérifié à la saisie : un schéma invalide est signalé sous le champ et le workflow ne peut pas être publié ainsi. Le champ « Schéma JSON » n’est pas templatable, pour que les clés de json restent prévisibles en aval.

Ce que voit le modèle

Votre « Instruction » est envoyée telle quelle, après rendu des expressions {{ }}. Quand l’exécution a un mail déclencheur, son objet et son corps texte sont ajoutés dans un bloc distinct et délimité, avec la consigne explicite de le traiter comme une donnée et d’ignorer toute instruction qu’il contiendrait. Quand l’exécution n’a pas de mail (planification, webhook), le modèle ne reçoit que votre instruction.

Choix du modèle

Le nœud possède un port de service model. Laissé vide, l’appel utilise le modèle par défaut que l’administrateur a choisi pour l’usage « Usage général » sur la page Connexions (section Intelligence artificielle) (ou le défaut de l’instance). Branchez un nœud fournisseur comme Anthropic (Claude) ou API compatible OpenAI sur le port model pour faire tourner ce nœud chez ce fournisseur.

Conseils

• Les valeurs insérées sont des données. Si votre instruction insère du contenu écrit par un tiers ({{ email.subject }}, {{ data.<step>.attachments.0.text }}), ce contenu atteint le modèle dans le message utilisateur, jamais dans le message système, et le modèle est prévenu que les valeurs insérées sont des données, pas des consignes. Préférez le bloc délimité du mail quand c’est possible : c’est la protection la plus forte.
• Le nœud ne peut pas agir. Une réponse qui dit « j’ai envoyé le mail » est une fiction. Seuls les nœuds d’action ont des effets, et eux seuls sont retenus en essai ou par le coupe-circuit d’envoi.
• Essais. En essai, le modèle est réellement appelé. Si l’instance n’a aucun fournisseur d’IA utilisable, la sortie est fabriquée (un texte fixe, ou des valeurs de remplissage conformes à votre schéma), simulated vaut true et le détail d’exécution signale que l’IA a été sautée.
• Erreurs. Une instruction vide donne node_nothing_to_do ; un schéma invalide à l’exécution donne node_invalid_param. En sortie JSON, une réponse qui n’est pas un objet JSON donne llm_invalid_output, qui est retentée. Voir Gestion des erreurs.