Agents conversationnels
Les agents conversationnels sont un canal qui permet à vos utilisateurs de dialoguer avec un agent IA pour accomplir les tâches que vous définissez. Vous créez des workflows conversationnels qui décrivent ce que l’agent doit faire pour votre marque. Par exemple, un workflow peut aider un utilisateur à acheter des articles en fonction de ses préférences.

Les agents conversationnels sont actuellement en version bêta. Contactez votre gestionnaire de compte Braze si vous souhaitez participer à cette bêta.
Avant de déployer en production, consultez votre équipe juridique au sujet des implications liées à l’utilisation de l’IA conversationnelle.
Fonctionnement
Un flux de travail conversationnel correspond à une tâche que vous souhaitez confier à un agent. Chaque flux de travail comprend un objectif, des paramètres de canal, une audience cible et des étapes rédigées en langage naturel. Dans une étape, ajoutez des outils pour permettre à l’agent de rechercher dans des catalogues, de définir des attributs, d’enregistrer des événements ou d’appeler des webhooks.
Une fois vos flux de travail créés, consultez les Paramètres pour configurer les directives de marque et le comportement des canaux. Utilisez Prévisualiser une conversation, Créer des simulations et Consulter l’historique des conversations pour tester l’expérience et examiner les appels d’outils.
Configurer le widget de chat web
Pour afficher le widget de chat des Conversational Agents sur votre site, suivez les étapes ci-dessous dans le SDK Web de Braze.
Étape 1 : Configurer l’authentification SDK
Activez l’authentification SDK pour votre application Web.
Étape 2 : Installer le SDK Web
Installez l’une des options suivantes :
| Option | Détails |
|---|---|
| npm | Installez la dernière version du package @braze/web-sdk. |
| CDN | Chargez la version conversationnelle : https://js.appboycdn.com/web-sdk/latest/braze.conversational.min.js |
Étape 3 : Initialiser avec le JavaScript fourni par l’utilisateur activé
Dans votre appel initialize, définissez allowUserSuppliedJavascript: true :
braze.initialize("{YOUR_API_KEY}", {
baseUrl: "{YOUR_SDK_ENDPOINT}",
allowUserSuppliedJavascript: true
});
Remplacez {YOUR_API_KEY} par la clé API de votre SDK Web et {YOUR_SDK_ENDPOINT} par votre endpoint SDK.
Étape 4 : Activer le widget de chat
Avant d’ouvrir une session, appelez braze.automaticallyManageChat() :
braze.automaticallyManageChat();
braze.openSession();
Créer un workflow conversationnel
Utilisez un workflow conversationnel pour définir une tâche, choisir des canaux et une audience, et indiquer à l’agent ce qu’il doit faire à chaque étape.
Étape 1 : Configurer les détails du workflow
Accédez à Agents > Agents conversationnels, puis configurez les détails de votre workflow :
- Saisissez un nom pour le workflow.
- Saisissez un objectif qui décrit ce que fait ce workflow. L’agent s’appuie sur l’objectif et sur l’historique de la conversation pour choisir le workflow à utiliser. Décrivez donc dans quels cas le workflow s’applique. Par exemple : « L’utilisateur a des questions sur les horaires d’un événement ou sur les remboursements. »
- Sélectionnez les canaux pour lesquels ce workflow est activé. Les canaux pris en charge sont SMS, RCS, WhatsApp et Web.
- Pour le Web, sélectionnez les applications web pour lesquelles ce workflow est activé.
- Pour SMS, RCS et WhatsApp, sélectionnez les groupes d’abonnement pour lesquels ce workflow est activé.
- Sélectionnez les Segments auxquels un utilisateur doit appartenir pour accéder à ce workflow.

