Skip to content

Déployer des agents personnalisés

Découvrez comment utiliser les agents personnalisés dans les étapes du canvas ou les champs du catalogue après les avoir créés. Pour une introduction, voir Agents Braze.

Utilisation des agents

Dans la section Utilisation de l’agent de votre agent, vous pouvez référencer et naviguer vers les endroits où l’agent est activement utilisé dans les catalogues et les toiles.

La section Utilisation des agents montre deux agents actifs et un agent inactif pour les toiles.

Agents in Canvas

Vous pouvez utiliser les agents comme des étapes d’un parcours pour personnaliser les messages ou guider la prise de décision en temps réel. Pour connaître les étapes détaillées de la configuration, reportez-vous à la section Étape de l’agent.

Cas d’utilisation

Agents dans les catalogues

Vous pouvez appliquer un agent aux champs du catalogue afin qu’il génère ou calcule automatiquement des valeurs pour chaque ligne. L’agent s’exécutera également sur les nouvelles lignes qui seront ajoutées au catalogue à l’avenir.

Cas d’utilisation

Étapes

Une étape de l'agent dans un champ du catalogue.

Pour ajouter un agent à votre champ de catalogue :

  1. Dans votre catalogue, ajoutez un nouveau champ.
  2. Sélectionnez Appliquer l’agent d’intelligence artificielle.
  3. Affectez un agent à ce champ.
  4. Sélectionnez les colonnes à transmettre en entrée. Si vous n’en sélectionnez aucun, l’agent aura accès à toutes les colonnes du catalogue.
  5. Décidez si l’agent doit recalculer les champs lorsque les lignes du catalogue sont mises à jour. Si vous ne sélectionnez pas cette option, l’agent ne s’exécutera qu’une fois par ligne.
  6. Sélectionnez Ajouter des champs pour déployer l’agent et examiner les estimations de coûts. La fenêtre modale/boîte de dialogue de l ‘estimation des coûts indique le nombre de fois que l’agent s’exécutera sur ce catalogue, à peu près égal au nombre total de lignes. Pour continuer, sélectionnez Confirmer.

Comment fonctionnent les agents de catalogue

Après le lancement, l’agent s’exécute et évalue chaque ligne, en prenant les colonnes sélectionnées dans son contexte pour produire un résultat. Les agents s’exécutent sur toutes les nouvelles lignes ajoutées après le déploiement de l’agent. Si vous avez sélectionné Recalculer lorsque les lignes du catalogue sont mises à jour, toutes les valeurs de ce champ sont mises à jour si les champs source existants sont modifiés.

Vous pouvez actualiser et modifier les champs de votre catalogue qui utilisent des agents. Pour supprimer un agent d’une colonne, désélectionnez Appliquer l’agent de l’intelligence artificielle. La colonne redevient une colonne non agencée et les champs conservent les dernières valeurs appliquées par l’agent lors de sa dernière exécution sur le catalogue.

Les références circulaires dans les catalogues ne sont pas prises en charge, ce qui signifie que le scénario suivant ne peut pas se produire :

  • La colonne agentique 1 utilise la colonne agentique 2 comme entrée.
  • La colonne agentique 2 utilise la colonne agentique 1 comme entrée.

L'option permettant de sélectionner "Appliquer l'agent d'intelligence artificielle" pour un champ du catalogue.

Définir les champs de réponse

Si votre agent utilise des champs comme format de sortie, vous pouvez sélectionner le champ correspondant dans l’agent pour le champ de réponse à utiliser dans le champ du catalogue.

Supposons que vous ayez un agent qui ajoute des descriptions de produits à un catalogue avec les champs suivants pour structurer le format de sortie :

Vous pouvez ajouter un champ nommé product_description à un catalogue et sélectionner description comme champ de réponse pour remplir la colonne avec les descriptions de l’agent.

Un champ "product_description" avec l'agent "Descriptor" appliqué. La sortie "description" est sélectionnée comme champ de réponse.

Vous pouvez également remplacer manuellement la cellule générée par l’agent en sélectionnant Modifier l’élément et en mettant à jour la description générée par l’agent avec vos modifications. Pour revenir à la description générée par l’agent, sélectionnez le symbole d’actualisation dans la cellule.

Gestion des erreurs dans les catalogues

  • Les invocations de catalogues qui échouent ne sont pas réessayées.
  • Si l’appel API au fournisseur du modèle de base renvoie une erreur, telle qu’une erreur de clé API non valide ou une erreur de limite de débit, la valeur du champ n’est pas mise à jour.
  • Vous pouvez consulter les journaux de l’agent pour obtenir des détails sur les échecs.
New Stuff!