Pré-traiter une action avec l'IA

À quoi ça sert

Une action d'automatisation écrit des valeurs fixes ou tirées de la fiche qui a déclenché la règle. Le pré-traitement IA ajoute une étape : avant l'action, un modèle d'IA de votre organisation lit un texte que vous rédigez — par exemple les échanges d'une fiche — et renvoie des valeurs précises, comme un résumé, un montant ou un oui/non. L'action les réutilise dans ses champs.

Deux portées existent : le pré-traitement d'une action, propre à une action, et l'analyse IA de la règle, qui interroge le modèle une seule fois pour toutes les actions et permet aussi de choisir quelle action s'exécute. L'analyse est la seule voie pour faire lire un e-mail reçu, pièces jointes comprises.

Exemples : résumer les échanges d'un client dans une tâche de suivi, extraire un nombre de places d'un message pour calculer un montant, décider par oui/non si une tâche doit être créée.

Concepts clés

• Pré-traitement IA — l'option d'une action. Chaque action a le sien : il n'y a pas de modèle par défaut pour l'organisation.
• Prompt — la consigne envoyée au modèle. Il accepte les mêmes variables du déclencheur que les paramètres de l'action, par exemple {{trigger.record.displayName}}.
• Valeur attendue — une réponse que le modèle doit fournir, déclarée avec une clé, un type et une description. Types : « Texte », « Nombre », « Oui/Non », « Choix ». Un « Choix » se limite à des options que vous déclarez, chacune avec une valeur et une description.
• Variable IA — la valeur renvoyée, lisible dans l'action par {{llm.clé}}, sans préfixe « trigger ».
• Analyse IA — le bloc de la règle qui interroge le modèle une fois, après la condition de la règle et avant les actions. Ses valeurs sont lisibles par toutes les actions : {{analysis.clé}}.
• Modèle de décision — un modèle qui répond par un choix ou par oui/non, sans rédiger de texte. Il s'active par l'interrupteur « Modèle de décision » et se choisit sur une connexion OpenRouter.
• Vide — le modèle répond « vide » quand l'information est absente du texte, plutôt que de l'inventer.

Comment faire

Activer le pré-traitement d'une action

1. Ouvrez la règle et repérez l'action concernée.
2. Activez « Pré-traitement IA » : « Un modèle lit le prompt, puis renvoie les valeurs déclarées ci-dessous. Les champs de l'action les lisent avec '{{llm.clé}}'. »
3. Choisissez la « Connexion IA », puis le « Modèle ». Les connexions proposées sont celles de l'organisation qui acceptent du texte : fournisseur compatible OpenAI ou OpenRouter. Pour OpenRouter, vous pouvez aussi régler le « Fournisseur » et « Forcer le routage UE ». Voir Connexions IA.
4. Rédigez le « Prompt ». Les puces de variables du déclencheur insèrent une variable à l'endroit du curseur.
5. Sous « Valeurs attendues », cliquez sur « Ajouter une valeur » pour chacune : saisissez la clé (par exemple « resume »), choisissez le type et décrivez ce que le modèle doit renvoyer.
6. Enregistrez la règle.

Classer une valeur parmi des options

Le type « Choix » sert à ranger un texte dans une catégorie : par exemple la satisfaction d'un client (positive, neutre, négative).

1. Dans « Valeurs attendues », cliquez sur « Ajouter une valeur » et choisissez le type « Choix ».
2. Cliquez sur « Ajouter une option » pour chaque réponse possible. Saisissez la « Valeur » et « Ce que signifie cette option ». Pour remplir un champ liste d'une fiche CRM, utilisez les valeurs enregistrées de ses options.
3. Enregistrez la règle.

Le modèle doit répondre par l'une des options. Comme les autres valeurs, la réponse se lit par {{llm.clé}}. Dans une action « Mettre à jour une fiche CRM », le menu de valeur d'un champ liste ou d'une case à cocher propose les valeurs attendues du pré-traitement (« {{llm.clé}} ») à côté de ses propres choix. Dans la condition d'une action, le champ « Analyse IA : clé » d'un « Choix » propose les options déclarées.

Confier la question à un modèle de décision

1. Dans le pré-traitement d'une action ou dans l'analyse IA, activez « Modèle de décision » : « Un modèle de décision (Jev…) répond par un choix ou par oui/non, sans rédiger de texte. Connexion OpenRouter uniquement. »
2. Choisissez une connexion OpenRouter puis un modèle de la liste des modèles de décision. Changer d'interrupteur vide le modèle choisi : la liste n'est pas la même.
3. Déclarez les valeurs attendues : seuls « Choix » et « Oui/Non » sont proposés.