Les workflows ne sont pas liés à un Canvas. Un groupe d’abonnement ou une application web peut avoir plusieurs workflows, et l’agent passe de l’un à l’autre au cours d’une conversation. Pour limiter un workflow aux utilisateurs qui ont reçu un message Canvas spécifique, créez un Segment de ces utilisateurs et sélectionnez-le pour le workflow. Pour effectuer d’abord un test auprès d’une audience restreinte, utilisez un Segment comprenant un petit sous-ensemble d’utilisateurs.
Pour SMS, RCS et WhatsApp, certains déclencheurs de messages entrants peuvent bloquer l’agent. Sur la page Paramètres, passez en revue les déclencheurs susceptibles de bloquer les agents pour chaque groupe d’abonnement.
Étape 2 : Rédiger les étapes du workflow
Ajoutez les étapes que l’agent doit suivre pour mener à bien le workflow. Un workflow peut comporter jusqu’à 10 étapes. Chaque étape nécessite une instruction, qui peut contenir jusqu’à 5 000 caractères.
Pour les étapes avec un objectif unique, rédigez l’instruction en une à trois phrases courtes. Formulez des règles claires et terminez par une question ou une confirmation explicite, afin que l’agent sache comment formuler sa prochaine réponse à l’utilisateur.
Étape 3 : Ajouter des outils aux étapes
Les étapes peuvent inclure des outils que l’agent utilise pendant son travail. Dans les Instructions d’une étape, insérez des outils en saisissant / : ils apparaissent alors sous forme d’étiquettes dans l’instruction. Une étape peut faire référence à 10 outils au maximum.

