Agent prédéfini pour le commerce

L'agent prédéfini basé sur un playbook pour le commerce vous permet de rechercher des articles, d'obtenir des recommandations de produits et de passer une commande.

Exemple de dialogue

Cet exemple de boîte de dialogue illustre des scénarios courants que cet agent prédéfini gère.

Rechercher des produits et acheter des articles

1. L'utilisateur pose des questions sur les montres disponibles dans le magasin.
2. L'agent recommande des produits qui répondent à ces critères.
3. L'utilisateur ajoute le produit à son panier.
4. L'utilisateur ajoute un autre produit à son panier.
5. L'utilisateur pose une question sur le contenu de son panier.
6. L'agent liste les articles du panier, et l'utilisateur confirme qu'il souhaite les acheter.
7. L'agent passe la commande et fournit un numéro de confirmation.
8. L'utilisateur demande une recommandation de téléphone.
9. L'agent recommande des téléphones disponibles en magasin.
10. L'utilisateur en ajoute un à son panier.
11. L'utilisateur passe une commande pour le téléphone et fournit un numéro de confirmation.

Entrée utilisateur	Réponse de l'agent
Bonjour
	Bonjour, je suis votre assistant Google Shopping. Je peux vous aider à rechercher des articles et à passer des commandes. Que puis-je faire pour vous ?
quelles montres as-tu
	Nous avons la Google Watch. Voulez-vous l'ajouter à votre panier ?
oui ajoute deux s'il te plaît
	Tout à fait ! J'ai ajouté deux Google Watch à votre panier. Autre chose ?
Peux-tu aussi ajouter un Google Pixel 8 à mon panier ?
	Tout à fait ! J'ai ajouté un Google Pixel 8 à votre panier. Autre chose ?
qu'y a-t-il dans mon panier ?
	Vous avez un Google Pixel 8 et deux Google Watch dans votre panier. Voulez-vous passer au paiement ?
oui s'il te plaît
	D'accord, j'ai passé une commande contenant un Google Pixel 8 et deux Google Watch. Votre numéro de confirmation est le QKA67DW2.
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
En fait, peux-tu m'aider à trouver un nouveau téléphone ?
	Nous avons le téléphone Google Pixel 8 et le téléphone Google Pixel 7. Souhaitez-vous en acheter un ?
oui, donne-moi un Pixel 8
	Tout à fait ! J'ai ajouté un téléphone Google Pixel 8 à votre panier. Autre chose ?
Non, nous pouvons passer au paiement
	Vous avez un téléphone Google Pixel 8 dans votre panier. Voulez-vous passer au paiement avec ce panier ?
oui
	D'accord, j'ai passé une commande pour vous. Votre commande contient un téléphone Google Pixel 8. Votre numéro de confirmation est le Y43KTF0T.
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
non, c'est tout pour moi, merci
	OK, merci d'avoir choisi Google Shopping ! Bonne journée.

Gestion des paniers

L'utilisateur demande à ajouter des articles à son panier, puis en supprime un avant de passer la commande.

Entrée utilisateur	Réponse de l'agent
Bonjour, je veux acheter un téléphone
	Nous avons le téléphone Google Pixel 8 et le téléphone Google Pixel 7. Lequel souhaitez-vous acheter ?
donne-moi deux des huit
	Tout à fait ! J'ai ajouté deux téléphones Google Pixel 8 à votre panier. Autre chose ?
En fait, pouvez-vous en supprimer un ?
	D'accord, j'ai supprimé un téléphone Google Pixel 8 de votre panier. Autre chose ?
Je suis prêt à passer ma commande
	D'accord, j'ai passé une commande contenant un téléphone Google Pixel 8. Votre numéro de confirmation est le X0KP6K5T.
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
non, c'est tout
	OK, merci d'avoir choisi Google Shopping ! Bonne journée.

Produit introuvable

L'utilisateur pose une question sur un produit que le magasin ne vend pas.

Entrée utilisateur	Réponse de l'agent
Bonjour
	Bonjour, je suis votre assistant Google Shopping. Je peux vous aider à rechercher des articles et à passer des commandes. Que puis-je faire pour vous ?
