Créer des actions pour l'Assistant Google avec Actions Builder (niveau 1)

1. Présentation

Avertissement: Les actions conversationnelles seront abandonnées le 13 juin 2023. Pour en savoir plus, consultez l'article Abandon des actions conversationnelles.

La plate-forme pour les développeurs dédiée à l'Assistant Google vous permet de créer des logiciels visant à étendre les fonctionnalités de cet assistant personnel virtuel sur plus d'un milliard d'appareils (enceintes intelligentes, téléphones, voitures, téléviseurs, casques audio, etc.). Cet assistant simplifie la vie des utilisateurs qui lui demandent d'accomplir des tâches (par exemple, faire des courses, réserver un chauffeur, etc.). En tant que développeur, vous pouvez utiliser cette plate-forme pour créer et gérer facilement des échanges agréables et efficaces entre les utilisateurs et votre propre service de traitement tiers.

Cet atelier de programmation aborde à un niveau débutant les concepts du développement avec l'Assistant Google. Aucune expérience préalable avec la plate-forme n'est nécessaire. Vous allez créer ici une action simple pour l'Assistant Google, qui prédit l'avenir d'un utilisateur dans sa quête sur les terres légendaires de Gryffinberg. Dans l'atelier de programmation de niveau 2 avec Actions Builder, vous développerez cette action plus en détail pour personnaliser l'avenir de l'utilisateur en fonction de ce qu'il aura entré.

Objectifs de l'atelier

Vous allez créer une action simple qui intègre les fonctions suivantes :

• Répondre à l'utilisateur par un message de bienvenue
• Elles contiennent une question. Lorsqu'ils répondent, votre action répond de manière appropriée à la sélection de l'utilisateur.
• Lui proposer des chips de suggestion cliquables pour l'aider dans ses choix
• Adapter le message de bienvenue selon que l'utilisateur soit nouveau ou connu

Une fois votre action finalisée, la conversation se présentera comme suit :

Ce que vous allez apprendre

• Créer un projet dans la console Actions
• Envoyer une invite à l'utilisateur lorsqu'il appelle votre action
• Traiter l'entrée utilisateur et y répondre
• Tester votre action dans le simulateur de la console Actions
• Appliquer le traitement via l'éditeur Cloud Functions

Ce dont vous avez besoin

Votre environnement doit inclure l'outil suivant :

• Un navigateur Web tel que Google Chrome

2. Configurer

Les sections suivantes expliquent comment configurer un environnement de développement et créer un projet Actions.

Vérifier vos paramètres d'autorisation Google

Pour tester l'action que vous allez créer dans cet atelier de programmation, vous devez accorder les autorisations nécessaires pour que le simulateur puisse y accéder. Pour cela, procédez comme suit :

1. Accédez à la page Commandes relatives à l'activité.
2. Si vous ne l'avez pas déjà fait, connectez-vous à votre compte Google.
3. Activez les autorisations suivantes :

• Activité sur le Web et les applications
• Sous Activité sur le Web et les applications, cochez la case Inclure l'historique Chrome et l'activité liée aux sites, aux applications et aux appareils qui utilisent les services Google.

Créer un projet Actions

Votre projet Actions est un conteneur associé à votre action. Pour le créer :

1. Ouvrez la Console Actions.
2. Cliquez sur Nouveau projet.
3. Saisissez un nom de projet, par exemple actions-codelab. Ce nom interne est utilisé à titre de référence. Par la suite, vous pourrez définir un nom externe pour votre projet.)