Un modèle de décision ne lit pas les pièces jointes d'un e-mail. Ses appels sont comptés dans la consommation de la connexion comme les autres appels IA.

Utiliser une valeur dans l'action

1. Sous « Variables utilisables dans l'action », repérez la valeur : les variables déclarées s'affichent avec un bouton de copie.
2. Insérez {{llm.clé}} dans un champ de l'action — le nom d'une tâche, le corps d'un e-mail, un montant — ou dans une formule sous la racine llm, par exemple {{= mul(llm.seats, 2) }}.

Quand la variable occupe tout le champ, elle garde son type d'origine : un nombre reste un nombre. Insérée dans un texte, elle est remplacée sur place. Les puces de variables des champs de l'action proposent aussi les valeurs déclarées.

Consulter la réponse de l'IA

1. Ouvrez « Administration », « Automatisations », onglet « Exécutions ».
2. Sur la ligne de l'exécution, déroulez « Réponse de l'IA » sous le résultat de l'action.

La réponse affiche chaque clé avec sa valeur : « Non trouvé » quand le modèle a répondu vide, « Oui » ou « Non » pour un oui/non.

Ajouter une analyse IA à la règle

1. Ouvrez la règle sur la vue « Graphique ».
2. Sur la flèche qui part du déclencheur, cliquez sur « + » puis sur « Ajouter une analyse IA ». Dans la vue « Visuel », activez « Analyser le déclencheur avec un modèle IA » dans la section « Analyse IA ».
3. Choisissez la « Connexion IA » et le « Modèle », rédigez le « Prompt » et déclarez les « Valeurs attendues », comme pour le pré-traitement d'une action.
4. Sur une règle déclenchée par un e-mail, activez si besoin « Inclure les pièces jointes de l'e-mail ».
5. Enregistrez la règle.

Un bloc « Analyse IA » apparaît sur le schéma, avec les clés déclarées en sous-titre. « Retirer l'analyse IA » le supprime.

« Un modèle lit le prompt une seule fois, avant les actions, et renvoie les valeurs déclarées ci-dessous. Les conditions et les champs de chaque action les lisent avec '{{analysis.clé}}'. » Le prompt accepte les variables du déclencheur.

Utiliser une valeur de l'analyse dans une action

1. Dans un champ de l'action, insérez {{analysis.clé}} ; les puces de variables des champs de l'action proposent les valeurs déclarées.
2. Pour choisir quelle action s'exécute, posez une condition sur l'action avec le champ « Analyse IA : clé ». Voir Restreindre une règle par une condition.

Les règles d'insertion sont celles du pré-traitement : une variable qui occupe tout le champ garde son type d'origine.

Faire lire les pièces jointes d'un e-mail

1. Sur une règle sur une boîte mail (module « Boîte mail ou webhook »), ajoutez l'analyse IA.
2. Activez « Inclure les pièces jointes de l'e-mail ».
3. Choisissez un modèle qui accepte les images et les PDF.

« Les PDF et les images sont transmis tels quels ; Word, Excel et les fichiers texte sont convertis en texte. Le modèle choisi doit accepter les images et les PDF, sinon l'exécution échoue. » Seul un e-mail reçu a des pièces jointes : sur tout autre déclencheur, l'option est refusée avec « Seul un e-mail reçu a des pièces jointes à transmettre à l'analyse IA ».

Référence

Limites de saisie

Ces limites valent aussi pour l'analyse IA de la règle.

Messages de validation

Déroulement à l'exécution

Déroulement de l'analyse IA de la règle :

Questions fréquentes

Puis-je utiliser une valeur de l'IA dans une condition ?

Pas celles du pré-traitement d'une action : elles ne sont lisibles que dans les paramètres de l'action qui les déclare. Les valeurs de l'analyse IA de la règle, elles, se lisent dans la condition de chaque action, mais pas dans la condition de la règle elle-même.

Quel modèle choisir ?

Celui d'une connexion IA de votre organisation : chaque action choisit le sien. Un modèle plus petit suffit pour extraire un nombre ou un oui/non.

Le texte de la fiche est-il envoyé au fournisseur du modèle ?

Oui : le prompt, avec les variables remplacées par les valeurs de la fiche, est envoyé à la connexion que vous avez choisie. N'y placez que ce dont l'action a besoin.