Cet exercice vous guidera tout au long des étapes nécessaires pour définir et configurer une nouvelle compétence Alexa Amazon.
Avant de pouvoir créer et configurer une compétence Alexa Amazon, vous devez :
Voir Exercice 4.1 pour plus de détails.
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.
Dans la console de développement d’alexa, cliquez sur le bouton Créer une compétence .
Dans l’écran Créer une nouvelle 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.
Cliquez ensuite sur Créer une compétence.
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.
Votre compétence est en cours de création, après quoi vous finirez dans l’écran principal AEP, qui ressemble à ceci :
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.
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.
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.
Téléchargez et ouvrez le fichier Modèle d’interaction AWS Alexa.
Sélectionnez tout, puis copiez tout.
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.
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.
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.
Dans le panneau Interfaces , assurez-vous que Langue de présentation Alexa et Délégation automatique sont toutes deux activées.
Faites défiler l’écran vers le haut et cliquez sur Enregistrer les interfaces.
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).
Dans Rechercher des services, saisissez lambda et appuyez sur Entrée.
Vous finirez sur l’écran d’accueil AWS Lambda. Cliquez sur Créer une fonction.
Dans l’écran Créer une fonction :
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.
Vous finirez dans l’écran de définition de la fonction AEP, avec l’onglet Code principal. Cliquez sur Ajouter un déclencheur.
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.
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.
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.
De retour dans l’écran de la fonction AWS Lambda, cliquez sur Calques sous aep.
Dans l’onglet Code, cliquez sur Télécharger à partir de, puis sélectionnez .zip file.
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.
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.
Cliquez sur Enregistrer.
Ensuite, accédez à l’onglet Configuration et cliquez sur Variables d’environnement.
Cliquez sur Modifier et ajoutez les variables requises du tableau ci-dessous. Votre panneau Variables d’environnement ressemblera donc à ceci.
Clé | Valeur |
---|---|
alexaBrandName | luma |
emailAddress | rmaur@adobe.com |
ldap | --demoProfileLdap-- |
configurationId | --configurationID-- |
Veillez à remplacer alexaBrandName, ldap et emailAddress par les détails de configuration spécifiques.
Cliquez sur Enregistrer lorsque vous avez terminé.
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é.
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) .
Cliquez ensuite sur Enregistrer les points de fin.
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 :
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.
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