Outils
Vous pouvez ajouter n’importe lequel de ces outils à une étape :
| Outil | Description |
|---|---|
| Rechercher dans les sources de connaissances | Interroger un catalogue par le biais d’une source de connaissances. |
| Définir un attribut de workflow | Stocker une valeur limitée à ce workflow. |
| Obtenir un attribut de workflow | Récupérer un attribut de workflow défini lors d’une étape précédente. |
| Enregistrer un événement personnalisé | Enregistrer un événement personnalisé Braze. |
| Définir un attribut personnalisé | Définir un attribut personnalisé sur l’utilisateur. |
| Obtenir un attribut personnalisé | Récupérer un attribut personnalisé de l’utilisateur. |
| Obtenir un attribut utilisateur | Récupérer un champ standard du profil utilisateur. |
| Appeler un webhook | Envoyer une requête HTTP vers un endpoint externe. |
| Obtenir la réponse d’un webhook | Récupérer un champ extrait d’une réponse de webhook précédente. |
Rechercher dans les sources de connaissances
Utilisez cet outil pour aider l’agent à interroger et à comprendre un catalogue Braze. Créez des sources de connaissances pour des catalogues tels que :
- Catalogue de produits
- FAQ
- Guides des tailles
Commencez par créer la source de connaissances sur la page Sources de connaissances. Ensuite, dans la zone de texte des instructions, saisissez / et sélectionnez Rechercher dans les sources de connaissances. Sélectionnez un outil de source de connaissances conversationnelle existant ou sélectionnez Créer un nouvel outil de recherche.
Lorsque vous créez un nouvel outil, saisissez un nom et une description, puis sélectionnez une source de connaissances. Choisissez ensuite les champs auxquels l’agent peut accéder.
Définir un attribut de workflow
Utilisez cet outil pour définir un attribut que l’agent pourra réutiliser plus tard dans le même workflow. Les attributs de workflow sont limités au workflow dans lequel ils sont définis. Utilisez-les comme propriétés d’événement personnalisé, valeurs d’attribut personnalisé et paramètres de webhook.
Lorsque vous créez l’attribut, vous pouvez éventuellement ajouter des Valeurs autorisées :
- Laissez les valeurs autorisées vides pour permettre à l’agent de définir n’importe quelle valeur de ce type en fonction de la conversation.
- Ajoutez des valeurs autorisées pour limiter l’agent à un sous-ensemble que vous définissez. Cette option est utile lorsque des outils ultérieurs (comme Appeler un webhook, Enregistrer un événement personnalisé ou Définir un attribut personnalisé) doivent réutiliser une valeur contrôlée plutôt qu’un choix libre de l’agent.
Dans Instruction, saisissez / et sélectionnez Définir un attribut de workflow. Sélectionnez un attribut de workflow existant ou sélectionnez Créer un nouvel attribut.
Lorsque vous créez un nouvel attribut, saisissez un nom et une description, puis sélectionnez le type. Une fois le type sélectionné, ajoutez éventuellement des valeurs autorisées. Chaque valeur autorisée doit comporter une valeur de 100 caractères maximum et une description de 250 caractères maximum. Les valeurs doivent être uniques, et un attribut peut avoir jusqu’à 250 valeurs autorisées.
Avec des valeurs autorisées, l’agent choisit l’une de vos valeurs même lorsque l’utilisateur la formule différemment. Par exemple, si un attribut skin_type n’autorise que dry et oily, et qu’un utilisateur décrit sa peau avec un synonyme de « sèche », l’agent définit dry. Sans valeurs autorisées, l’agent choisit une valeur à partir de la description de l’attribut et des instructions de votre étape, qu’il suit généralement, mais pas toujours de manière stricte.
Pour enregistrer une valeur contrôlée dans un profil utilisateur, utilisez deux outils dans la même étape :
- Utilisez Définir un attribut de workflow pour définir l’attribut une fois que l’utilisateur a confirmé sa réponse.
- Utilisez Définir un attribut personnalisé, puis sélectionnez Attribut de workflow comme source de la valeur de l’attribut personnalisé.
Obtenir un attribut de workflow
Utilisez cet outil pour récupérer la valeur d’un attribut de workflow défini lors d’une étape précédente.
Enregistrer un événement personnalisé
Utilisez cet outil pour enregistrer un événement personnalisé Braze. Dans la zone de texte des instructions, saisissez / et sélectionnez Enregistrer un événement personnalisé. Sélectionnez un outil d’enregistrement d’événement personnalisé existant ou sélectionnez Créer un nouvel outil d’événement personnalisé.
Lorsque vous créez un nouvel outil, sélectionnez l’événement personnalisé, puis saisissez un nom et une description. Choisissez les propriétés d’événement à envoyer avec l’événement personnalisé. Chaque propriété d’événement personnalisé peut utiliser l’une des sources suivantes :
| Source | Description |
|---|---|
| Agent | L’agent détermine la valeur en fonction des instructions et de la description de l’outil. |
| Attribut de workflow | La propriété utilise un attribut de workflow que l’agent a défini lors d’une étape précédente. |
| Attribut personnalisé | La propriété utilise un attribut personnalisé de l’utilisateur. |
Vous n’êtes pas obligé de définir une valeur pour chaque propriété. Certains types de propriétés ne sont pas pris en charge.
Sélectionnez Obligatoire si l’outil doit échouer lorsque la valeur de la propriété est vide.
Pour faire entrer un utilisateur dans un Canvas, enregistrez un événement personnalisé que le Canvas utilise comme propriété d’entrée.
Définir un attribut personnalisé
Utilisez cet outil pour définir un attribut personnalisé sur l’utilisateur. Dans la zone de texte des instructions, saisissez / et sélectionnez Définir un attribut personnalisé. Sélectionnez un outil de définition d’attribut personnalisé existant, ou sélectionnez Créer un nouvel outil d’attribut personnalisé.
Lorsque vous créez un nouvel outil, saisissez un nom et une description, puis sélectionnez l’attribut personnalisé que l’outil doit définir. Un attribut personnalisé peut utiliser l’une des sources suivantes :
| Source | Description |
|---|---|
| Agent | L’agent détermine la valeur en fonction des instructions et de la description de l’outil. |
| Attribut de workflow | L’attribut utilisateur utilise un attribut de workflow que l’agent a défini lors d’une étape précédente. |

