IceFold Documentation
Guides

Modèles de prompt

Toute étape dont l'inspecteur affiche l'éditeur riche Modèle de prompt — notamment Générer du texte et les étapes créées à partir de nœuds personnalisés — accepte la même syntaxe. Écrivez @name et le moteur substitue la bonne valeur pour la version de contenu en cours. Le champ simple Nom du fichier d'une étape terminale accepte les mêmes marqueurs, avec le comportement propre aux noms de fichiers décrit plus bas.

La règle

@name se résout en étiquette — la valeur lisible attendue par l'utilisateur.

Vous traduisez le document ci-dessous en @Language.

Document :
@text

Deux types de noms sont disponibles, distingués dans l'éditeur par la couleur :

  • Emplacements d'entrée (vert) — @text, @image, tout ce qui est connecté depuis une étape amont. S'affiche comme la sortie de cette étape amont pour la version de contenu.
  • Groupes de versions (cyan) — @Language, @Platform, @Length, … un par groupe de versions déclaré dans votre espace. S'affiche comme l'étiquette humaine de la valeur (中文, TikTok).

Lorsque vous ajoutez un groupe de versions, son nom exact devient le marqueur : Platform crée @Platform, Content Length crée @{Content Length} et 内容平台 crée @{内容平台}. Les noms sont sensibles à la casse dans les prompts ; les doublons sont refusés afin que chaque marqueur désigne un seul groupe.

Les noms inconnus reçoivent un soulignement rouge en pointillés et une suggestion « vouliez-vous dire… ? ». Les noms non résolus sont laissés tels quels dans le prompt final — IceFold ne supprime jamais silencieusement ce qu'il ne peut pas résoudre.

Forme bornée : @{name}

Lorsque le texte adjacent pourrait autrement être lu comme faisant partie de l'identifiant, placez le nom entre accolades. Les deux formes produisent la même substitution — les accolades servent uniquement à lever une ambiguïté.

rapport_@{Target Language}.v1.txt   →   rapport_中文.v1.txt

Échappement : @@

Pour afficher un @ littéral — par ex. Bonjour @user dans du texte — doublez-le :

Bonjour @@user   →   Bonjour @user

Le doublage s'étend naturellement : @@@@ affiche @@. Notez qu'un @ précédé d'une lettre ou d'un chiffre est déjà ignoré, donc [email protected] reste littéral sans aucun échappement.

Fonctions de l'éditeur

Le champ Modèle de prompt est plus qu'une simple zone de texte. Pendant que vous tapez :

  • Barre de variables au-dessus de l'éditeur : elle liste chaque variable disponible pour cette étape, regroupée par source. Cliquez sur une variable pour l'insérer. Les emplacements d'entrée non connectés apparaissent atténués.
  • Autocomplétion s'ouvre lorsque vous tapez @. Tapez @{ pour passer le menu aux suggestions de forme bornée.
  • Survolez n'importe quelle pastille pour voir son type et ce à quoi elle se résout pour la version de contenu actuellement prévisualisée.
  • Panneau de prévisualisation sous l'éditeur reflète la substitution réelle du backend : choisissez une version de contenu dans la liste déroulante et voyez exactement quel prompt le LLM recevra.

Résumé de la grammaire

Forme Affiche
@name l'étiquette pour name dans cette version de contenu
@{name} idem, avec des limites explicites
@@ @ littéral
[email protected] littéral — @ après un caractère de mot est du texte
@unknown @unknown littéral, signalé en rouge dans l'éditeur

Dans Nom du fichier, seuls les marqueurs de groupes de versions sont remplacés, et ils utilisent l'identifiant de valeur : @Language devient zh, et non l'étiquette 中文. Les noms exportés restent ainsi stables. Dans un champ Modèle de prompt, @Language utilise l'étiquette.