> 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/construction/variables.md).

# Variables

![Catalogue des variables du bot](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-b766b311e510a680e973385920c3e8d90e156d1b%2Fvariables.png?alt=media)

Une variable de contexte est fournie par Discord ou par le parcours. Une variable **unique** correspond à une seule exécution. Une variable **persistante** garde une valeur sur le serveur qui héberge l’agent.

| Type                | Exemple            | Usage                                               |
| ------------------- | ------------------ | --------------------------------------------------- |
| Contexte            | `{user_mention}`   | Personnaliser un message                            |
| Unique              | `{nom_serveur}`    | Suivre un calcul ou une étape pendant une exécution |
| Persistante         | `{var_score}`      | Conserver un nombre entre deux exécutions           |
| Paramètre de module | `{module.message}` | Lire un réglage défini par l’utilisateur du module  |
| Secret              | `{secret.ma_cle}`  | Authentifier une requête dans un champ prévu        |

Dans **Variables**, définissez le nom, la description, le type, le niveau d’enregistrement (commune, utilisateur, salon ou utilisateur + salon) et la portée (par serveur Discord ou générale). Les types sont **Texte**, **Nombre**, **Booléen** et **Collection**. Leurs valeurs initiales sont respectivement le texte vide, 0, faux et la collection vide. Le dashboard ne lit pas les valeurs stockées sur votre serveur.

Une collection contient jusqu’à 500 lignes. Une position commence à 1 ; certaines lectures prennent une plage ou une ligne selon la syntaxe montrée par le sélecteur. Utilisez **Supprimer une variable** pour réinitialiser une valeur ou retirer des lignes. La suppression de la définition se fait depuis le catalogue.

Les noms de variables persistantes acceptent jusqu’à 32 caractères. Le moteur limite le texte à 16 384 octets, une valeur sérialisée à 131 072 octets et la base par bot à 64 Mio et 100 000 valeurs. Le nom reste fixe après création. La modification du type, du niveau ou de la portée crée une nouvelle révision. La purge demandée lors d’une suppression de définition efface les données locales au prochain déploiement.

| Référence                                                | Effet                                          |
| -------------------------------------------------------- | ---------------------------------------------- |
| `{var_score:user={user_id}}`                             | Vise un utilisateur                            |
| `{var_todo:channel={channel_id}}`                        | Vise un salon                                  |
| `{var_nom:default=Bienvenue}`                            | Définit un texte de secours pour cette lecture |
| `{var_nom:upper}`, `:lower`, `:length`                   | Transforme ou mesure un texte                  |
| `{var_todo:line=1}`, `:line=random`, `:count`, `:join=,` | Lit ou transforme une collection               |
| `{var_score:format=1 000}`                               | Formate un nombre                              |

Le ciblage d’un autre serveur avec `:server=ID` exige la permission **Gérer le serveur** dans le serveur ciblé. Pour sauvegarder des valeurs existantes, sauvegardez les données de l’instance sur la machine d’hébergement.

Sur un champ compatible, ouvrez le sélecteur. Le catalogue présente les options, le contexte, les variables personnalisées et les sorties disponibles. Pour une clé d’API, choisissez un [secret](/ia-et-api/secrets-api.md).

Le lien **Guide des variables** dans la page Variables ouvre l’aide intégrée sur les références et les collections. Consultez la [référence Boucle](/reference/blocs/loop.md) pour les blocs plus récents.

![Aide intégrée sur les variables, depuis le dashboard](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-38bc5ab2a0505545f80de9e0ab8bc7c6e864b41c%2Faide-variables.png?alt=media)

[Variables de contexte](/construction/variables-contexte.md) · [Variables et conditions](/tutoriels/variables-conditions.md) · [Variable unique](/reference/blocs/set-unique-variable.md)
