Les blocs de code vous permettent d'exécuter directement une logique Python dans une Fin Procedure, vous offrant des résultats cohérents et précis pour les tâches où un LLM peut être imprévisible.
Quand utiliser les blocs de code
Utilisez les blocs de code pour une logique déterministe et répétable — surtout lorsque Fin pourrait autrement être incohérent :
Calculs de date et d'heure — jours ouvrables, conversions de fuseaux horaires, vérifications de délais
Opérations mathématiques — montants de remboursement, pourcentages, conversions de devises
Manipulation de chaînes — formatage des identifiants, extraction de sous-chaînes, correspondance regex
Transformation de données — remodelage des réponses des connecteurs, filtrage ou mappage de listes
Logique conditionnelle complexe — vérifications d'éligibilité avec plusieurs critères
Astuce : Utilisez les blocs de code lorsque la sortie doit être exacte et répétable — pas lorsqu'elle bénéficie d'une interprétation.
Quand ne pas utiliser les blocs de code
Évitez les blocs de code pour les tâches que Fin gère bien naturellement, telles que :
Interprétation de l'intention de l'utilisateur
Génération de réponses conversationnelles
Comment utiliser les blocs de code
1. Créez un bloc de code
Ouvrez le sélecteur d'outils en tapant @ ou /
Sélectionnez ＋Créer un bloc de code
2. Écrivez et testez votre code
L'éditeur de bloc de code s'ouvrira
Cliquez sur Tester le code pour exécuter votre logique, cela ouvre le panneau de test
Des champs d'entrée apparaissent pour tous les attributs que vous avez référencés
Exécutez les tests et visualisez les résultats au format JSON ou liste
3. Comprendre les attributs
Les attributs sont créés à partir de la réponse retournée. Par exemple, le code suivant :
return {
"result": {
"nested_result": "This is nested"
},
"date": "05-04-2025"
}Crée les attributs suivants :
Un attribut racine (la réponse entière)
Attributs imbriqués : result, result.nested_result, et date
Note : L'attribut racine est toujours créé et contiendra toujours la réponse complète retournée, il n'a pas besoin d'être au format JSON.
4. Utilisez le bloc de code dans une procédure
Retournez à l'éditeur de procédure
Ouvrez le sélecteur d'outils en tapant @ ou /
Sélectionnez Exécuter le code — cela liste tous les blocs de code disponibles
Choisissez votre bloc de code
Une fois sélectionné, vous pouvez utiliser les attributs dans toute la procédure et continuer normalement.
Bibliothèques disponibles
Ces modules de la bibliothèque standard Python sont sur liste blanche et pré-importés. Vous pouvez les utiliser directement sans instruction d'importation, bien qu'il soit recommandé d'ajouter des imports pour plus de clarté.
Module | Utilisation pour | Exemple |
math | Fonctions mathématiques | math.floor(3.7), math.ceil(2.1) |
decimal | Arithmétique décimale précise | Decimal("19.99") * Decimal("0.15") |
re | Expressions régulières | re.match(r"\d{4}", order_id) |
datetime | Dates, heures, durées | datetime.date.today(), timedelta(days=5) |
json | Encodage/décodage JSON | json.loads(raw_string) |
random | Génération de nombres aléatoires | random.randint(1, 100) |
zoneinfo | Gestion des fuseaux horaires | ZoneInfo("America/New_York") |
time | Fonctions liées au temps | time.time() |
Note : Seuls les imports de premier niveau sont autorisés. Évitez les imports de sous-modules — par exemple, from json import loads n'est pas supporté.