---
title: Variables dynamiques
description: >-
  Des espaces réservés {{name}} dans le prompt, remplis à chaque conversation depuis les données du contact ou une valeur par défaut du dialogue Variables.
---
Une variable dynamique est un espace réservé dans le prompt, écrit sous la forme `{{customer_name}}`,
qui est remplacé par une valeur réelle au démarrage d'une conversation. La valeur provient
du contact auquel l'agent s'adresse, ou d'une valeur par défaut que vous définissez dans la boîte de dialogue
**Variables** (Variables).

:::tip[Quand les utiliser]
Utilisez une variable partout où le prompt contiendrait sinon une information qui change d'un
appel à l'autre : le nom de la personne, son niveau d'abonnement, le produit qu'elle a acheté, l'agence
dont elle dépend. Un seul prompt sert alors toute une liste de contacts.
:::

## Fonctionnement

1. Écrivez `{{variable_name}}` n'importe où dans **Agent Identity** (identité de l'agent), **Tasks** (tâches),
   **Guardrails** (garde-fous) ou **First message** (premier message).
2. Le bouton **Variables** situé au-dessus du prompt ouvre **Dynamic Variables** (variables dynamiques), qui
   répertorie chaque espace réservé trouvé dans **Agent Identity**, **Tasks** et
   **Guardrails** et propose une valeur par défaut pour chacun.
3. Au moment de l'appel, une valeur issue du contact l'emporte ; sinon, la valeur par défaut est utilisée.

Seule la forme à doubles accolades est reconnue. `{name}` et `$name` restent du texte littéral.

![La boîte de dialogue Dynamic Variables après avoir écrit {{customer_name}} dans le prompt.](/media/build/dynamic-variables-dialog.webp)

## Configuration

1. Dans **Settings** (paramètres), écrivez l'espace réservé dans un champ du prompt, par exemple :

   ```text
   You are calling {{customer_name}} about their {{plan_name}} subscription.
   ```

2. Choisissez **Variables**. Chaque espace réservé apparaît avec un champ **Enter default value**
   (saisir une valeur par défaut). Indiquez ce que l'agent doit supposer lorsqu'aucune valeur n'est fournie.
3. Fermez la boîte de dialogue avec **Close** (fermer), puis enregistrez l'agent avec **Save** (enregistrer).

Si la boîte de dialogue affiche **No dynamic variables found in the prompt** (aucune variable dynamique trouvée dans le prompt), l'espace réservé est
mal orthographié ou n'est pas entre doubles accolades.

## Origine des valeurs

| Source | Comment la valeur parvient à l'agent |
|---|---|
| Mappage de la campaign | L'étape **Agent Variables** (variables de l'agent) d'une campaign associe chaque variable de l'agent à une **Data Source** (source de données), comme un **Contact Field** (champ du contact) ou une **Default Value** (valeur par défaut) fixe. Voir [Contacts](/fr/deploy/contacts) et [Créer une campaign sortante](/fr/deploy/campaigns/create-an-outbound-campaign). |
| Valeur par défaut | Définie dans la boîte de dialogue **Variables**. Utilisée dans les tests en navigateur et chaque fois qu'aucune valeur de contact n'existe. |

## Comportement et limites

- Les noms de variables sont comparés à l'identique : conservez donc un style unique, par exemple en
  minuscules avec des tirets bas.
- Un espace réservé sans valeur provenant de l'une ou l'autre source est lu tel quel par le modèle.
  Définissez toujours une valeur par défaut.
- Les variables sont substituées dans le prompt et dans le premier message, pas dans la
  configuration des outils.
- Les tests **Chat** (conversation écrite) et **Call** (appel) utilisent les valeurs par défaut, ce qui en fait le moyen le plus rapide
  de vérifier la formulation.

## Vérification

Définissez une valeur par défaut telle que `Jordan` pour `{{customer_name}}`, ouvrez **Chat** (agent textuel)
ou **Call** (agent vocal) sous **Testing** (tests) et demandez à l'agent à qui il s'adresse. Il doit répondre avec la
valeur par défaut.

## Dépannage

- **L'agent lit les accolades à voix haute.** Aucune valeur ne lui est parvenue. Vérifiez l'orthographe dans
  la boîte de dialogue **Variables** et définissez une valeur par défaut.
- **La variable n'apparaît pas dans la boîte de dialogue.** Elle est écrite avec des accolades simples, ou
  elle se trouve à un endroit que la boîte de dialogue n'analyse pas, comme **First message** ou la
  description d'un outil.

## Voir aussi

- [Guide de prompting](/fr/build/prompting/prompting-guide)
- [Premier message et conversation](/fr/build/prompting/first-message-and-conversation)
- [Contacts](/fr/deploy/contacts)
- [Créer une campaign sortante](/fr/deploy/campaigns/create-an-outbound-campaign)