Créer des agents personnalisés

Découvrez comment créer des agents personnalisés, ce qu’il convient de préparer avant de commencer et comment les mettre en œuvre dans les domaines de l’envoi de messages, de la prise de décision et de la gestion des données. Pour obtenir des informations générales, veuillez consulter la section Agents Braze.

Conditions préalables

Avant de commencer, vous aurez besoin des éléments suivants :

• Autorisation d’accéder à la console d’agent dans votre espace de travail. Veuillez vérifier auprès de vos administrateurs Braze si cette option n’apparaît pas.
• Autorisation de créer et de modifier des agents d’intelligence artificielle personnalisés.
• Une idée de ce que vous souhaitez que l’agent accomplisse. Les agents Braze peuvent prendre en charge les actions suivantes :
  • Envoi de messages : Générez des lignes d’objet, des titres, des textes intégrés au produit ou tout autre contenu.
  • Prise de décision : Dirigez les utilisateurs dans Canvas en fonction de leur comportement, de leurs préférences ou d’attributs personnalisés.
  • Gestion des données : Veuillez calculer les valeurs, enrichir les entrées du catalogue ou actualiser les champs du profil.

Fonctionnement

Lorsque vous créez un agent, vous définissez son objectif et établissez des garde-fous quant à son comportement. Une fois en ligne/en production/instantané, l’agent peut être déployé dans Braze pour générer des copies personnalisées, prendre des décisions en temps réel ou mettre à jour les champs du catalogue. Vous pouvez suspendre ou mettre à jour un agent à tout moment depuis le tableau de bord.

Les cas d’utilisation suivants illustrent quelques façons de tirer parti des agents personnalisés.

Créer un agent

Étape 1 : Veuillez sélectionner un type d’agent

Pour créer votre agent personnalisé :

1. Veuillez vous rendre dans la console des agents > Gestion des agents dans le tableau de bord de Braze.
2. Veuillez sélectionner Créer un agent.
3. Veuillez choisir de créer un agent canvas ou un agent catalogue.

Étape 2 : Détails de la configuration

Veuillez ensuite configurer les détails de votre agent :

1. Veuillez saisir un nom et une description afin d’aider votre équipe à comprendre son objectif.
2. (facultatif) Veuillez ajouter des étiquettes pour filtrer votre agent.
3. Veuillez sélectionner le modèle que votre agent devra utiliser.
4. Veuillez sélectionner le niveau de réflexion du modèle. Vous avez le choix entre minimal, faible, moyen ou élevé. Nous vous recommandons de commencer par le mode Minimal, de tester les réponses de votre agent et de l’ajuster si nécessaire.

Étape 3 : Veuillez rédiger les instructions.

Veuillez donner des instructions à l’agent. Nous recommandons d’inclure des instructions sur la conduite à tenir par l’agent dans des situations imprévues ou ambiguës. Cela minimise le risque que la confusion des agents entraîne des erreurs. Par exemple, plutôt que de demander à l’agent uniquement des valeurs de sentiment « positives » ou « négatives », veuillez lui demander de renvoyer « incertain » s’il ne parvient pas à se prononcer.

Veuillez consulter les instructions de rédaction pour connaître les meilleures pratiques et les exemples pour trouver l’inspiration sur la manière de guider votre agent.

Étape 3.1 : Ajouter un contexte

Veuillez sélectionner Ajouter un contexte pour choisir les éléments auxquels votre agent peut se référer. Ceci comprend :

• Champs du catalogue : Veuillez autoriser l’agent à accéder aux données de votre catalogue afin d’obtenir des réponses plus précises.
• Appartenance au segment : Permettez à l’agent de réaliser la personnalisation des réponses en fonction des segments auxquels appartient l’utilisateur. Vous pouvez sélectionner jusqu’à cinq segments.
• Directives relatives à la marque : Veuillez vous référer aux directives relatives au ton et au style de la marque que l’agent doit respecter. Par exemple, si vous souhaitez que votre agent génère un SMS pour encourager les utilisateurs à effectuer une inscription à une salle de sport, vous pouvez utiliser ce champ pour faire référence à votre directive prédéfinie, rédigée en gras et motivante.
• Contexte général : canvas Analysez toutes les données de contexte canvas pour un utilisateur lorsque cet agent est invoqué, y compris toutes les variables qui ne sont pas référencées dans la section Instructions.

Étape 3.2 : Ajouter des paramètres facultatifs

Dans les paramètres optionnels, vous pouvez ajuster la température de la copie générée par l’agent. Une température plus élevée permet à l’agent d’utiliser les informations fournies de manière plus créative.