Je veux acheter une voiture
	Désolé, nous n'avons aucune voiture en stock. Y a-t-il autre chose que vous aimeriez rechercher ?
Et les montres ?
	Nous avons la Google Watch. Voulez-vous l'ajouter à votre panier ?
Non, merci
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
non
	OK, merci d'avoir choisi Google Shopping ! Bonne journée.

Entrée non reconnue

1. L'utilisateur pose une question sur un sujet sans rapport avec les produits ou les commandes.
2. L'agent répond en répétant les sujets qu'il couvre et demande à l'utilisateur ce pour quoi il a besoin d'aide.

Entrée utilisateur	Réponse de l'agent
Bonjour
	Bonjour, je suis votre assistant Google Shopping. Je peux vous aider à rechercher des articles et à passer des commandes. Que puis-je faire pour vous ?
Je souhaite réserver un hôtel
	Désolé, je ne peux pas vous aider à ce sujet. Je peux vous aider à rechercher des produits, y compris des téléphones, des montres et des casques. Je peux aussi vous aider à passer des commandes. Que puis-je faire pour vous ?

Configuration de base

Pour configurer cet agent prédéfini, procédez comme suit :

1. Importez l'agent prédéfini.
2. 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 pour s'intégrer à des services externes. Déployez un exemple de code et de données pour votre agent prédéfini à l'aide du programme d'installation de l'outil.

Pour déployer et configurer un exemple de code et de données pour l'agent prédéfini Retail, développez la section pour obtenir des instructions.

1. Téléchargez le programme d'installation de l'outil précompilé dans un répertoire local.
2. Accédez au répertoire local dans lequel vous avez téléchargé installer.zip.
3. Décompressez installer.zip et ouvrez le dossier installer.
4. Consultez le fichier README.md pour obtenir une présentation détaillée du programme d'installation et de ses exigences.
5. Exécutez pip install -r requirements.txt pour installer les exigences.
6. Exécutez gcloud auth application-default login pour vous authentifier à l'aide de gcloud auth.
7. Exécutez le programme d'installation à l'aide de python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail.
8. Après avoir déployé tous les services requis, configurez chaque outil de l'agent prédéfini avec les URL fournies enregistrées par le programme d'installation :

   Generative AI App Builder

   1. Si vous n'avez pas encore importé l'agent prédéfini, importez-le dans votre projet.
   2. Accédez à Generative AI App Builder.

      Generative AI App Builder

   3. Sélectionnez votre projet dans le menu déroulant de la console.
   4. Sélectionnez votre application.
   5. Cliquez sur l'icône Outils.
   6. Pour chaque outil de l'agent, modifiez le schéma pour remplacer l'URL du champ servers: par le point de terminaison enregistré par le programme d'installation.
   7. Cliquez sur Enregistrer.

   Dialogflow CX

   1. Si vous n'avez pas encore importé l'agent prédéfini, importez-le dans votre projet.
   2. Ouvrez la console Dialogflow CX.
   3. Choisissez votre projet Google Cloud.
   4. Sélectionnez votre agent.
   5. Cliquez sur l'icône Ressources génératives.
   6. Cliquez sur Outils.
   7. Pour chaque outil de l'agent, modifiez le schéma pour remplacer l'URL du champ servers par le point de terminaison enregistré par le programme d'installation.
   8. Cliquez sur Enregistrer.
9. Attribuez au compte de service Compute Engine (your-project-number-developer.gserviceaccount.com) le rôle Utilisateur Cloud Datastore afin que les fonctions Cloud Run nouvellement déployées puissent accéder à Firestore.

Outil d'API Google Store

L'outil de l'API Google Store récupère les articles du Google Store en fonction d'un terme de recherche.

Outil de gestion du panier d'achat

L'outil Gérer le panier permet à l'utilisateur de gérer son panier en affichant, en ajoutant et en supprimant des articles.

Outil Passer une commande

L'outil "Passer une commande" passe une commande pour le panier actuel de l'utilisateur et renvoie un numéro de confirmation.

Terminé

Votre agent est configuré et prêt à être testé.