Les attributs personnalisés sont définis de manière asynchrone. Si l’agent lit un attribut personnalisé juste après l’avoir défini, la valeur peut ne pas encore être à jour.
Obtenir un attribut personnalisé
Utilisez cet outil pour récupérer un attribut personnalisé.
Obtenir un attribut utilisateur
Utilisez cet outil pour récupérer un champ standard du profil utilisateur. Dans la zone de texte des instructions, saisissez une barre oblique (/) et sélectionnez Obtenir un attribut utilisateur. Choisissez l’un des champs suivants :
- ID externe
- ID Braze
- Prénom
- Nom
- Téléphone
Appeler un webhook
Utilisez cet outil pour appeler un webhook. Dans la zone de texte des instructions, saisissez / et sélectionnez Appeler un webhook. Sélectionnez un outil de webhook existant ou sélectionnez Créer un nouveau webhook.
Lorsque vous créez un nouvel outil, saisissez un nom et une description, puis ajoutez des variables. Les variables vous permettent d’inclure des valeurs personnalisées dans l’URL, le corps ou les en-têtes du webhook.
Une variable peut utiliser l’une des sources suivantes :
| Source | Description |
|---|---|
| Agent | L’agent détermine la valeur en fonction des instructions et de la description. |
| Attribut de workflow | La variable utilise un attribut de workflow que l’agent a défini lors d’une étape précédente. |
| Attribut personnalisé | La variable utilise un attribut personnalisé de l’utilisateur. |
| Profil utilisateur | La variable utilise un champ du profil utilisateur : ID externe, ID Braze, e-mail, prénom, nom ou téléphone. |
Une fois les variables définies, choisissez la méthode de requête. Les méthodes de requête suivantes sont prises en charge :
GETPOSTPUTPATCHDELETE
Saisissez ensuite l’URL. Pour utiliser des variables dans l’URL, référencez-les avec la syntaxe {{variable_name}}. Par exemple :
https://myurl.com/create/{{user_id}}
Définissez ensuite le corps de la requête. Laissez le corps vide ou saisissez une chaîne de caractères pouvant inclure des marques substitutives {{variable_name}}. Pour la plupart des API, envoyez un corps JSON. Par exemple :
{
"user": {
"id": "{{external_id}}",
"favorite_color": "{{favorite_color}}",
"is_called_by_agent": true
}
}
Vous pouvez également définir des en-têtes à l’aide de variables. Pour les identifiants, créez des identifiants de contenu connecté dans le tableau de bord et référencez-les dans cet outil.
Les réponses de webhook pouvant être volumineuses, vous pouvez extraire uniquement les champs dont le workflow a besoin. Créez des champs de réponse avec une expression JMESPath qui pointe vers une valeur du corps de la réponse. Le corps de la réponse doit être un JSON valide pour que ces champs puissent être extraits. Référencez ensuite ces champs avec l’outil Obtenir la réponse d’un webhook.
Obtenir la réponse d’un webhook
Utilisez cet outil pour référencer un champ de réponse de webhook extrait d’une étape Appeler un webhook précédente.
Paramètres
Configurez les directives de marque et le comportement des canaux pour les agents conversationnels. Accédez à Agents > Agents conversationnels, puis sélectionnez Paramètres.
Directives de marque
Sélectionnez les directives de marque que l’agent doit suivre dans ses réponses. Créez et gérez vos directives depuis Contenu > Directives de marque, puis choisissez-en une ici.
Paramètres Web
Définissez un Message d’ouverture. Il s’agit du premier message que voient les utilisateurs lorsqu’ils démarrent une conversation sur le Web.
Paramètres SMS, RCS et WhatsApp
Configurez les éléments suivants :
| Paramètre | Description |
|---|---|
| Limite quotidienne de tours | Le nombre maximal de tours par utilisateur et par jour pour les canaux de communication. |
| Message de divulgation de l’IA | Texte qui ouvre la première réponse de l’agent dans chaque conversation SMS, RCS et WhatsApp. Vous pouvez le reformuler, mais pas le désactiver. Laissez le champ vide pour utiliser le message par défaut. |
| Déclencheurs susceptibles de bloquer les agents | Une liste des déclencheurs de messages entrants pour chaque groupe d’abonnement activé dans un flux de travail. Si un message entrant active l’un de ces déclencheurs, l’agent conversationnel ne répond pas. |
Les déclencheurs susceptibles d’être prioritaires sont notamment :
- Déclencheurs par mot-clé
- Campagnes basées sur des actions
- Entrée dans un Canvas basée sur des actions
- Parcours d’action de Canvas
- Sortie de Canvas
Prévisualiser une conversation
Vous disposez de deux façons de prévisualiser :
- Lorsque vous modifiez un workflow enregistré, vous prévisualisez uniquement ce workflow. La prévisualisation n’est pas disponible tant que vous n’avez pas enregistré un nouveau workflow.
- Sur la page Paramètres, prévisualisez l’expérience pour une application web ou un groupe d’abonnement. Vous pouvez également sélectionner Inclure les workflows en brouillon pour tester des workflows en brouillon avant de les activer.
Dans les deux cas, la prévisualisation s’effectue en tant qu’utilisateur spécifique.

