Tutoriel : créer un projet de compétence Alexa dans AWS CodeStar

AWS CodeStarest un service de développement basé sur le cloud AWS qui fournit les outils dont vous avez besoin pour développer, créer et déployer rapidement des applications. AWS Avec AWS CodeStar, vous pouvez configurer toute votre chaîne d'outils de livraison continue en quelques minutes et commencer à publier du code plus rapidement. Les modèles de projets de compétences Alexa AWS CodeStar ci-dessous vous permettent de créer une compétence Hello World Alexa simple à partir de votre AWS compte en quelques clics. Les modèles créent également un pipeline de déploiement de base qui vous permet de démarrer avec un flux de travail d'intégration continue (CI) pour le développement de compétences.

Les principaux avantages de la création de compétences Alexa AWS CodeStar sont que vous pouvez vous lancer dans le développement des compétences AWS et connecter votre compte de développeur Amazon au projet pour déployer les compétences directement depuis la phase de développementAWS. Vous bénéficiez également d'un pipeline (CI) de déploiement prêt à l'emploi, avec un référentiel contenant tout le code source pour le projet. Vous pouvez configurer ce référentiel avec votre environnement de développement intégré (IDE) favori afin de créer des compétences avec des outils que vous connaissez.

Prérequis

• Créez un compte de développeur Amazon en accédant à la page https://developer.amazon.com. L'inscription est gratuite. Ce compte est propriétaire de vos compétences Alexa.

• Si vous n'avez pas de compte AWS, suivez la procédure suivante pour en créer un.

  Pour s'inscrire à AWS

  1. Ouvrez https://aws.amazon.com/, puis choisissez Create an AWS Account.

     Note

     Si vous vous êtes déjà connecté à la AWS Management Console à l'aide d'informations d'identification Utilisateur racine d'un compte AWS, choisissez Sign in to a different account (Se connecter à un autre compte). Si vous vous êtes déjà connecté à la console à l'aide des informations d'identification IAM, choisissez Se connecter à l'aide Utilisateur racine d'un compte AWS des informations d'identification. Ensuite, choisissez Créer un nouveau compte AWS.

  2. Suivez les instructions en ligne.

Important

Une fois que vous avez créé le projet de compétence Alexa, apportez toutes les modifications requises uniquement dans le référentiel du projet. Nous vous recommandons de ne pas modifier cette compétence directement à l'aide d'un autre outil du kit ASK (Alexa Skills Kit), tel que l'interface de ligne de commande ou la console du développeur ASK. Ces outils ne sont pas intégrés au référentiel du projet. Si vous les utilisez, les codes de la compétence et du référentiel ne seront plus synchronisés.

Étape 1 : Créer le projet et vous connecter à votre compte de développeur Amazon

Dans ce didacticiel, vous créez une compétence à l'aide de Node.js s'exécutant sur AWS Lambda. La plupart des étapes sont identiques pour les autres langages, mais le nom de la compétence diffère. Pour connaître les détails du modèle de projet que vous choisissez, reportez-vous au fichier README.md, situé dans le référentiel du projet.

1. Connectez-vous à la AWS CodeStar consoleAWS Management Console, puis ouvrez-la à l'adresse https://console.aws.amazon.com/codestar/.

2. Choisissez la région AWS dans laquelle vous souhaitez créer le projet et ses ressources. L'environnement d'exécution des compétences Alexa est disponible dans les AWS régions suivantes :

   • Asie Pacifique (Tokyo)

   • UE (Irlande)

   • USA Est (Virginie du Nord)

   • USA Ouest (Oregon)

3. Sélectionnez Create a project (Créer un projet).

4. Sur la page Choisir un modèle de projet :

   1. Pour le type d'application, choisissez Alexa Skill.

   2. Pour Langage de programmation, choisissez Node.js.

5. Choisissez la case qui contient vos sélections.

6. Pour Nom du projet, entrez un nom pour le projet (par exemple, My Alexa Skill). Si vous utilisez un autre nom, veillez à l'utiliser tout au long de ce didacticiel. AWS CodeStarchoisit un identifiant associé pour ce projet comme identifiant de projet (par exemple, my-alexa-skill). Si un ID de projet différent vous est proposé, veillez à l'utiliser tout au long de ce didacticiel.

7. Choisissez AWS CodeCommit pour le référentiel dans ce didacticiel et ne modifiez pas la valeur du nom du référentiel.

8. Choisissez Connect Amazon developer account (Connecter un compte de développeur Amazon) pour pouvoir héberger la compétence sur votre compte de développeur Amazon. Si vous n'avez pas de compte de développeur Amazon, créez-en un et complétez d'abord l'enregistrement auprès d'Amazon Developers.

9. Connectez-vous avec vos informations d'identification de développeur Amazon. Choisissez Autoriser, puis Confirmer pour terminer la connexion.

10. Si plusieurs ID fournisseur sont associés à votre compte de développeur Amazon, choisissez celui que vous souhaitez utiliser pour ce projet. Veillez à utiliser un compte auquel le rôle Administrateur ou Développeur a été attribué.

11. Choisissez Suivant.

12. (Facultatif) S'il s'agit de votre première utilisation AWS CodeStar dans cette AWS région, entrez le nom d'affichage et l'adresse e-mail que vous AWS CodeStar souhaitez utiliser pour votre utilisateur IAM. Choisissez Suivant.