4. Cliquez sur Create Project (Créer un projet).
5. Sur la page What kind of Action do you want to build? (Quel type d'action voulez-vous créer ?), sélectionnez la fiche Custom (Personnalisée).
6. Cliquez sur Suivant.
7. Sélectionnez la fiche Blank project (Projet vide).
8. Cliquez sur Start building (Commencer).

Associer un compte de facturation

Vous devez associer un compte de facturation à votre projet dans Google Cloud (il vous sera utile plus tard dans cet atelier pour déployer votre traitement via Cloud Functions).

Si vous n'avez pas encore associé de compte de facturation à votre projet, procédez comme suit:

1. Accédez à la page de facturation de Google Cloud Platform.
2. Cliquez sur Ajouter un compte de facturation ou Créer un compte.
3. Saisissez vos informations de paiement.
4. Cliquez sur Démarrer l'essai offert ou Envoyer et activer la facturation.
5. Accédez à la page de facturation de Google Cloud Platform.
6. Cliquez sur l'onglet Mes projets.
7. Cliquez sur les trois points sous Actions à côté du projet Actions de l'atelier de programmation.
8. Cliquez sur Modifier la facturation.
9. Dans le menu déroulant, sélectionnez le compte de facturation que vous avez configuré. Cliquez sur Définir le compte.

Pour éviter que des frais ne vous soient facturés, suivez la procédure de la section Nettoyer votre projet à la fin de cet atelier de programmation.

3. Démarrer une conversation

L'utilisateur appelle votre action pour démarrer une conversation. Par exemple, si votre action s'intitule SéanceCiné, il peut l'appeler en disant Hey Google, je veux parler à SéanceCiné (SéanceCiné étant le nom à afficher). Ce nom est obligatoire si vous voulez déployer votre action en production. En revanche, il est facultatif pour la tester. À la place, vous pouvez utiliser l'expression Parler à mon application test dans le simulateur pour appeler votre action.

Vous devez modifier l'appel principal pour définir ce qui se passe après qu'un utilisateur a appelé votre action.

Termes clés :

• Appel principal : point d'entrée via lequel l'utilisateur démarre une conversation avec votre action. Par exemple, si l'utilisateur dit Hey Google, je veux parler à <nom à afficher>, l'appel principal est lancé et l'utilisateur reçoit une réponse.

Par défaut, Actions Builder fournit une invite générique au lancement de l'appel (Commencer à créer votre action en définissant l'appel principal).

Termes clés :

• Invite : elle désigne la réponse que votre action envoie à l'utilisateur. Il peut s'agir d'une simple réponse textuelle ou vocale, ou d'un message enrichi, comme une fiche et une image.

Pour transmettre à l'utilisateur des images en plein écran, vous pouvez utiliser une invite spéciale (Canvas). Pour en savoir plus sur ce Canvas, consultez Interactive Canvas.

Dans la section suivante, vous allez personnaliser l'invite associée à l'appel principal dans la console Actions.

Configurer l'appel principal

Pour modifier l'invite que votre action renvoie à l'utilisateur quand il appelle votre action :

1. Dans la barre de navigation, cliquez sur Main invocation (Appel principal).

2. Dans l'éditeur de code, remplacez le texte du champ speech (Start building your action...) par le message de bienvenue suivant : A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey.

Vous pouvez modifier vos invites au format YAML ou JSON.

3. Cliquez sur Enregistrer.

Tester l'appel principal dans le simulateur

La console Actions propose un outil Web appelé simulateur pour tester votre action. L'interface reproduit les appareils et leurs paramètres. Vous pouvez ainsi échanger avec votre action comme si elle était exécutée sur un écran connecté, un téléphone, une enceinte ou KaiOS.

Pour savoir comment utiliser le simulateur de la console Actions, consultez la page Simulateur. Consultez-le en cas de difficultés aux prochaines étapes.

Lorsque vous appelez votre action, elle doit maintenant renvoyer l'invite personnalisée que vous avez ajoutée ("A wondrous greeting, adventurer!...").

Pour tester l'appel principal de votre action dans le simulateur :

1. Dans la barre de navigation en haut de l'écran, cliquez sur Test (Tester) pour accéder au simulateur.
2. Pour appeler votre action dans le simulateur, saisissez Talk to my test app dans le champ Input (Entrée), puis appuyez sur Enter.

Vous pouvez également cliquer sur le chip de suggestion, Parler à mon application test, ou cliquer sur l'icône représentant un micro, puis dire "Talk to my test app" pour appeler votre action.

Lorsque vous lancez l'appel principal de votre action, l'Assistant répond par votre message de bienvenue personnalisé. À ce stade, la conversation se termine une fois que l'Assistant a communiqué ce message. Dans la section suivante, vous allez modifier votre action pour que la conversation se poursuive.

Afficher les journaux des événements

Dans l'onglet Test (Tester), le panneau de droite contient les journaux des événements dans lesquels figure l'historique des conversations. Chacun de ces journaux répertorie les événements survenus lors de la conversation.

Un seul journal des événements a été créé pour votre action. Il comporte à la fois l'entrée utilisateur ("Talk to my test app") et la réponse de votre action. Vous trouverez ci-dessous une capture d'écran de ce journal :