Le mode de prévisualisation n’enregistre ni les attributs personnalisés ni les événements personnalisés.
Créer des simulations
Une simulation teste les flux de travail conversationnels de votre espace de travail sans utilisateur réel. Créez des cas qui décrivent un scénario et les résultats que vous attendez. Un utilisateur simulé suit ce scénario. À la fin de la conversation, un évaluateur compare la conversation et les appels d’outils à ces résultats. Simulez les réponses des webhooks pour que les cas restent prévisibles.
Accédez à Agents > Agents conversationnels, puis sélectionnez Simulations.
Créer un cas
Dans l’onglet Cas, sélectionnez Créer un cas, puis configurez les éléments suivants :
| Champ | Description |
|---|---|
| Nom du cas | Un nom unique pour le cas. |
| Flux de travail | Les flux de travail dans lesquels la conversation peut entrer. Sélectionnez-en au moins un. |
| Utilisateur | L’utilisateur au nom duquel la conversation s’exécute, en mode test. Recherchez par adresse e-mail, numéro de téléphone ou ID utilisateur externe. |
| Premier message de l’utilisateur | Le premier message envoyé par l’utilisateur simulé. |
| Ce que l’utilisateur veut, comment il se comporte et ce qu’il sait | Le scénario. L’utilisateur simulé ne sait que ce que vous écrivez ici. Par exemple, un utilisateur frustré au sujet d’un remboursement, ou un utilisateur qui souhaite prendre rendez-vous. |
| Résultats attendus | Un énoncé vérifiable pour chaque action ou réponse attendue de l’agent, par exemple « L’agent donne à l’utilisateur une adresse e-mail d’assistance. » Vous pouvez en ajouter jusqu’à 10. |
| Réponses des webhooks | Facultatif. Activez Réponse simulée pour un webhook, puis saisissez des valeurs fixes à renvoyer au lieu d’appeler votre endpoint. |
Créez un cas pour chaque scénario que vous souhaitez tester, par exemple un utilisateur frustré, un utilisateur qui souhaite réserver et un utilisateur qui a une question sur un remboursement.
Lancer une simulation et examiner les résultats
Sélectionnez Lancer la simulation, choisissez les cas à exécuter, puis sélectionnez Démarrer l’exécution. Consultez les exécutions précédentes dans l’onglet Exécutions.

Braze appelle tout webhook qu’un cas ne simule pas. Pour éviter d’appeler vos endpoints, simulez chaque webhook utilisé par les flux de travail.
Chaque cas d’une exécution affiche la conversation entre l’utilisateur simulé et l’agent, ainsi qu’un résultat accompagné d’une explication pour chaque résultat attendu :
- Réussi
- Échoué
- Non concluant, lorsque la conversation ne contient pas suffisamment d’éléments pour trancher
Un cas échoue si l’un des résultats échoue. Si aucun résultat n’échoue mais que l’un d’eux est non concluant, le cas est non concluant. Sinon, le cas réussit.
Consulter l’historique des conversations
Sur la page Agents conversationnels, sélectionnez Historique des conversations. Cette page affiche les conversations avec de vrais utilisateurs ainsi que celles issues de la prévisualisation.
Consultez l’historique des conversations pour examiner les appels d’outils et vérifier que l’agent se comporte comme prévu.

Exemple
Flash & Thread, une marque fictive de prêt-à-porter, pourrait utiliser ce workflow d’achat en deux étapes.
- Étape 1 : Demande à l’utilisateur quelle catégorie de produits il recherche.
- Étape 2 : Utilise l’outil Définir un attribut de workflow pour enregistrer un attribut product_category sous forme de chaîne de caractères. Cet attribut indique la catégorie de produits que l’utilisateur déclare rechercher aujourd’hui à l’Étape 1.
