Créer votre premier agent

Prérequis

Créer votre agent

Ce guide vous explique comment créer un agent à l'aide d'un exemple d'application. L'exemple permet d'explorer rapidement les fonctionnalités d'un agent et peut servir de point de départ pour le développement de votre agent. Si vous souhaitez modifier une application existante pour y inclure un agent, l'exemple offre un bon modèle pour la logique de votre application.

Dans ce guide de démarrage rapide, vous allez effectuer les opérations suivantes :

  • S'inscrire en tant que partenaire
  • Créer une marque et un agent
  • Vous pouvez également explorer les fonctionnalités dans une conversation avec le bot d'aide Business Messages.
  • Configurer votre agent pour envoyer et recevoir des messages

Pour créer un agent sans utiliser l'exemple, consultez Créer votre agent.

S'inscrire en tant que partenaire

  1. Ouvrez la console pour les développeurs Business Communications.
  2. Sous Business Messages, cliquez sur Créer un compte partenaire.

  3. Saisissez les informations sur votre partenaire :

    Champ Valeur
    Votre nom Votre nom complet
    Nom du partenaire Nom de votre entreprise
    Site Web du partenaire Site Web de votre entreprise
    Région Région dans laquelle vous souhaitez héberger le service Business Messages

  4. Lisez et acceptez les Conditions d'utilisation de Business Messages.

  5. Cliquez sur Créer.

Vous êtes désormais enregistré en tant que partenaire Business Messages. Un projet Google Cloud a été créé pour vous, avec les API Business Messages et Business Communications activées. Vous n'avez pas accès à ce projet, et il n'interférera avec aucun de vos projets Google Cloud existants.

Vous avez désormais accès aux API Business Messages et Business Communications.

Créer un compte de service

  1. Sur la page d'accueil de la console Business Communications Developer, cliquez sur Paramètres du compte partenaire.
  2. Dans le panneau de navigation de gauche, cliquez sur Compte de service.

  3. Cliquez sur Créer une clé, puis sur Créer.

    Votre navigateur télécharge la clé du compte de service. Conservez-le dans un endroit sûr. Vous aurez besoin de cette clé plus tard pour déployer une application Web et accéder aux API Business Messages et Business Communications.

Créer une marque et un agent

Un agent est une représentation conversationnelle d'une marque, c'est-à-dire l'entité conversationnelle avec laquelle les utilisateurs interagissent. Vous créez une marque pour représenter l'entreprise et un agent pour que les consommateurs puissent interagir avec elle.

  1. Ouvrez la console pour les développeurs Business Communications et connectez-vous avec votre compte Google Business Messages.
  2. Cliquez sur Create agent (Créer un agent).
  3. Pour Type d'agent, sélectionnez Messages d'entreprise.
  4. Saisissez des valeurs pour Nom de la marque et Nom de l'agent.
  5. Effectuez l'une des opérations suivantes :
    • Pour découvrir les fonctionnalités disponibles dans une conversation avec votre agent, sélectionnez Activer le bot d'aide Business Messages.
    • Pour personnaliser votre agent et le préparer à la gestion des messages, décochez Activer le bot d'aide Business Messages.
  6. Cliquez sur Create agent (Créer un agent).

Si vous avez activé le bot d'aide Business Messages, vous pouvez lancer une conversation immédiatement. Sinon, passez à la section Configurer votre agent pour la gestion des messages.

Explorer les fonctionnalités avec le bot d'aide Business Messages

Le bot d'aide Business Messages vous permet de lancer rapidement une conversation avec votre agent afin de découvrir ce que la plate-forme a à vous offrir. L'activation du bot d'assistance est facultative, mais vivement recommandée lorsque vous créez votre premier agent.

Le bot d'aide vous permet de :

  • Explorer les fonctionnalités enrichies
  • Découvrez comment implémenter des fonctionnalités
  • Trouver des ressources pour configurer les agents

Lorsque le bot d'aide est activé, il envoie et reçoit des messages pour votre agent. Aucun webhook n'est nécessaire. Vous devez désactiver le bot d'aide avant de pouvoir définir un webhook ou activer Dialogflow pour gérer les messages des utilisateurs.

Démarrer une conversation avec le bot d'assistance

