L'agent prédéfini basé sur un playbook de l'assistant d'achat permet d'effectuer des requêtes sur les produits, de passer des commandes, de consulter l'état des commandes et d'annuler des commandes. Il utilise Agent Search for Retail et des charges utiles de fulfillment personnalisées pour offrir une expérience visuelle riche.
Exemple de dialogue
Cet exemple de boîte de dialogue illustre des scénarios courants que cet agent prédéfini gère.
Comparaison de produits et d'avis
- L'utilisateur demande à parcourir des saris traditionnels.
- L'agent présente des options populaires, et l'utilisateur sélectionne la première.
- L'utilisateur demande des chaussures assorties.
- L'agent présente quelques 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 |
|---|---|
| montre-moi des saris traditionnels | |
| [Présente des produits] Est-ce que l'un de ces produits vous intéresse, ou recherchez-vous d'autres options ? | |
| La première est correcte | |
| 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. Voulez-vous l'ajouter à votre panier ? | |
| Avez-vous des talons assortis ? | |
| [Présente des produits] Est-ce que l'un de ces produits vous intéresse, ou recherchez-vous d'autres options ? | |
| oui, mais pouvez-vous examiner les avis des clients et choisir le meilleur parmi ceux-ci ? | |
| Les chaussures à talons pour femme Flat n Heels ont une note moyenne de 4 étoiles sur 5, tandis que les chaussures à talons pour femme Glitzy Galz ont une note moyenne de 4,5 étoiles sur 5. Les avis des clientes ayant acheté les chaussures à talons Flat n Heels sont mitigés. Certaines les ont trouvées confortables au début, mais inconfortables après quelques heures, tandis que d'autres ont loué leur confort. En revanche, les talons pour femme Glitzy Galz ont reçu des avis majoritairement positifs, les clients saluant leur coupe, leur qualité et leur design. Lequel souhaitez-vous ajouter à votre panier ? | |
| celui qui a les meilleurs avis et notes | |
| Les talons Glitzy Galz pour femme ont la note la plus élevée, soit 4,5 étoiles sur 5. Quelle pointure souhaitez-vous pour les Glitzy Galz Women Heels ? Nous proposons des tailles allant du 35 au 41. | |
| 6 | |
| Parfait ! Les chaussures à talons Glitzy Galz pour femme en taille 36 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 passe la commande et fournit le numéro de commande à l'utilisateur.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Il commence à faire froid. Avez-vous de bons pulls ? | |
| [Présente des produits]. L'un de ces produits vous intéresse-t-il, ou recherchez-vous d'autres options ? | |
| J'aime bien le pull pour femme pour mon épouse, mais je cherche un pull pour garçon | |
| [Présente des produits]. L'un de ces produits vous intéresse-t-il, ou recherchez-vous d'autres options ? | |
| ajouter le premier pull pour femmes au panier | |
| Quelle taille souhaitez-vous pour le pull décontracté Nineteen à col rond pour femme ? Nous proposons des tailles allant du XS au XL. | |
| modérés | |
| Parfait ! Le pull décontracté Nineteen Solid à col rond pour femme, taille M, a été ajouté à votre panier (quantité : 1). Souhaitez-vous ajouter autre chose à votre panier ? | |
| non | |
| Nous pouvons vous livrer le pull décontracté Nineteen à col rond pour femme au plus tôt le 29 avril 2024. Est-ce que cela vous convient ? | |
| Pouvez-vous le livrer le 28 avril ? | |
| Nous sommes désolés, mais nous ne pourrons pas livrer le pull décontracté Nineteen uni à col rond pour femme le 28 avril 2024. La date de livraison la plus proche est le 29 avril 2024. | |
| ok, ne changez pas la date de livraison | |
| D'accord, votre pull décontracté Nineteen à col rond pour femme sera livré le 29 avril 2024. Maintenant, vérifions les détails de votre profil pour nous assurer que tout est à jour :\ | |
| Adresse de livraison : 638 Maple Street, Apt 11, Cupertino, CA 95014\ | |
| Infos 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. N'hésitez pas à m'indiquer les modifications que vous souhaitez apporter. |
|
| mon adresse a changé, c'est maintenant 371 Talbot Street Carmichael, CA 95608 | |
| Votre adresse de livraison a bien été remplacée par 371 Talbot Street, Carmichael, CA 95608. Souhaitez-vous modifier autre chose ? | |
| non | |
| Votre commande de pull décontracté Nineteen à col rond pour femme a bien été enregistrée sous l'ID de commande ee6b4cc7. La livraison est prévue pour 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 ? | |
| Non, merci | |
| Ravi d'avoir pu vous aider. Si vous avez besoin de quoi que ce soit de la part de Cymbal Apparel, je suis à votre disposition.\ |
Vérifier 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 détails sur les articles de la commande et leur 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. Je vous aiderai. | |
| Je souhaite vérifier l'état de ma commande | |
| Très bien, je peux vous aider. Pour commencer, pouvez-vous me fournir votre ID de commande ? | |
| ee6b4cc7 | |
| Votre commande est confirmée ! Elle est en cours de traitement. Voici ce que vous avez commandé : Pull décontracté Nineteen uni à col rond pour femme Taille : M Quantité : 1 Date de livraison estimée : 29 avril 2024 Puis-je vous aider pour autre chose ? |
|
| Non, merci | |
| Ravi d'avoir pu vous aider. Si vous avez besoin de quoi que ce soit de la part de Cymbal Apparel, je suis à votre disposition. |
Retourner 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 la procédure 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. Je vous aiderai. | |
| Je souhaite renvoyer ma commande | |
| Je suis là pour vous aider à effectuer votre retour. Pour commencer, pourriez-vous m'indiquer votre numéro de commande ? | |
| 0fc77d64 | |
| Merci de nous avoir fourni votre numéro de commande. J'ai trouvé votre commande passée le 12 avril 2024. La commande contient un t-shirt bleu foncé à col rond pour garçon avec imprimé YK, en taille S. Est-ce l'article que vous souhaitez retourner ? | |
| oui | |
| Très bien, j'ai lancé la procédure de retour. Vous trouverez l'étiquette de retour ci-jointe. Veuillez l'imprimer et le coller sur votre colis avant de le renvoyer. Y a-t-il autre chose que je puisse faire pour vous aider ? | |
| Non, merci | |
| Ravi d'avoir pu vous aider. Si vous avez besoin de quoi que ce soit de la part de Cymbal Apparel, je suis à votre disposition. |
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 Configurer l'outil.
Configuration de l'outil
Cet agent inclut des outils qui permettent de l'intégrer à 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'intégration Application Integration pour l'assistant d'achat.
- 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 le rôle
Cloud Functions Invokerà votre agent de service Dialogflow. - Suivez la procédure pour configurer votre catalogue Retail.
- Mettez à jour les commandes d'attributs pour que les champs suivants puissent être récupérés : 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 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 Authentification par compte de service avec un compte de service auquel vous accordez le rôleApplication Integration Invoker. - Remplacez la propriété d'URL du serveur par la fonction Cloud Run que vous avez déployée pour les autres outils.
Outil de 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 informations détaillées sur le produit. Cette charge utile personnalisée est utilisée par l'UI pour afficher les produits sous forme de contenu enrichi.
Outil Obtenir les informations détaillées sur le produit
L'outil get-product-details récupère les informations détaillées sur le produit dans le catalogue de produits à l'aide de l'API AI Commerce Search. Le système transforme ensuite les informations détaillées sur le produit récupérées et les renvoie dans un format simplifié, que l'agent utilise pour répondre aux questions sur les produits qu'il a présentés à l'utilisateur.
Outil "Obtenir des avis"
L'outil get-reviews récupère les avis sur les produits. Il attend une liste de produits affiché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.
Outil 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 produit et utilise l'API Retail Recommendation pour prédire des produits similaires à partir du catalogue de produits.
Outils de date de livraison
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 estime la date de livraison des articles du panier.
Outil Obtenir les informations 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. L'outil update-user-info met à jour les informations de l'utilisateur.
Outil Passer une commande
L'outil place-order passe une commande pour les articles du panier. Il stocke les données de la commande dans Firestore, y compris l'ID de la commande, l'état, l'horodatage de création et la liste des produits, puis renvoie le numéro de commande à l'agent.
Outil de recherche de commande
L'outil order-lookup extrait les données de commande d'une base de données Firestore à l'aide de l'ID de commande fourni et renvoie les informations de commande à l'agent.
Outil de retour de commande
L'outil return-order met à jour l'état d'une commande sur "return_pending" dans la base de données Firestore, ce qui indique qu'un retour a été initié et est en attente.
Outil "Obtenir l'état de la commande"
L'outil get-order-status récupère l'état d'une commande et, si elle est expédiée, la suit à 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 devraient maintenant être configurés et prêts à être testés.