4.2 Définition de vos compétences Alexa

Introduction

Cet exercice vous guidera tout au long des étapes nécessaires pour définir et configurer une nouvelle compétence Alexa Amazon.

Conditions préalables

Avant de pouvoir créer et configurer une compétence Alexa Amazon, vous devez :

  1. Posséder un compte de développeur Amazon et être connecté
  2. posséder un compte AWS et être connecté ;

Voir Exercice 4.1 pour plus de détails.

4.2.1 Création d’une compétence Alexa

Pour créer une nouvelle compétence, procédez comme suit :

Sur l’écran Tableau de bord des développeurs Amazon (https://developer.amazon.com/dashboard), sélectionnez Alexa Skills Kit dans le menu Alexa.

Sélection des compétences Alexa

Dans la console de développement d’alexa, cliquez sur le bouton Créer une compétence .

Alexa Developer Console

Dans l’écran Créer une nouvelle compétence :

  • Spécifiez AEP comme Nom de la compétence.
  • Sélectionnez Anglais (UK) ou Anglais (US) comme Langue par défaut.
  • Sélectionnez Personnalisé comme modèle à utiliser dans la section Choisir un modèle à ajouter à vos compétences .

Créer une compétence

Sélectionnez Configurez votre propre comme méthode à utiliser dans la section Choisissez une méthode pour héberger les ressources principales de votre compétence.

Créer une compétence 2

Cliquez ensuite sur Créer une compétence.

REMARQUE

Votre écran peut avoir un aspect légèrement différent selon la langue par défaut que vous avez sélectionnée.

Dans l'écran Choisir un modèle, sélectionnez Démarrer à partir de zéro comme modèle à utiliser dans la section Choisir un modèle .

Cliquez sur Choose.

Choisir un modèle

Votre compétence est en cours de création, après quoi vous finirez dans l’écran principal AEP, qui ressemble à ceci :

Écran principal des compétences de Platform

4.2.2 Définition du nom de l’appel

Pour que votre compétence soit appelée, un nom d’appel est nécessaire. Pour définir ceci :

Cliquez sur Invocations dans le menu de gauche, puis sur Nom de l’appel des compétences. Remplacez le nom de l’appel Skill par adobe experience platform. Cliquez ensuite sur Enregistrer le modèle.

Nom de l’appel

Cela mettra à jour l’appel de votre compétence Alexa afin que vous puissiez dire Alexa, ouvrir adobe experience platform lors du test de votre compétence dans l’une des étapes suivantes.

4.2.3 Définition des intentions, des exemples et des emplacements

L'étape suivante consiste à configurer l'interaction avec nos compétences. L’interaction avec une compétence Alexa se fait par le biais de soi-disant intentions, dont Amazon fournit 5 intentions intégrées (par ex. AMAZON.HelpIntent, pour demander de l’aide). Chaque intention définit des exemples d’énoncés; expressions utilisées pour appeler l’intention. Chaque intention peut avoir une ou plusieurs valeurs d’emplacement; valeurs que vous fournissez en tant qu’entrée de l’intention.

Plutôt que de vous permettre de définir étape par étape les différentes intentions, expressions et valeurs d’emplacement dont nous avons besoin pour nos compétences, nous utiliserons un fichier JSON pour définir tout cela en une seule fois. Pour ce faire :

Cliquez ensuite sur Modèle d’interaction dans le menu de gauche, puis sur Éditeur JSON.

Éditeur JSON

Téléchargez et ouvrez le fichier Modèle d’interaction AWS Alexa.

Sélectionnez tout, puis copiez tout.

Brut

Dans le panneau Éditeur JSON à droite, sélectionnez tout et collez le code que vous avez copié à l’étape précédente, en écrasant le texte qui y était déjà. Cela chargera le modèle d’interaction.

Cliquez sur Enregistrer le modèle.

Glisser-déposer du fichier JSON

Cliquez sur intentions dans le menu de gauche, après quoi vous verrez maintenant les différentes intentions spécifiques de notre compétence sur le rail de gauche, par exemple : LdapIntent, GetProductIntent, … UseEmailAddressIntent. Certaines de ces intentions ont un emplacement, par exemple productId pour GetProductIntent.

Enregistrer le modèle

4.2.3 Définition des interfaces

Nous allons maintenant définir l'interface de la compétence. Les interfaces définissent la manière dont vous interagissez avec vos compétences : uniquement par la voix ou la compétence prendra-t-elle également en charge l’affichage et le toucher ? Si nous voulons que nos compétences pour utiliser les événements display et touch, nous devons activer cette interface. La mise en oeuvre de nos compétences utilise également le langage de présentation Amazon (BETA). Pour configurer correctement ceci :

Cliquez sur Interfaces dans le menu de gauche.

Interfaces

Dans le panneau Interfaces , assurez-vous que Langue de présentation Alexa et Délégation automatique sont toutes deux activées.

Activer les interfaces

Faites défiler l’écran vers le haut et cliquez sur Enregistrer les interfaces.

Activer les interfaces

4.2.4 Configuration de la mise en oeuvre

La logique de votre compétence est implémentée à l’aide du SDK Alexa NodeJS v2.

Votre fonctionnalité doit être déployée dans AWS Lambda afin que vous puissiez l’appeler à partir de vos compétences. Ensuite, vous devez aussi indiquer à votre compétence où trouver cette fonctionnalité sans serveur afin qu’elle puisse l’appeler si nécessaire.

Commençons par configurer vos fonctionnalités sans serveur pour cette compétence. Pour ce faire :

Vérifiez que vous êtes connecté à la console de gestion AWS (https://us-east-2.console.aws.amazon.com/console/home).

Sélectionnez un centre de données que vous préférez dans la liste déroulante du menu supérieur droit. Par exemple : Est des États-Unis (Ohio) ou UE (Irlande).

Centre de données

Dans Rechercher des services, saisissez lambda et appuyez sur Entrée.

Lambda

Vous finirez sur l’écran d’accueil AWS Lambda. Cliquez sur Créer une fonction.

Écran principal de la fonction Lambda

Dans l’écran Créer une fonction :

  • Sélectionnez Auteur de A à Z
  • Donnez à votre fonction de compétence un nom de fonction, par exemple AEP
  • Sélectionnez Node.js 14.x dans la liste déroulante Runtime

Création À Partir De Scratch

Cliquez sur Modifier le rôle d’exécution par défaut. Sélectionnez ensuite Créer un nouveau rôle avec les autorisations de base de Lambda.

Cliquez ensuite sur Créer une fonction.

Autorisations

Vous finirez dans l’écran de définition de la fonction AEP, avec l’onglet Code principal. Cliquez sur Ajouter un déclencheur.

Définition des fonctions de plateforme

Dans la liste déroulante du déclencheur disponible, sélectionnez Alexa Skills Kit. Vous devez également fournir l’ID de compétence de votre compétence Alexa.

Configuration requise

REMARQUE

Si Alexa Skills Kit n’est pas disponible dans la liste Ajouter des triggers , le centre de données que vous avez sélectionné ne le prend pas en charge. Sélectionnez un autre centre de données (par ex. UE (Irlande)) qui fournit le déclencheur Alexa Skills Kit.

Revenez à votre compétence Alexa. Cliquez sur Point d’entrée dans le menu de gauche. Recherchez Votre ID de compétences. Cliquez sur Copier dans le Presse-papiers.

Point d’entrée

Cliquez sur Copier dans le Presse-papiers pour copier la compétence.

Revenez à l’écran de définition de la fonction AEP dans l’écran d’accueil AWS Lambda.

Collez l’ID de compétence dans le champ ID de compétence sous Vérification de l’ID de compétence. Vérifiez que l’option Activer est sélectionnée, ce qui est le paramètre par défaut et recommandé.

Cliquez ensuite sur Ajouter.

Configuration de l’ID de compétences

De retour dans l’écran de la fonction AWS Lambda, cliquez sur Calques sous aep.

Sélectionner une plateforme

Dans l’onglet Code, cliquez sur Télécharger à partir de, puis sélectionnez .zip file.

Code de fonction

Vous verrez alors ceci. Téléchargez le code AWS Alexa Lambda et enregistrez le fichier zip quelque part sur votre ordinateur en tant que aepskill.zip.

Cliquez sur Charger.

Code de fonction

Sélectionnez la balise aepskill.zip que vous avez enregistrée sur votre ordinateur dans la boîte de dialogue du navigateur de fichiers. Cliquez sur Ouvrir.

ZIP des compétences de Platform

Cliquez sur Enregistrer.

ZIP des compétences de Platform

Ensuite, accédez à l’onglet Configuration et cliquez sur Variables d’environnement.

Variables d’environnement

Cliquez sur Modifier et ajoutez les variables requises du tableau ci-dessous. Votre panneau Variables d’environnement ressemblera donc à ceci.

Variables d’environnement

Clé Valeur
alexaBrandName luma
emailAddress rmaur@adobe.com
ldap --demoProfileLdap--
configurationId --configurationID--
IMPORTANT
  • Définissez votre alexaBrandName en tant que version en minuscules de votre nom de marque (par exemple, Luma en tant que luma),
  • Si votre nom de marque contient une balise &, remplacez-la par et. Par exemple, H&M devient h et m.

Veillez à remplacer alexaBrandName, ldap et emailAddress par les détails de configuration spécifiques.

Cliquez sur Enregistrer lorsque vous avez terminé.

Variables d’environnement

En dernière étape, vous devez copier le nom de ressource Amazon (ARN) qui représente cette fonctionnalité dans nos compétences.

Cliquez sur l’icône de copie juste à côté de ARN - arm:aws.lambda:… texte comme indiqué.

ARN

Revenez à Alexa Developer Console.

Dans l’écran de configuration Point d’entrée, collez la version d’apprentissage copiée de l’étape précédente dans le champ Région par défaut (requise) .

Point d’entrée

Cliquez ensuite sur Enregistrer les points de fin.

4.2.5 Finaliser la compétence

Après avoir configuré l’appel, les intentions, les interfaces et le point de terminaison, la dernière étape consiste à créer la version finale de votre compétence.

Pour ce faire :

  • Sélectionnez Invocation dans le menu de gauche, puis cliquez sur Nom d’appel des compétences.
  • Cliquez sur Enregistrer le modèle, puis sur Créer le modèle. Cela construira le modèle de la compétence. Cela pourrait prendre un moment.

Build Started

Vérifiez que sur l’écran principal de votre compétence, tous les éléments de la liste de contrôle du créateur de compétences (à l’exception des produits inqualifiés facultatifs) sont cochés. Pour ce faire :

Cliquez sur Build. Votre console de développement d’alexa doit afficher des coches vertes pour les quatre premiers éléments de la liste de contrôle du générateur de compétences.

Terminé

Votre compétence et sa mise en oeuvre sont maintenant prêtes à être utilisées.

Vous avez terminé cet exercice.

Étape suivante : 4.3 Utilisez vos compétences Alexa

Revenir au module 4

Revenir à tous les modules

Sur cette page