Une fois que vous avez activé le bot d'aide Business Messages, vous pouvez lancer une conversation. Une boîte de dialogue s'ouvre immédiatement après la création de l'agent pour vous aider à démarrer.

Pour interagir avec le robot d'assistance, procédez comme suit à partir de cette boîte de dialogue :

  1. Accédez aux URL de test de l'agent. Pour ce faire, vous avez le choix entre plusieurs méthodes :

    • Cliquez sur le bouton Android ou iOS. Scannez ensuite le code QR avec l'appareil mobile correspondant, puis cliquez sur Lancer. Vous pouvez également cliquer sur Copier l'URL Android ou Copier l'URL iOS pour copier l'URL de test de l'agent.
    • Cliquez sur Envoyer pour envoyer les URL à votre adresse e-mail.

  2. Ouvrez l'URL sur votre appareil mobile. (Les appareils iOS nécessitent l'application Google Maps.)

Désactiver le bot d'aide

Avant de pouvoir personnaliser votre agent et le préparer au lancement, vous devez désactiver le bot d'aide Business Messages.

Pour désactiver le bot d'aide,

  1. Ouvrez la console Business Communications Developer.
  2. Sélectionnez votre agent.
  3. Dans le panneau de navigation de gauche, cliquez sur Intégrations.
  4. Pour le Bot d'aide, cliquez sur Désactiver.

Lorsque le bot d'aide est désactivé, il n'envoie ni ne reçoit plus de messages pour votre agent. Vous pouvez maintenant configurer votre agent pour qu'il gère le flux de messages.

Configurer votre agent pour la gestion des messages

Dans ce guide, vous allez déployer un robot Echo sur Google Cloud Platform (GCP) avec un webhook conçu pour traiter les messages des utilisateurs.

Le bot Echo est un exemple d'application qui renvoie les messages à l'utilisateur. Il vous permet de tester des fonctionnalités enrichies, telles que les actions suggérées et les cartes enrichies, dans une conversation avec votre agent. Vous pouvez également utiliser le bot Echo comme point de départ pour développer votre agent.

Voici les étapes à suivre :

  • Déployer l'exemple de robot Echo sur GCP
  • Configurer l'URL de webhook pour votre compte partenaire Business Messages
  • Fournissez des informations de base sur votre agent

À la fin de ce guide, votre agent sera prêt à envoyer et à recevoir des messages.

Déployer l'application Web sur GCP

Business Messages transfère les messages des utilisateurs vers un webhook dans votre infrastructure. Dans ce guide, vous allez déployer l'exemple de code source Echo Bot sur un webhook préconfiguré. Si vous disposez déjà d'une infrastructure Web que vous pouvez utiliser pour recevoir des messages, vous pouvez créer un webhook sur ce service Web, mais vous devrez configurer la logique vous-même. Pour en savoir plus, consultez Définir votre webhook au niveau du partenaire.

Créer un environnement Cloud

Vous avez besoin d'un environnement cloud pour déployer l'exemple Echo Bot.

Pour créer un projet GCP en tant qu'environnement cloud, procédez comme suit :

  1. Ouvrez le sélecteur de projet de la console Google Cloud.

    Si vous n'avez jamais créé de projet Google Cloud, vous devez accepter les conditions d'utilisation.

  2. Cliquez sur Créer un projet.

  3. Saisissez un nom et un emplacement pour votre nouveau projet.

    • Votre ID de projet est généré automatiquement et s'affiche sous le nom de votre projet.
    • Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Si vous ne trouvez pas votre organisation Google Workspace, cela signifie que vous n'êtes pas connecté à un compte Google Workspace. Vous pouvez créer un projet sans organisation, mais certaines fonctionnalités sont limitées. Pour en savoir plus, consultez Avantages de la ressource Organisation.

  4. Cliquez sur Créer.

  5. Cliquez sur Menu.

  6. Cliquez sur Facturation.

  7. Cliquez sur Associer un compte de facturation.

  8. Créez un compte de facturation ou ajoutez-en un existant au projet. Consultez Fonctionnalités du programme sans frais Google Cloud pour en savoir plus sur les options de paiement.

