Vous pouvez utiliser des outils de widget pour créer des éléments d'UI riches et interactifs pour votre interface utilisateur de manière flexible. Lorsque vous configurez cet outil, vous fournissez un type (carrousel, comparaison, etc.) et des informations sur le schéma du widget. Lorsqu'il répond à des requêtes, l'agent peut décider d'utiliser cet outil et cette configuration pour renvoyer les données du widget à votre client. Votre client traite ensuite ces données et présente le widget dans votre interface utilisateur. Lorsque votre utilisateur fait une sélection, vous renvoyez ces informations à l'agent.
Configuration
Les paramètres de configuration suivants sont disponibles :
- Nom : nom unique de l'outil (obligatoire).
- Description : description de la fonction de l'outil (facultatif). Cela aide le modèle de langage de l'agent à comprendre quand utiliser cet outil et comment remplir les données.
- Type de widget :
Type spécifique de widget de contenu enrichi que cet outil représente.
Cela détermine la structure attendue de la charge utile et la façon dont le client doit la restituer.
Voici les types de données :
- PRODUCT_CAROUSEL : affiche un carrousel de produits que l'utilisateur peut faire défiler.
- PRODUCT_DETAILS : affiche des informations détaillées sur un seul produit.
- QUICK_ACTIONS : présente une liste de boutons de réponse suggérés ou d'actions que l'utilisateur peut effectuer.
- PRODUCT_COMPARISON : affiche une comparaison côte à côte de plusieurs produits.
- ORDER_SUMMARY : affiche le récapitulatif d'une commande.
- Paramètres : schéma d'entrée pour les données du widget. L'agent utilise le schéma lorsqu'il appelle l'outil. Il est défini à l'aide d'un objet de schéma, qui spécifie les champs et les types de données attendus pour le contenu du widget.
Exemples de descriptions d'outils
Voici des exemples de descriptions d'outils efficaces :
| Type de widget | Exemple de description d'outil |
|---|---|
| Carrousel de produits | Génère un composant de carrousel d'UI. Obligatoire chaque fois que l'utilisateur demande à voir des options ou un catalogue. Vous devez fournir la liste des produits dans productDetails. Le système affichera automatiquement la carte visuelle. |
| Informations détaillées sur le produit | Cet outil doit être appelé après avoir obtenu des informations sur un produit et essayé de le présenter à l'utilisateur. |
| Action rapide | Cet outil doit être appelé chaque fois que l'utilisateur est invité à indiquer s'il représente une entreprise, un établissement scolaire ou une organisation à but non lucratif. Incluez exactement trois actions rapides : "Je suis une entreprise", "Je suis un établissement scolaire" et "Je suis une organisation à but non lucratif". |
| Comparaison de produits | Cet outil doit être appelé lorsque vous êtes invité à comparer deux produits. |
| Récapitulatif de la commande | Utilisez cet outil lorsqu'un utilisateur est prêt à finaliser un achat. Il génère un récapitulatif visuel structuré de l'article, du détail du prix (y compris les taxes et les frais de port) et du mode de paiement enregistré. N'appelez cet outil qu'une fois que l'utilisateur a confirmé qu'il souhaitait passer à la phase de paiement. |