> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/reference/blocs/set-variable.md).

# Définir une variable

**Catégorie** — Variables

Écrit dans une variable persistante du bot. Créez la définition avant d’enregistrer l’action.

![Définir une variable dans le builder](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-02344529e3b819af70d91d037e877242cb5ba8eb%2Fset-variable.png?alt=media)

## Paramètres

| Réglage            | Valeurs acceptées                                                                                                                                                                                           |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Variable           | Définition texte, nombre, booléen ou collection.                                                                                                                                                            |
| Action             | Texte : définir. Nombre : définir, ajouter, soustraire ou multiplier. Booléen : vrai, faux ou inverser. Collection : ajouter au début ou à la fin, insérer, remplacer une ligne ou remplacer la collection. |
| Consigne de valeur | Texte ou nombre selon le type. Une collection peut prendre une ligne de saisie par élément.                                                                                                                 |
| Position           | À partir de 1 pour insertion ou mise à jour.                                                                                                                                                                |
| Cibles             | Serveur, membre ou salon courant ou autre ID selon la portée.                                                                                                                                               |

## Entrées, sorties et variables

Une entrée et une sortie. La variable est lue par `{var_nom}` ; les champs compatibles prennent les références du sélecteur.

## Exécution et limites

La valeur est stockée sur le serveur de l’agent et peut être réutilisée lors d’une autre exécution.

## Exemple

Incrémentez la variable nombre `score` d’une unité, puis affichez `{var_score}`.

## Erreurs courantes

Vérifiez la définition, le type et la portée. Pour une valeur locale à l’exécution, choisissez Définir une variable unique.

## Blocs associés

[Supprimer une variable](/reference/blocs/delete-variable.md) · [Définir une variable unique](/reference/blocs/set-unique-variable.md) · [Comparaison](/reference/blocs/comparison-condition.md)