Déployer l'exemple de robot Echo

  1. Installer gcloud CLI Vous l'utiliserez pour déployer l'exemple de code sur Google Cloud.

  2. Téléchargez et extrayez l'exemple Echo Bot (Node.js, Java, Python).

  3. Copiez le fichier d'identifiants JSON que vous avez téléchargé dans Créer un compte de service dans le dossier des ressources de l'exemple et renommez les identifiants "bm-agent-service-account-credentials.json". Le chemin d'accès à ce fichier d'identifiants dépend de l'exemple que vous avez téléchargé.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. Dans un terminal, accédez au répertoire full_sample de l'exemple.

  5. Exécutez les commandes suivantes dans un terminal pour déployer l'exemple :

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID correspond à l'ID du projet que vous avez créé dans Créer un environnement Cloud. L'ID du projet est indiqué sur le tableau de bord du projet dans Google Cloud.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID correspond à l'ID du projet que vous avez créé dans Créer un environnement Cloud. L'ID du projet est indiqué sur le tableau de bord du projet dans Google Cloud.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID correspond à l'ID du projet que vous avez créé dans Créer un environnement Cloud. L'ID du projet est indiqué sur le tableau de bord du projet dans Google Cloud.

  6. Notez l'URL de l'application déployée dans le résultat de la dernière commande. Il s'agit de la base de l'URL de votre webhook :

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Définir votre webhook

Maintenant que le bot Echo est déployé, vous devez spécifier une URL de webhook (que vous gérez) pour commencer à recevoir des messages.

  1. Ouvrez les paramètres du compte dans la console pour les développeurs Business Communications.
  2. Assurez-vous que le bon compte de partenaire est sélectionné.
  3. Pour l'URL du webhook Business Messages, cliquez sur Configurer.

  4. Dans le champ URL du point de terminaison du webhook, saisissez l'URL de votre application suivie de "/callback".

    Votre point de terminaison sera au format suivant : "https://PROJECT_ID.appspot.com/callback".

    Ce point de terminaison est prédéfini dans la logique d'application de l'exemple que vous avez déployé sur GCP.

  5. Dans la console pour les développeurs, cliquez sur Valider.

    Lorsque les messages professionnels valident votre webhook, la boîte de dialogue se ferme.

Pour configurer votre webhook avec l'API Business Communications, consultez Exemple : Mettre à jour l'URL du webhook.

Vous pouvez utiliser le framework de test Business Messages pour vérifier si votre webhook répond correctement aux charges utiles Business Messages.

Saisir les informations sur l'agent

Fournissez quelques informations de base pour terminer la configuration de votre agent.

  1. Ouvrez la console Business Communications Developer.
  2. Dans le panneau de navigation de gauche, cliquez sur Informations sur l'agent.

  3. Mettez à jour les valeurs comme vous le souhaitez ou utilisez les suggestions suivantes :

    Champ Valeur
    Message de bienvenue Bienvenue dans la conversation avec le robot Echo !
    Règles de confidentialité https://policies.google.com/privacy

  4. Cliquez sur Enregistrer.

Commencer la conversation

Pour interagir avec le robot Echo, procédez comme suit :

  1. Ouvrez la console Business Communications Developer.
  2. Dans le panneau de navigation de gauche, cliquez sur Informations sur l'agent.
  3. Sous URL de test de l'agent, cliquez sur le bouton Android ou iOS.

  4. Scannez le QR code avec l'appareil mobile correspondant, ou cliquez sur Copier l'URL Android ou Copier l'URL iOS pour copier l'URL de test de l'agent.

    Vous pouvez également cliquer sur Envoyer pour envoyer les URL à votre adresse e-mail.

  5. Ouvrez l'URL sur votre appareil mobile. (Les appareils iOS nécessitent l'application Google Maps.)

Le message de bienvenue de votre agent s'affiche. À ce stade, vous pouvez interagir avec le robot Echo. Il renvoie les messages que vous lui envoyez. Vous pouvez également appeler des fonctionnalités enrichies en envoyant des chaînes spécifiques : "carrousel", "carte", "chips".

Étapes suivantes

Maintenant que vous avez créé votre premier agent, découvrez Business Messages et les autres possibilités offertes par la plate-forme.