L'agent prédéfini basé sur le playbook d'assistant shopping fournit des requêtes sur les produits de vente au détail, les commandes, l'état de la commande et les annulations de commandes. Il utilise Vertex AI Search for Retail et des charges utiles de traitement personnalisées, offrant ainsi une expérience visuelle riche.
Exemples de dialogues
Les exemples de dialogues suivants illustrent des scénarios courants gérés par cet agent prédéfini.
Comparaison de produits et d'avis
L'utilisateur demande à parcourir des saris traditionnels. L'agent présente quelques options populaires, et l'utilisateur sélectionne la première. L'utilisateur demande des chaussures assorties. L'agent présente des options populaires, et l'utilisateur demande à comparer les avis et sélectionne l'option la mieux notée. L'agent demande la taille et confirme que les chaussures ont été ajoutées au panier.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| show me traditional sarees | |
| [Présente des produits] L'un de ces produits vous intéresse-t-il ou recherchez-vous d'autres options ? | |
| 1st one is looking good | |
| Excellent choix ! Le sari indien Self Design, Printed Fashion Georgette est une pièce magnifique. Comme les saris sont généralement de taille unique, il vous ira parfaitement. Souhaitez-vous l'ajouter à votre panier ? | |
| do you have a matching heels with it? | |
| [Présente des produits] L'un de ces produits vous intéresse-t-il ou recherchez-vous d'autres options ? | |
| yes but can you go through the customer review and pick the best one from these | |
| Les chaussures à talons plats pour femmes ont une note moyenne de 4 étoiles sur 5, tandis que les chaussures à talons Glitzy Galz pour femmes ont une note moyenne de 4,5 étoiles sur 5. Les clients qui ont acheté les chaussures à talons plats pour femmes ont laissé des avis mitigés. Certains les ont trouvées confortables au début, mais inconfortables après quelques heures, tandis que d'autres ont loué leur confort. Les chaussures à talons Glitzy Galz pour femmes, quant à elles, ont reçu des avis majoritairement positifs, les clients louant leur coupe, leur qualité et leur design. Lesquelles souhaitez-vous ajouter à votre panier ? | |
| whichever has the best review and ratings | |
| Les chaussures à talons Glitzy Galz pour femmes ont la meilleure note : 4,5 étoiles sur 5. Quelle taille souhaitez-vous pour les chaussures à talons Glitzy Galz pour femmes ? Nous proposons des tailles allant du 36 au 45. | |
| 6 | |
| Parfait. Les chaussures à talons Glitzy Galz pour femmes en taille 39 ont été ajoutées à votre panier (quantité : 1). Souhaitez-vous ajouter autre chose à votre panier ? |
Expérience d'achat de bout en bout
L'utilisateur parcourt le catalogue de produits. L'agent présente des recommandations en fonction de la demande de l'utilisateur. Après quelques recherches, l'utilisateur trouve un article à acheter. L'agent confirme la taille et la quantité de l'article à acheter, ainsi que la date de livraison prévue. L'utilisateur demande une autre date de livraison, qui n'est pas disponible, et accepte la date de livraison initiale. L'agent confirme les informations de livraison, de paiement et de contact enregistrées. L'utilisateur met à jour les informations de livraison et confirme. L'agent enregistre la commande et fournit le numéro de commande à l'utilisateur.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| It is getting cold. Do you have good sweaters | |
| [Présente des produits]. L'un de ces produits vous intéresse-t-il ou recherchez-vous d'autres options ? | |
| I like the women's sweater for my wife, but i am looking for a boy's sweater | |
| [Présente des produits]. L'un de ces produits vous intéresse-t-il ou recherchez-vous d'autres options ? | |
| add the first women's sweater to the cart | |
| Quelle taille souhaitez-vous pour le pull décontracté à col rond uni Nineteen pour femmes ? Nous proposons des tailles allant du XS au XL. | |
| medium | |
| Parfait. Le pull décontracté à col rond uni Nineteen pour femmes en taille M a été ajouté à votre panier (quantité : 1). Souhaitez-vous ajouter autre chose à votre panier ? | |
| no | |
| Nous pouvons vous livrer le pull décontracté à col rond uni Nineteen pour femmes au plus tôt le 29 avril 2024. Est-ce que cela vous convient ? | |
| can you deliver it on April 28? | |
| Je suis désolé, mais nous ne pouvons pas livrer le pull décontracté à col rond uni Nineteen pour femmes le 28 avril 2024. Nous pouvons le livrer au plus tôt le 29 avril 2024. | |
| ok keep the delivery date as it is | |
| D'accord, votre pull décontracté à col rond uni Nineteen pour femmes sera livré le 29 avril 2024. Passons maintenant en revue les informations de votre profil pour nous assurer qu'elles sont à jour : | |
| Adresse de livraison : 638 Maple Street, Apt 11, Cupertino, CA 95014 | |
| Informations de paiement : Visa se terminant par 4111 Numéro de téléphone : 416-555-5555 Adresse e-mail : email@example.com Veuillez vérifier ces informations. Si tout est correct, confirmez simplement. Si vous devez apporter des modifications, dites-le-moi. |
|
| my address has changed to 371 Talbot Street Carmichael, CA 95608 | |
| Votre adresse de livraison a bien été modifiée et est désormais 371 Talbot Street, Carmichael, CA 95608. Souhaitez-vous modifier autre chose ? | |
| no | |
| Votre commande du pull décontracté à col rond uni Nineteen pour femmes a bien été enregistrée sous le numéro ee6b4cc7. La livraison est prévue le 29 avril 2024. | |
| thanks | |
| Votre commande a bien été enregistrée. Y a-t-il autre chose que je puisse faire pour vous aider ? | |
| no thanks | |
| Je suis heureux d'avoir pu vous aider. Si vous avez besoin d'articles de Cymbal Apparel, je suis à portée de clic. |
Vérification de l'état d'une commande
L'utilisateur demande à vérifier l'état d'une commande. L'agent collecte le numéro de commande et récupère les informations de la commande. L'agent fournit des informations sur les articles de la commande, ainsi que sur son état actuel et sa date de livraison prévue.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Bonjour | |
| N'hésitez pas à sélectionner l'une des options ci-dessus ou à saisir ce que vous recherchez, et je vous aiderai. | |
| I want to check the status of my order | |
| Très bien, je peux vous aider. Pour commencer, pouvez-vous me fournir votre numéro de commande ? | |
| ee6b4cc7 | |
| Votre commande est confirmée. Elle est en cours de traitement. Voici ce que vous avez commandé : Pull décontracté à col rond uni Nineteen pour femmes Taille : M Quantité : 1 Livraison prévue : 29 avril 2024 Y a-t-il autre chose que je puisse faire pour vous aider ? |
|
| No thanks | |
| Je suis heureux d'avoir pu vous aider. Si vous avez besoin d'articles de Cymbal Apparel, je suis à portée de clic. |
Retour d'une commande
L'utilisateur souhaite retourner une commande. L'agent collecte le numéro de commande, récupère les détails de la commande et confirme l'article à retourner. L'agent lance ensuite le processus de retour et fournit une étiquette de retour que l'utilisateur doit imprimer et coller sur le colis.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Bonjour | |
| N'hésitez pas à sélectionner l'une des options ci-dessus ou à saisir ce que vous recherchez, et je vous aiderai. | |
| I want to return my order | |
| Je suis là pour vous aider à retourner votre commande. Pour commencer, pouvez-vous me communiquer votre numéro de commande ? | |
| 0fc77d64 | |
| Merci pour votre numéro de commande. J'ai trouvé votre commande passée le 12 avril 2024. Elle contient un t-shirt bleu foncé à col rond imprimé YK pour garçon en taille S. Est-ce l'article que vous souhaitez retourner ? | |
| yes | |
| D'accord, j'ai lancé le processus de retour. Vous trouverez l'étiquette de retour ci-dessous. Veuillez l'imprimer et la coller sur votre colis avant de le renvoyer. Y a-t-il autre chose que je puisse faire pour vous aider ? | |
| No thanks | |
| Je suis heureux d'avoir pu vous aider. Si vous avez besoin d'articles de Cymbal Apparel, je suis à portée de clic. |
Configuration de base
Pour configurer cet agent prédéfini :
- Importez l'agent prédéfini.
- Configurez les outils fournis avec vos services externes. Pour en savoir plus, consultez Configuration des outils.
Configuration des outils
Cet agent inclut des outils qui sont utilisés pour l'intégration à des services externes. Pour configurer ces outils, procédez comme suit :
- Créez une
base de données Firestore
nommée
apparel-db. - Créez un connecteur d'intégration Firestore.
- Téléchargez l'Application Integration pour l'assistant shopping.
- Remplacez toutes les références à
projects/customermod-genai-sa/locations/us-central1/connections/firestorepar l'identifiant du connecteur créé à l'étape 2. - Importez et publiez l'intégration.
- Attribuez les rôles
Cloud Functions Invokerà votre agent de service Dialogflow. - Suivez les étapes pour configurer votre catalogue Retail.
- Mettez à jour les commandes d'attributs pour rendre les champs suivants récupérables : ageGroups, availability, categories, colorFamilies, colors, conditions, cost, currencyCode, description, discount, images, materials, patterns, price, sizes, title, uri.
- Importez l' exemple de catalogue dans la branche 1 de votre catalogue et définissez-la comme branche par défaut.
- Téléchargez la fonction Cloud Run disponible
ici
et mettez à jour
config.toml. - Suivez les étapes pour déployer la fonction Cloud Run.
- Attribuez le rôle IAM
Retail Viewerà la fonction Cloud Run que vous avez déployée. - Pour les outils suivants :
get-order-status,order-lookup,place-orderetreturn-order, mettez à jour la propriétépathspour référencer l'intégration que vous avez créée à l'étape 5 dans les spécifications OpenAPI, puis choisissez l'authentification par compte de service avec un compte de service auquel vous attribuez le rôleApplication Integration Invoker. - Mettez à jour la propriété d'URL du serveur vers la fonction Cloud Run que vous avez déployée pour les outils restants.
Recherche de produits
L'outil search-products récupère les produits les plus pertinents en fonction de la requête de recherche et de la valeur de décalage du catalogue de produits.
L'outil renvoie une réponse de charge utile personnalisée qui inclut les détails du produit.
Cette charge utile personnalisée est utilisée par l'interface utilisateur pour afficher les produits sous forme de contenu enrichi.
Détails du produit
L'outil get-product-details récupère les détails du produit à partir du catalogue de produits à l'aide de l'API Retail.
Les détails du produit récupérés sont ensuite transformés et renvoyés dans un format simplifié, utilisé par l'agent pour répondre aux questions sur les produits qu'il a présentés à l'utilisateur.
Avis sur le produit
L'outil get-reviews est utilisé pour récupérer les avis sur les produits.
Il attend une liste de produits présentés et récupère les avis pour chaque produit.
Les avis générés sont transformés en un format de modèle personnalisé (review_template) adapté à l'affichage dans une interface utilisateur enrichie.
Produits similaires
L'outil similar-products facilite la découverte de produits similaires à un produit spécifié à l'aide de l'API Retail Recommendation.
Il accepte un ID de produit et utilise l'API Retail Recommendation pour prédire les produits similaires à partir du catalogue de produits.
Date de distribution
L'outil store-delivery-date est chargé de stocker la date de livraison préférée de l'utilisateur pour les articles du panier, qui doit être comparée à la date de livraison estimée la plus proche.
L'outil get-delivery-date est chargé d'estimer la date de livraison des articles du panier.
Détails concernant l'utilisateur
L'outil get-user-info récupère les informations personnelles de l'utilisateur, y compris l'adresse de livraison, les informations de paiement, le numéro de téléphone et l'adresse e-mail, tandis que l'outil update-user-info est chargé de mettre à jour les informations de l'utilisateur.
Gestion des commandes
L'outil place-order gère le processus de commande des articles du panier.
Il stocke la commande dans Firestore avec les données de commande, qui incluent l'ID de commande, l'état, l'horodatage de création et la liste des produits.
Il renvoie le numéro de commande à l'agent.
L'outil order-lookup récupère les données de commande à partir d'une base de données Firestore en fonction de l'ID de commande fourni.
L'outil return-order définit l'état d'une commande sur "return_pending" dans la base de données Firestore, indiquant que le retour a été initié par le client et que la commande est en attente de retour.
L'outil get-order-status est chargé de récupérer l'état d'une commande et, si la commande a été expédiée, de la suivre à l'aide de l'API DHL.
Il fournit des messages appropriés en fonction de l'état de la commande.
Terminé
Votre agent et ses intégrations doivent maintenant être configurés et prêts à être testés.