# Variables

{% 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 **Automatisation → Variables.**

## Le tableau des variables

Dans la section **Automatisation → 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)

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

Les actions **Modifier** 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 **Automatisation → 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 pour une marque ou une localisation

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.

{% 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 %}

Ces valeurs permettent d’adapter dynamiquement les réponses générées en fonction de la marque ou l’établissement concerné par l’interaction client.

Rendez-vous dans Paramètres > [Marques](https://app.fullwhere.com/settings/brands) ou [Localisations](https://app.fullwhere.com/settings/stores) et sélectionner l'entité à modifier, puis dans la barre de navigation en haut de la page, cliquez sur l’onglet **Variables**

Vous accédez à la liste des **variables personnalisées disponibles sur votre espace Fullwhere**.

Le tableau affiche :

* **Nom** : le nom de la variable
* **Valeur** : la valeur actuellement définie pour la marque ou la localisation

Si **aucune valeur n’est définie**, un **tiret (-)** apparaît dans la colonne valeur.

#### Définir ou modifier une valeur

Pour définir ou modifier la valeur d’une variable :

1. Cliquez sur l’icône ✏️ située à droite de la ligne
2. Renseignez la valeur souhaitée
3. Cliquez sur **Enregistrer**

La valeur définie sera alors utilisée par vos **agents IA** lorsque la variable est appelée dans leurs instructions : lors de la génération d’une réponse, la variable utilisée dans l’agent sera **automatiquement remplacée par la valeur correspondant à la marque ou à la localisation concernée**.


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.