> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/automatisations/variables.md).

# Variables

Utilisez des variables pour rendre vos agents IA dynamique en fonction du contexte

{% hint style="success" %}
**EN BREF**

Approfondissez encore davantage vos agents IA grâce aux variables personnalisées qui permettent de personnaliser dynamiquement vos agents IA en fonction du contexte.
{% endhint %}

{% hint style="info" icon="lightbulb" %}
Les **variables personnalisées** permettent d’insérer dynamiquement des informations dans les réponses générées par vos agents IA.\
Elles sont particulièrement utiles lorsque vous gérez **plusieurs marques ou localisations** et que certaines informations doivent varier selon le contexte (par exemple un lien de réservation, un menu, ou une description spécifique).
{% endhint %}

{% hint style="info" icon="shield-check" %}
**DROITS D'ACCÈS**

Pour modifier les Variables de votre espace Fullwhere, il faut être un membre superviseur avec des droits Administrateur.
{% endhint %}

Une variable est définie une seule fois dans votre workspace, puis vous pouvez **définir une valeur différente pour chaque localisation ou marque**.

Par exemple :

* une variable **description des activités** peut contenir un texte différent pour chacune de vos localisations
* une variable **lien de réservation** peut pointer vers une URL différente pour chacun de vos établissements

Lorsqu’un agent IA génère une réponse, la variable utilisée dans ses instructions est **automatiquement remplacée par la valeur correspondant à la localisation concernée par l’interaction client**.

***

Pour accéder à la configuration des variables, rendez-vous dans **Paramètres → Variables.**

## Le tableau des variables

Dans la section **Paramètres → Variables**, vous trouverez la liste de toutes les variables personnalisées présentes sur votre workspace.

Pour chaque variable, le tableau affiche :

* **Nom** : le nom lisible de la variable
* **Variable** : le placeholder à utiliser dans les agents
* **Type** : le type de variable (Texte ou Lien)
* **Valeur** : le bouton Modifier les valeurs vous permet d'accéder rapidement à l'édition de la valeur de votre variable pour chacune de vos localisations et marques.

Depuis ce tableau, vous pouvez :

* rechercher une variable via la barre de recherche
* créer une nouvelle variable
* modifier une variable existante
* supprimer une variable
* modifier les valeurs de votre variable pour vos marques et localisations

Les actions **Modifier**, **Modifier les valeurs** et **Supprimer** sont accessibles via les trios point **⋯** à droite de chaque variable.

***

## Créer une variable personnalisée

Pour créer une variable, cliquez sur **Créer une variable** et configurer les champs de votre variable

{% stepper %}
{% step %}

### Type

Détermine le type de contenu de la variable :

* **Texte** : pour des contenus textuels (ex : description d’activités)
* **Lien** : pour insérer des URLs dynamiques (ex : lien de réservation)
  {% endstep %}

{% step %}

### Nom

Nom lisible de la variable dans l’interface.\
Exemple : `Lien de réservation`
{% endstep %}

{% step %}

### Variable (placeholder)

Identifiant utilisé dans les agents pour appeler la variable.

Bonnes pratiques :

* utiliser uniquement **des lettres minuscules**
* utiliser des **tirets ou underscores**
* **pas d’accent ni d’espace**

Exemple : `lien_de_reservation`.

Pour utiliser une variable personnalisée dans un agent IA, vous devez l'insérer dans les instructions de votre agent en utilisant `{{}}`, par exemple `{{lien_de_reservation}}`.
{% endstep %}
{% endstepper %}

***

## Modifier une variable

Pour modifier une variable existante :

1. Rendez-vous dans **Paramètres → Variables**
2. Cliquez sur le menu **⋯** à droite de la variable
3. Sélectionnez **Modifier**

Vous pouvez modifier :

* **le nom de la variable**
* **le placeholder (variable)**

Une fois créé, le type d'une variable ne peut pas être modifié.

{% hint style="danger" %}
Si vous modifiez le **placeholder** d’une variable, vous devrez également **mettre à jour toutes les occurrences de cette variable dans vos agents**.\
Sinon, les anciennes références ne fonctionneront plus.
{% endhint %}

***

## Supprimer une variable

Pour supprimer une variable :

1. Rendez-vous dans **Automatisation → Variables**
2. Cliquez sur le menu **⋯** à droite de la variable
3. Sélectionnez **Supprimer**
4. Confirmez la suppression

{% hint style="danger" %}
La suppression d’une variable entraîne :\
\- la suppression définitive de la variable\
\- la suppression de toutes ses valeurs associées dans vos marques et localisations

Si la variable était utilisée dans des agents IA, elle ne sera plus reconnue dans les instructions.

**Cette action est irréversible.**
{% endhint %}

## Définir la valeur d’une variable par marque et localisation

{% hint style="info" icon="shield-check" %}
**DROITS D'ACCÈS**

Pour modifier la valeur d'une variable pour une marque ou une localisation, vous devez avoir des droits d'édition sur cette ressource.
{% endhint %}

Une fois une variable personnalisée créée, vous pouvez **définir sa valeur pour chaque marque ou localisation** afin qu’elle puisse être utilisée correctement par vos agents IA, permettant d’adapter dynamiquement les réponses générées en fonction de la marque ou l’établissement concerné par l’interaction client.

Pour cela, depuis le tableau des variables personnalisées, ou depuis le menu de modification d'une variable personnalisée, cliquez sur le bouton **Modifier les valeurs**.

L'onglet **Localisations** affiche toutes vos localisations : vous pouvez alors facilement définir ou modifier la valeur de votre variable pour chacune de vos localisations.

L'onglet **Marques** affiche toutes vos marques : vous pouvez alors facilement définir ou modifier la valeur de votre variable pour chacune de vos marques.

Vous pouvez également à tout moment modifier la valeur de vos variables depuis le paramétrage de vos [Localisations](/commencer/localisations.md#onglet-variables) et de vos [Marques](/commencer/marques.md#onglet-variables).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fullwhere.com/automatisations/variables.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.