13. Attendez qu'AWS CodeStar crée le projet. Cela peut prendre plusieurs minutes. Ne poursuivez pas tant que vous n'avez pas vu la bannière de provisionnement du projet.

Étape 2 : Tester votre compétence dans le simulateur Alexa

À la première étape, AWS CodeStar a créé une compétence pour vous et l'a déployée vers la phase de développement de compétence Alexa. Vous allez maintenant tester la compétence dans le simulateur Alexa.

1. Dans votre projet dans la AWS CodeStar console, choisissez Afficher l'application. Le simulateur Alexa s'ouvre dans un nouvel onglet.

2. Connectez-vous avec les informations d'identification du compte de développeur Amazon que vous avez utilisé à l'étape 1.

3. Sous Test (Tester), choisissez Development (Développement) pour activer les tests.

4. Saisissez ask hello node hello. Le nom d'appel par défaut pour votre compétence est hello node.

5. Votre compétence doit répondre Hello World!

Lorsque la compétence est activée dans le simulateur Alexa, vous pouvez également l'appeler sur un appareil Alexa enregistré sur votre compte de développeur Amazon. Pour tester votre compétence sur un appareil, dites : « Alexa, demande à hello node de dire bonjour ».

Pour plus d'informations sur le simulateur Alexa, consultez Test Your Skill in the Developer Console (Tester votre compétence dans la console des développeurs).

Étape 3 : Parcourir les ressources du projet

Dans le cadre de la création du projet, vous AWS CodeStar avez également créé AWS des ressources en votre nom. Ces ressources incluent un référentiel de projets utilisant CodeCommit, un pipeline de déploiement utilisant CodePipeline et une AWS Lambda fonction. Vous pouvez accéder à ces ressources à partir de la barre de navigation. Par exemple, le choix de Repository affiche des détails sur le CodeCommit référentiel. Vous pouvez consulter l'état du déploiement du pipeline sur la page Pipeline. Vous pouvez consulter la liste complète des AWS ressources créées dans le cadre de votre projet en choisissant Vue d'ensemble dans la barre de navigation. Cette liste comprend des liens vers chaque ressource.

Étape 4 : Modifier la réponse de votre compétence

Au cours de cette étape, vous apportez une légère modification à la réponse de votre compétence pour comprendre le cycle d'itération.

1. Dans la barre de navigation, choisissez Repository. Cliquez sur le lien sous Nom du référentiel et le référentiel de votre projet s'ouvre dans un nouvel onglet ou une nouvelle fenêtre. Ce référentiel contient la spécification de génération (buildspec.yml), la pile d'applications (template.yml) AWS CloudFormation, le fichier readme et le code source de votre compétence dans le format de package de compétences (structure du projet).

2. Accédez au fichier lambda > custom (personnalisé) > index.js (si Node.js est utilisé). Ce fichier contient votre code de gestion des demandes, qui utilise le Kit de développement logiciel (SDK) ASK.

3. Choisissez Edit (Modifier).

4. Remplacez la chaîne Hello World! de la ligne 24 par la chaîne Hello. How are you?

5. Faites défiler jusqu'à la fin du fichier. Saisissez le nom de l'auteur et l'adresse e-mail ainsi qu'un message de validation éventuel.

6. Choisissez Commit changes (Valider les modifications) pour valider les modifications dans le référentiel.

7. Retournez au projet AWS CodeStar et consultez la page Pipeline. Vous devriez désormais voir le pipeline en cours de déploiement.

8. Lorsque le déploiement du pipeline est terminé, testez à nouveau votre compétence dans le simulateur Alexa. Elle devrait désormais répondre Hello. How are you?

Étape 5 : Configurer votre poste de travail local pour qu'il se connecte à votre référentiel de projet

Plus tôt, vous avez apporté une petite modification au code source directement depuis la CodeCommit console. Au cours de cette étape, vous configurez le référentiel du projet et votre poste de travail local pour pouvoir modifier et gérer le code à partir de la ligne de commande ou de votre IDE préféré. Les étapes suivantes expliquent comment configurer les outils de ligne de commande.

1. Accédez au tableau de bord du projet dans AWS CodeStar, si nécessaire.

2. Dans la barre de navigation, choisissez IDE.

3. Dans Accédez au code de votre projet, affichez les instructions sous l'interface de ligne de commande.

4. Suivez les instructions pour réaliser les tâches suivantes :

   1. Installez Git sur votre poste de travail local à partir d'un site web tel que Git Downloads.

   2. Installez la CLI AWS. Pour plus d'informations, consultez Installation de l'interface de ligne de commande AWS.

   3. Configurez la AWS CLI avec votre clé d'accès utilisateur IAM et votre clé secrète. Pour plus d'informations, consultez la section Configuration de la AWS CLI.

   4. Clonez le CodeCommit dépôt du projet sur votre poste de travail local. Pour plus d'informations, consultez la section Connect to a CodeCommit Repository.

Étapes suivantes

Ce didacticiel vous a montré comment développer une compétence de base. Pour approfondir la question, consultez les ressources suivantes.

• Découvrez les principes fondamentaux d'une compétence en regardant How Alexa Skills Work et d'autres vidéos sur la YouTube chaîne Alexa Developers.

• Comprenez les différents composants de votre compétence en passant en revue la documentation relative au format de package de compétences, aux schémas de manifestes de compétences et aux schémas de modèles d'interactions.

• Transformez votre idée en compétence en passant en revue la documentation relative à l'Alexa Skills Kit et aux kits de développement logiciel (SDK) ASK.