Agent prédéfini pour le commerce

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

Exemples de dialogues

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

Rechercher des produits et acheter des articles

L'utilisateur demande quelles montres sont 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, et l'agent suggère des téléphones, en ajoute un au panier de l'utilisateur et passe une commande pour lui.

Entrée utilisateur	Réponse de l'agent
salut
	Bonjour, je suis votre assistant d'achat Google. Je peux vous aider à rechercher des articles et à passer des commandes. Que puis-je faire pour vous ?
quelles montres avez-vous
	Nous avons la Google Watch. Souhaitez-vous l'ajouter à votre panier ?
oui, ajoutez-en deux s'il vous plaît
	Bonne réponse ! J'ai ajouté deux Google Watch à votre panier. Autre chose ?
pouvez-vous également 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 ?
	Votre panier contient un Google Pixel 8 et deux Google Watch. Souhaitez-vous passer à la caisse ?
oui, s'il vous plaît
	D'accord, j'ai passé une commande contenant un Google Pixel 8 et deux Google Watch. Votre numéro de confirmation est QKA67DW2.
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
en fait, pouvez-vous 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, donnez-moi un Pixel 8
	Bonne réponse ! J'ai ajouté un Google Phone Pixel 8 à votre panier. Autre chose ?
non, nous pouvons passer à la caisse
	Votre panier contient un Google Phone Pixel 8. Souhaitez-vous passer à la caisse avec ce panier ?
oui
	D'accord, j'ai passé une commande pour vous. Votre commande contient un Google Phone 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
	D'accord, 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 une commande.

Entrée utilisateur	Réponse de l'agent
bonjour, je veux acheter un téléphone
	Nous avons le Google Phone Pixel 8 et le Google Phone Pixel 7. Lequel souhaitez-vous acheter ?
donnez-m'en deux du 8
	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 Google Phone 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
	D'accord, merci d'avoir fait vos achats sur Google ! Bonne journée.

Produit introuvable

L'utilisateur demande un produit qui n'est pas vendu par le magasin.

Entrée utilisateur	Réponse de l'agent
salut
	Bonjour, je suis votre assistant d'achat Google. 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 pas de voitures en stock. Y a-t-il autre chose que vous aimeriez trouver ?
oui, et les montres ?
	Nous avons la Google Watch. Souhaitez-vous l'ajouter à votre panier ?
non, merci
	Y a-t-il autre chose que je puisse faire pour vous aujourd'hui ?
non
	D'accord, 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 demande à l'utilisateur ce qu'il souhaite.

Entrée utilisateur	Réponse de l'agent
salut
	Bonjour, je suis votre assistant d'achat Google. Je peux vous aider à rechercher des articles et à passer des commandes. Que puis-je faire pour vous ?
je veux 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 écouteurs. 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 la section Configuration des outils.

Configuration des outils

Cet agent inclut des outils qui sont utilisés pour l'intégration à 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 cette section pour obtenir des instructions.

1. Téléchargez le programme d'installation d'outils prédéfini 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 :

   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 la liste déroulante 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 dans le servers: champ 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 dans le servers champ 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.

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.