Vous pouvez également définir la limite d’exécution quotidienne pour votre agent. Par défaut, cette valeur est définie sur 250 000, mais elle peut être augmentée jusqu’à 1 000 000. Si vous souhaitez augmenter la limite au-delà de 1 000 000, veuillez contacter votre gestionnaire de la satisfaction client pour en savoir plus.

Étape 4 : Veuillez sélectionner la sortie

Dans la section Sortie, vous pouvez organiser et définir la sortie de l’agent à l’aide de schémas de base ou de schémas avancés.

Pour obtenir les meilleurs résultats, veuillez vous assurer que les informations que vous avez saisies dans la section Sortie correspondent aux instructions de l’agent que vous avez saisies à l’étape 3. Par exemple, si vous avez indiqué dans les instructions de l’agent que vous souhaitez un objet avec deux chaînes de caractères, veuillez vous assurer de spécifier un objet avec deux chaînes de caractères dans la section Sortie. Si les instructions de votre agent ne correspondent pas au résultat souhaité, l’agent peut être désorienté, expirer ou générer des résultats indésirables.

Schémas de base

Les schémas de base sont une sortie simple renvoyée par un agent. Il peut s’agir d’une chaîne de caractères, d’un nombre, d’une valeur booléenne, d’un tableau de chaînes de caractères ou d’un tableau de nombres.

Par exemple, si vous souhaitez recueillir les notes attribuées par les utilisateurs dans le cadre d’un simple sondage afin de déterminer leur niveau de satisfaction après avoir reçu un produit, vous pouvez sélectionner Nombre comme schéma de base pour structurer le format de sortie.

Schémas avancés

Les options avancées du schéma comprennent la structuration manuelle des champs ou l’utilisation de JSON.

• Domaines : Une méthode sans code pour appliquer une sortie d’agent que vous pouvez utiliser de manière cohérente.
• JSON : Une approche par code pour créer un format de sortie précis, où vous pouvez imbriquer des variables et des objets dans le schéma JSON. Uniquement disponible pour les agents canvas, pas pour les agents catalogue.

Nous vous recommandons d’utiliser des schémas avancés lorsque vous souhaitez que l’agent renvoie une structure de données avec plusieurs valeurs définies de manière structurée, plutôt qu’une sortie à valeur unique. Cela permet de mieux formater la sortie en tant que variable de contexte cohérente.

Par exemple, vous pouvez utiliser un format de sortie dans un agent destiné à créer un exemple d’itinéraire de voyage pour un utilisateur en fonction d’un formulaire qu’il a soumis. Le format de sortie vous permet de définir que chaque réponse de l’agent doit renvoyer les valeurs ,tripStartDate tripEndDate, etdestination. Chacune de ces valeurs peut être extraite des variables de contexte et placée dans une étape Message pour être soumise à une personnalisation à l’aide de Liquid.

• fields
• json schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string"
    },
    "reasoning": {
      "type": "string"
    }
  },
  "required": [
    "sentiment",
    "reasoning"
  ]
}

Étape 5 : Veuillez tester et créer l’agent.

Le volet Aperçu est une instance de l’agent qui s’affiche sous la forme d’un panneau côte à côte dans l’expérience de configuration. Vous pouvez l’utiliser pour tester l’agent pendant que vous le créez ou le mettez à jour afin de le découvrir de la même manière que les utilisateurs finaux. Cette étape vous permet de vérifier que tout fonctionne comme prévu et vous donne l’occasion d’effectuer des ajustements avant que le système ne soit en ligne/en production/instantané.

1. Dans le champ Testez votre agent, veuillez saisir des exemples de données clients ou de réponses clients, c’est-à-dire tout ce qui reflète des scénarios réels auxquels votre agent sera confronté.
2. Prévisualisez la réponse de l’agent pour un utilisateur aléatoire, un utilisateur existant ou un utilisateur personnalisé.
3. Veuillez sélectionner Simuler la réponse. L’agent exécutera en fonction de votre configuration et affichera sa réponse. Les essais comptent dans votre limite d’exécution quotidienne.

Veuillez examiner attentivement le résultat. Veuillez prendre en considération les questions suivantes :

• Le texte correspond-il à l’image de marque ?
• La logique décisionnelle oriente-t-elle les clients comme prévu ?
• Les valeurs calculées sont-elles exactes ?

Si quelque chose ne semble pas fonctionner correctement, veuillez mettre à jour la configuration de l’agent et réessayer. Veuillez tester plusieurs entrées différentes afin d’observer comment l’agent s’adapte à différents scénarios, en particulier dans les cas extrêmes tels que l’absence de données ou les réponses non valides.

Étape 6 : Veuillez utiliser votre agent

Votre agent est désormais prêt à l’emploi. Pour plus de détails, veuillez vous référer à la section Déployer des agents.

Articles connexes

• Référence pour les agents