Si vous cliquez sur la flèche vers le bas dans le journal des événements, vous découvrirez, par ordre chronologique, les événements survenus lors de la conversation :

• userInput : correspond à l'entrée utilisateur ("Talk to my test app").
• interactionMatch : correspond à la réponse à l'appel principal de votre action (lancé par l'entrée utilisateur). Si vous développez cette ligne en cliquant sur la flèche, vous verrez l'invite que vous avez ajoutée pour l'appel principal (A wondrous greeting, adventurer!...).
• endConversation : correspond à la transition sélectionnée dans l'intent Main invocation, qui met actuellement fin à la conversation. (Vous en saurez davantage sur les transitions dans la section suivante de cet atelier de programmation.)

Les journaux des événements permettent d'en savoir plus sur le déroulement de votre action et sont utiles pour trouver une solution en cas de bug. Pour afficher les détails d'un événement, cliquez sur la flèche à côté de son nom (voir la capture d'écran ci-dessous) :

4. Créer la conversation avec votre action

Maintenant que vous avez défini ce qui se passe quand un utilisateur appelle votre action, vous pouvez développer le reste de la conversation. Avant de poursuivre cet atelier de programmation, familiarisez-vous avec les termes suivants pour comprendre le principe d'une conversation avec votre action :

Termes clés :

• Scène : élément constitutif de votre action, qui traite l'entrée utilisateur et génère habituellement la réponse donnée à l'utilisateur. Des intents utilisateur activent souvent d'autres scènes, mais celles-ci peuvent aussi être déclenchées autrement.
• Intent utilisateur : entrée utilisateur que votre action est capable de comprendre. Vous allez définir des expressions d'entraînement pour ces intents. Lorsqu'un utilisateur dit quelque chose qui correspond ou ressemble à une expression d'entraînement, l'intent correspondant est ciblé.
• Expression d'entraînement : exemple de ce que peut dire un utilisateur pour cibler un intent. Le moteur de compréhension du langage naturel (NLU, Natural Language Understanding) de l'Assistant développe naturellement ce type d'expressions pour en inclure d'autres similaires.
• Transition : définit la scène vers laquelle effectuer la transition une fois la condition remplie.

Votre action peut comporter une ou plusieurs scènes, et vous devez activer chaque scène avant qu'elle puisse être exécutée. (L'action que vous créez dans cet atelier de programmation ne comporte qu'une seule scène intitulée Start.) La méthode la plus courante pour activer une scène consiste à configurer votre action de sorte que, quand une correspondance est établie entre un utilisateur et un intent utilisateur dans une scène, cet intent déclenche la transition vers une autre scène et l'active.

Par exemple, imaginez une action qui fournit à l'utilisateur des informations sur les animaux. Lorsque l'utilisateur appelle cette action, l'intent Main invocation est ciblé et déclenche la transition vers une scène nommée Facts. Cette transition active la scène Facts, qui envoie l'invite suivante à l'utilisateur : Would you like to hear a fact about cats or dogs? Dans la scène Facts, il s'agit d'un intent utilisateur appelé Cat, qui contient des expressions d'entraînement que l'utilisateur pourrait dire pour écouter un fait de chat, comme "I want to listening a cat fait." ou "cat". Lorsque l'utilisateur demande qu'on lui donne ce type d'informations, l'intent Cat est ciblé et déclenche une transition vers une scène intitulée Cat fact. La scène Cat fact est activée, et une invite comportant des informations sur les chats est envoyée à l'utilisateur.

Figure 1 : Flux de conversation type dans une action créée avec Actions Builder

Ensemble, les scènes, intents et transitions constituent la logique de votre conversation. Ils définissent les différents chemins que l'utilisateur peut emprunter au fil de la conversation avec votre action. Dans la section suivante, vous allez créer une scène et définir comment elle est activée après qu'un utilisateur a appelé votre action.

Ajouter une transition entre l'appel principal et une scène

Dans cette section, vous allez créer une scène intitulée Start, qui envoie une invite à l'utilisateur pour lui demander s'il veut qu'on lui prédise son avenir. Vous allez également ajouter une transition entre l'appel principal et cette nouvelle scène Start.

Pour créer cette scène et y ajouter une transition :

1. Dans la barre de navigation, cliquez sur Develop (Développer).
2. Dans la barre de navigation latérale, cliquez sur Main invocation (Appel principal).
3. Dans la section Transition, cliquez sur le menu déroulant et saisissez Start dans le champ de texte.

4. Cliquez sur Ajouter. Vous créez ainsi une scène intitulée Start, qui indique à l'action de passer à la scène Start après que cette action a envoyé l'invite de bienvenue à l'utilisateur.
5. Dans la barre de navigation latérale, cliquez sur Scenes (Scènes) pour afficher la liste des scènes.
6. Sous Scenes (Scènes), cliquez sur Start (Démarrer) pour afficher la scène Start.
7. Dans la section On enter (Lors de l'entrée) de la scène Start, cliquez sur +.
8. Cochez la case Send prompts (Envoyer des invites).
9. Remplacez la phrase du champ speech (Enter the response that users will see or hear...) par une question à poser à l'utilisateur : Before you continue on your quest, would you like your fortune told?

10. Cliquez sur Save (Enregistrer).

L'Assistant Google montre cette invite (Before you continue on your quest...) à l'utilisateur qui accède à la scène Start.

Ajouter des chips de suggestion

Les chips de suggestion proposent à l'utilisateur des suggestions cliquables que votre action traite comme des entrées utilisateur. Dans cette section, vous allez ajouter des chips de suggestion pour aider les utilisateurs sur les appareils dotés d'un écran.

Pour ajouter des chips de suggestion à l'invite de la scène Start :

1. Dans la scène Start, cliquez sur suggestions. Un seul chip de suggestion est alors ajouté.
2. Dans le champ title, remplacez Suggested Response par 'Yes'.
3. En utilisant la même mise en forme, ajoutez manuellement un chip de suggestion intitulé 'No'. Le code doit ressembler à l'extrait suivant :

    suggestions:
      - title: 'Yes'
      - title: 'No'

4. Cliquez sur Enregistrer.

Tester votre action dans le simulateur

À ce stade, votre action devrait passer de l'appel principal à la scène Start, puis demander à l'utilisateur s'il veut qu'on lui prédise son avenir. Les chips de suggestion devraient également apparaître sur l'écran de simulation.

Pour tester votre action dans le simulateur, procédez comme suit :

1. Dans la barre de navigation, cliquez sur Test (Tester) pour accéder au simulateur.
2. Pour tester votre action dans le simulateur, saisissez Talk to my test app dans le champ Input (Entrée), puis appuyez sur Enter. Votre action doit répondre par l'invite Main invocation et l'invite de scène Start ajoutée, "Before you continue on your quest, would you like your fortune told?".

La capture d'écran suivante illustre cette interaction :

Les journaux d'événements enregistrent chacune des interactions avec le simulateur dans la session en cours. Ainsi, le journal des événements associés au test que vous avez réalisé tout à l'heure dans cet atelier de programmation est affiché en premier. Pour effacer les journaux d'événements, cliquez sur Reset Test (Réinitialiser le test).

3. Cliquez sur le chip de suggestion Yes ou No pour répondre à l'invite. Vous pouvez également dire Yes ou No, ou saisir Yes ou No dans le champ Input (Entrée).

Lorsque vous répondez à l'invite, votre action renvoie un message indiquant qu'elle ne comprend pas votre entrée : "Désolé, je n'ai pas compris. Pouvez-vous réessayer ? Comme vous n'avez pas encore configuré votre action pour qu'elle comprenne et réponde à l'entrée Yes ou No, elle établit une correspondance entre votre entrée et un intent NO_MATCH.

Termes clés :

• NO_MATCH : intent générique ciblé lorsque l'utilisateur dit quelque chose qui ne peut pas être associé à un autre intent dans votre action.
• Intent système : intent configuré par défaut qui gère les événements système courants (par exemple, en l'absence d'entrée utilisateur). NO_MATCH et l'intent associé à l'appel principal sont des exemples d'intents système.

Par défaut, l'intent système NO_MATCH fournit des réponses génériques. Toutefois, vous pouvez personnaliser ces réponses pour indiquer à l'utilisateur que vous n'avez pas compris son entrée. L'Assistant met fin à la conversation de l'utilisateur avec votre action quand, au bout de trois fois, il ne parvient pas à cibler l'entrée utilisateur.

Ajouter des intents yes et no

Maintenant que l'utilisateur peut répondre à la question que pose votre action, vous pouvez configurer votre action pour qu'elle comprenne les réponses de l'utilisateur (Yes ou No). Dans les sections suivantes, vous allez créer des intents utilisateur qui sont ciblés lorsque l'utilisateur dit "Yes" ou "No", puis les ajouter à la scène Start.

Créer l'intent yes

Pour créer l'intent yes :

1. Dans la barre de navigation, cliquez sur Develop (Développer).
2. Dans la barre de navigation, cliquez sur Intents personnalisés pour afficher la liste des intents.
3. Cliquez sur + (signe plus) à la fin de la liste des intents.
4. Nommez le nouvel intent yes et appuyez sur Enter.
5. Cliquez sur l'intent yes pour afficher la page de l'intent yes.
6. Dans la section Add training phrases (Ajouter des expressions d'entraînement), cliquez sur la zone de texte Enter Phrase (Saisissez une expression), puis saisissez les expressions suivantes :

• Yes
• Y
• I would
• Tell me

7. Cliquez sur Enregistrer.

Ajouter l'intent yes à la scène Start

Votre action peut maintenant comprendre quand un utilisateur formule l'intent Yes. Vous pouvez ajouter l'intent utilisateur yes à la scène Start, car l'utilisateur répond à l'invite Start ("Avant de poursuivre votre quête, voulez-vous qu'on vous prédise votre avenir ?.

Pour ajouter cet intent utilisateur à la scène Start, procédez comme suit :

1. Dans la barre de navigation, cliquez sur la scène Start (Démarrer).
2. Cliquez sur + (signe plus) dans la scène Start à côté de User intent handling (Gestion des intents utilisateur).
3. Sélectionnez yes (oui) dans le menu déroulant de l'intent.

4. Cliquez sur Send prompts (Envoyer des invites) et remplacez le contenu du champ speech par le texte suivant : Your future depends on the aid you choose to use for your quest. Choose wisely! Farewell, stranger.

Le code dans l'éditeur doit ressembler à l'extrait ci-dessous :

candidates:
  - first_simple:
      variants:
        - speech: >-
            Your future depends on the aid you choose to use for your quest. Choose
            wisely! Farewell, stranger.

5. Dans la section Transition, cliquez sur le menu déroulant et sélectionnez End conversation (Terminer la conversation).
6. Cliquez sur Enregistrer.

Tester l'intent yes dans le simulateur

À ce stade, votre action comprend quand l'utilisateur veut qu'on lui prédise son avenir et renvoie la réponse appropriée.

Pour tester cet intent dans le simulateur, procédez comme suit :

1. Dans la barre de navigation, cliquez sur Test (Tester).
2. Pour tester votre action dans le simulateur, saisissez Talk to my test app dans le champ Input (Entrée), puis appuyez sur Enter.
3. Saisissez Yes dans le champ Input (Entrée), puis appuyez sur Enter. Vous pouvez également cliquer sur le chip de suggestion Yes (Oui).

Votre action répond à l'utilisateur et lui indique que son avenir dépend de l'aide qu'il choisit. Elle met ensuite fin à la session, car vous avez sélectionné la transition End conversation pour l'intent yes.

Créer l'intent no

Vous devez maintenant créer l'intent no pour comprendre l'entrée utilisateur et y répondre si l'utilisateur ne veut pas qu'on lui prédise son avenir. Pour créer cet intent :

1. Dans la barre de navigation, cliquez sur Develop (Développer).
2. Dans la barre de navigation, cliquez sur Intents personnalisés pour afficher la liste des intents.
3. Cliquez sur + (signe plus) à la fin de la liste des intents.
4. Nommez le nouvel intent no et appuyez sur Enter.
5. Cliquez sur no (non) pour ouvrir la page **no**intent.
6. Dans la section Add training phrases (Ajouter des expressions d'entraînement), cliquez sur la zone de texte Enter Phrase (Saisissez une expression), puis saisissez les expressions suivantes :

• No
• N
• I don't want
• nope

7. Cliquez sur Enregistrer.

Ajouter l'intent no à la scène Start

Votre action est maintenant capable de comprendre quand un utilisateur dit non ou emploie une autre expression similaire, comme nan. Vous devez ajouter l'intent utilisateur no à la scène Start, car l'utilisateur répond à l'invite Start (Avant de poursuivre votre quête, voulez-vous qu'on vous prédise votre avenir ?).

Pour ajouter cet intent à la scène Start :

1. Dans la barre de navigation, cliquez sur la scène Start (Démarrer).
2. Cliquez sur + (signe plus) dans la scène Start à côté de User intent handling (Gestion des intents utilisateur).
3. Dans la section Intent, sélectionnez no (non) dans le menu déroulant.

4. Cliquez sur Send prompts (Envoyer des invites).
5. Mettez à jour le champ speech avec le texte suivant : I understand, stranger. Best of luck on your quest! Farewell.

Le code dans l'éditeur doit ressembler à l'extrait ci-dessous :

 candidates:
  - first_simple:
      variants:
        - speech: >-
             I understand, stranger. Best of luck on your quest! Farewell.

6. Dans la section Transition, sélectionnez End conversation (Terminer la conversation) dans le menu déroulant.
7. Cliquez sur Enregistrer.

Tester l'intent no dans le simulateur

À ce stade, votre action comprend quand l'utilisateur ne veut pas qu'on lui prédise son avenir et renvoie la réponse appropriée.

Pour tester cet intent dans le simulateur, procédez comme suit :

1. Dans la barre de navigation, cliquez sur Test (Tester).
2. Saisissez Talk to my test app dans le champ Input (Entrée), puis appuyez sur Enter.
3. Saisissez No dans le champ Input (Entrée), puis appuyez sur Enter. Vous pouvez également cliquer sur le chip de suggestion No (Non).

Au lieu de prédire l'avenir de l'utilisateur, votre action lui souhaite bonne chance dans sa quête. Elle met ensuite fin à la session, car vous avez sélectionné la transition End conversation pour l'intent no.

5. Appliquer le traitement

Actuellement, les réponses de votre action sont fixes. Lorsqu'une scène contenant une invite est activée, votre action envoie la même invite à chaque fois. Dans cette section, vous allez appliquer le traitement qui contient la logique permettant de créer une réponse dynamique lors d'une conversation.

Termes clés :

• Traitement : code qui contient la logique de votre action. Un webhook lance des appels à votre traitement en fonction des événements survenus dans vos actions.

Votre traitement détermine si l'utilisateur est nouveau ou déjà connu, et modifie en conséquence le message de bienvenue associé à votre action. Le message pour un utilisateur connu est plus court et mentionne son retour: "Toutes mes salutations, aventurier ! Bon retour dans les terres légendaires de Gryffinberg.

Dans cet atelier de programmation, utilisez l'éditeur Cloud Functions de la console Actions pour modifier et déployer votre code de traitement.

Termes clés :

• Éditeur Cloud Functions : éditeur intégré dans la console Actions, que vous pouvez utiliser pour modifier et déployer votre code de traitement avec Cloud Functions for Firebase.

Votre action peut déclencher des webhooks qui informent votre traitement d'un événement qui se produit pendant un appel ou des séquences spécifiques d'une scène. Lorsqu'un webhook est déclenché, votre action envoie à votre traitement une requête avec une charge utile JSON, accompagnée du nom du gestionnaire à utiliser pour traiter l'événement. Ce gestionnaire exécute une logique et renvoie une réponse JSON correspondante.

Créer le traitement

Vous pouvez maintenant modifier votre traitement dans l'éditeur intégré afin de générer différentes invites pour les utilisateurs connus et nouveaux qui appellent votre action.

Pour ajouter cette logique à votre traitement :

1. Dans la barre de navigation, cliquez sur Develop (Développer).
2. Cliquez sur l'onglet Webhook dans la barre de navigation.
3. Cochez la case Inline Cloud Functions (Fonctions Cloud intégrées).
4. Cliquez sur Confirmer. Le code récurrent est ajouté automatiquement pour les fichiers index.js et package.json.

5. Remplacez le contenu du fichier index.js par le code suivant :

index.js

const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');

const app = conversation({debug: true});

app.handle('greeting', conv => {
 let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
 if (!conv.user.lastSeenTime) {
   message = 'Welcome to the mythical land of  Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
 }
 conv.add(message);
});


exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);

5. Cliquez sur Save Fulfillment (Enregistrer le traitement).
6. Cliquez sur Deploy Fulfillment (Déployer le traitement).

Attendez quelques minutes que Cloud Functions provisionne et déploie votre traitement. Le message Cloud Function deployment in progress (Déploiement de Cloud Function) devrait s'afficher au-dessus de l'éditeur de code. Une fois le code déployé, le message Your Cloud Function deployment is up to date (Le déploiement de Cloud Function est à jour).

Comprendre le code

Votre traitement, qui utilise la bibliothèque de traitement Actions on Google pour Node.js, répond aux requêtes HTTP de l'Assistant Google.

Dans l'extrait de code précédent, vous définissez le gestionnaire greeting, qui vérifie si l'utilisateur a déjà visité l'action en contrôlant la propriété lastSeenTime. Si lastSeenTime n'est pas défini, l'utilisateur est nouveau, et le gestionnaire greeting transmet le message de bienvenue destiné aux nouveaux utilisateurs.

Modifier l'appel principal pour déclencher un webhook

Maintenant que vous avez défini la fonction greeting, vous pouvez configurer le gestionnaire d'événements greeting dans votre intent d'appel principal pour que votre action appelle cette fonction lorsque l'utilisateur appelle votre action.

Pour configurer votre action afin d'appeler le nouveau gestionnaire greeting :

1. Dans la barre de navigation, cliquez sur Main invocation (Appel principal).
2. Décochez la case Send prompts (Envoyer des invites).
3. Cochez la case Appeler votre webhook.
4. Ajoutez greeting dans la zone de texte.

5. Cliquez sur Enregistrer.

Tester dans le simulateur l'appel principal modifié

Pour tester votre action dans le simulateur, procédez comme suit :

1. Dans la barre de navigation, cliquez sur Test (Tester) pour accéder au simulateur.
2. Saisissez Talk to my test app dans le champ Input (Entrée), puis appuyez sur Enter.

Comme vous avez déjà testé votre action lors de cet atelier de programmation, vous n'êtes pas un nouvel utilisateur. Vous recevez donc ce message de bienvenue abrégé : Toutes mes salutations, aventurier ! Bon retour dans le monde mythique de Gryffinberg !..."

Effacer votre projet (recommandé)

L'atelier de programmation de niveau 2, intitulé Créer des actions pour l'Assistant Google avec Actions Builder (niveau 2), s'appuie sur le projet que vous venez de créer lors du présent atelier. Si vous prévoyez de suivre l'atelier de niveau 2, ne supprimez pas votre projet tout de suite (vous pourrez le supprimer à la section Effacer votre projet à la fin de l'atelier de programmation de niveau 2).

Pour éviter de vous facturer des frais, nous vous recommandons de supprimer les projets que vous ne comptez pas utiliser. Pour supprimer ceux que vous avez créés dans cet atelier de programmation :

1. Pour supprimer le projet et les ressources Cloud concernés, suivez la procédure décrite dans la section Arrêter (supprimer) des projets.

Assurez-vous de sélectionner le bon projet sur la page Paramètres de Google Cloud Platform.

2. Facultatif: Pour supprimer immédiatement votre projet de la console Actions, suivez la procédure décrite dans la section Supprimer un projet. Si vous ne le faites pas, votre projet sera supprimé automatiquement après un délai de 30 jours environ.

6. Félicitations !

Vous connaissez maintenant les principes de base pour créer des actions pour l'Assistant Google.

Sujets abordés

• Configurer un projet Actions dans la console Actions
• Ajouter une invite à l'appel principal afin que l'utilisateur puisse démarrer une conversation avec votre action
• Créer une interface de conversation avec des scènes, des intents, des transitions et des suggestions, et appliquer le traitement
• Tester votre action dans le simulateur de la console Actions

Learn more

Pour en savoir plus sur la création d'actions pour l'Assistant Google, consultez les ressources suivantes :

• Créer des actions pour l'Assistant Google avec Actions Builder (niveau 2) pour continuer à créer votre action de conversation dans cet atelier de programmation
• Le site officiel de documentation sur le développement d'actions pour l'Assistant Google
• Page GitHub Actions on Google, pour des exemples de code et des bibliothèques
• Communauté Reddit officielle des développeurs qui travaillent sur l'Assistant
• @ActionsOnGoogle sur Twitter pour connaître les dernières informations (envoyez un tweet à #AoGDevs pour montrer votre création)

Enquête

Avant de partir, veuillez répondre à une courte enquête sur votre expérience.