Agent prédéfini pour le commerce

L'agent prédéfini basé sur un playbook Retail permet aux utilisateurs de rechercher des articles, d'obtenir des recommandations de produits et de passer une commande.

Exemples de boîtes de dialogue

Les exemples de dialogues suivants illustrent des scénarios courants gérés par cet agent prédéfini.

Rechercher des produits et effectuer des achats

L'utilisateur demande des informations sur les montres disponibles dans le magasin. L'agent recommande des produits qui répondent à ce critère, et l'utilisateur les ajoute à son panier. L'utilisateur confirme qu'il souhaite passer une commande, et l'agent confirme la commande avec un numéro de confirmation. L'utilisateur demande ensuite des recommandations de téléphones. L'agent lui en suggère, en ajoute un à son panier et passe la commande.

Entrée utilisateur	Réponse de l'agent
salut
	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
	Bonne réponse ! J'ai ajouté deux montres Google à votre panier. Autre chose ?
Peux-tu ajouter un Google Pixel 8 à mon panier ?
	Bonne réponse ! J'ai ajouté un Google Pixel 8 à votre panier. Autre chose ?
qu'y a-t-il dans mon panier ?
	Vous avez ajouté un Google Pixel 8 et deux Google Watches à votre panier. Voulez-vous passer à la caisse ?
oui s'il te plaît
	OK, j'ai passé une commande contenant un Google Pixel 8 et deux Google Watches. Votre numéro de confirmation est QKA67DW2.
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
En fait, peux-tu aussi m'aider à trouver un nouveau téléphone ?
	Nous avons le Google Phone Pixel 8 et le Google Phone Pixel 7. Souhaitez-vous en acheter un ?
Oui, je veux un Pixel 8
	Bonne réponse ! J'ai ajouté un téléphone Google Pixel 8 à votre panier. Autre chose ?
non, on peut y aller
	Vous avez un Google Phone Pixel 8 dans votre panier. Souhaitez-vous passer à la caisse avec ce panier ?
oui
	OK, j'ai passé une commande pour vous. Votre commande contient un téléphone Google Pixel 8. Votre numéro de confirmation est 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 fait vos achats sur Google. Bonne journée.

Gestion du panier

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

Entrée utilisateur	Réponse de l'agent
Bonjour, je souhaite acheter un téléphone
	Nous avons le Google Phone Pixel 8 et le Google Phone Pixel 7. Lequel souhaitez-vous acheter ?
donne-moi deux des huit
	Bonne réponse ! J'ai ajouté deux Google Phone Pixel 8 à votre panier. Autre chose ?
En fait, pouvez-vous en supprimer un ?
	Bien sûr, j'ai supprimé un Google Phone 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 X0KP6K5T.
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
non, c'est tout
	OK, merci d'avoir fait vos achats sur Google. Bonne journée.

Produit introuvable

L'utilisateur pose des questions sur un produit qui n'est pas vendu dans le magasin.

Entrée utilisateur	Réponse de l'agent
salut
	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 acheter une voiture
	Désolé, nous n'avons aucun véhicule en stock. Y a-t-il autre chose que vous aimeriez trouver ?
Oui, qu'en est-il des 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 fait vos achats sur Google. Bonne journée.

Entrée non reconnue

L'utilisateur pose une question sur un sujet sans rapport avec les produits ou les commandes. L'agent répond en répétant les sujets qu'il couvre et en demandant à l'utilisateur ce dont il a besoin.

Entrée utilisateur	Réponse de l'agent
salut
	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 également vous aider à passer des commandes. Que puis-je faire pour vous ?

Configuration de base

Pour configurer cet agent prédéfini :

1. Importez l'agent prédéfini.
2. 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 permettent de s'intégrer à des services externes. Vous pouvez utiliser le programme d'installation d'outils prédéfini pour déployer des exemples de code et de données pour votre agent prédéfini.

Pour déployer et configurer des exemples de code et de données pour l'agent prédéfini Retail, développez les 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 et consignées par le programme d'installation :

   Console Vertex AI Agent Builder

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

      Console Vertex AI Agent 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 afin de 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 afin de remplacer l'URL du champ servers par le point de terminaison enregistré par le programme d'installation.
   8. Cliquez sur Enregistrer.
9. Attribuez le rôle Utilisateur Cloud Datastore au compte de service Compute Engine (your-project-number-developer.gserviceaccount.com) afin que les fonctions Cloud Run nouvellement déployées puissent accéder à Firestore.

Google Store API

L'outil Google Store API permet d'extraire des articles du Google Store en fonction d'un terme de recherche.

Gérer le panier

L'outil Manage Shopping Cart permet à l'utilisateur de gérer son panier en affichant tous les articles qu'il contient, en y ajoutant des articles et en en supprimant.

Commander

L'outil Place Order permet de passer une commande avec le panier actuel de l'utilisateur et renvoie un numéro de confirmation pour la commande passée.

Terminé

Votre agent et ses intégrations doivent maintenant être configurés et prêts à être testés.