Tutorial: crea un progetto Alexa Skill in AWS CodeStar

AWS CodeStarè un servizio di sviluppo basato sul cloud AWS che fornisce gli strumenti necessari per sviluppare, creare e distribuire rapidamente applicazioni. AWS Con AWS CodeStar, è possibile impostare una toolchain di distribuzione continua in pochi minuti, grazie alla quale velocizzare la distribuzione del codice. I modelli di progetto Alexa Skill ti AWS CodeStar consentono di creare una semplice skill Hello World Alexa dal tuo AWS account con pochi clic. Inoltre, i modelli creano una pipeline di distribuzione di base che consente di iniziare con un flusso di lavoro di integrazione continua (CI) per lo sviluppo di competenze.

I principali vantaggi della creazione di competenze con Alexa AWS CodeStar sono la possibilità di iniziare con lo sviluppo delle competenze AWS e di collegare il proprio account sviluppatore Amazon al progetto per distribuire le competenze direttamente dalla fase di sviluppo. AWS Puoi anche ottenere una pipeline (CI) di distribuzione pronta per l'uso con un repository con tutto il codice sorgente per il progetto. Puoi configurare questo repository con il tuo IDE preferito per creare competenze con gli strumenti che ti sono più familiari.

Prerequisiti

• Crea un account sviluppatore di Amazon accedendo a https://developer.amazon.com. La registrazione è gratuita. Questo account possiede le competenze Alexa.

• Se non si dispone di un account AWS, seguire la procedura seguente per crearne uno.

  Per registrarti a AWS

  1. Apri https://aws.amazon.com/, quindi scegli Crea un AWS account.

     Nota

     Se sei già iscritto alla AWS Management Console tramite credenziali Utente root dell'account AWS, scegli Sign in to a different account (Accedi a un account diverso). Se in precedenza hai effettuato l'accesso alla console utilizzando credenziali IAM, scegli Accedi utilizzando Utente root dell'account AWS credenziali. Quindi scegli Crea un nuovo account. AWS

  2. Seguire le istruzioni online.

Importante

Dopo aver creato il progetto di competenze Alexa, apporta tutte le modifiche solo nel repository del progetto. È consigliabile non modificare questa competenza direttamente utilizzando altri strumenti di Alexa Skills Kit, ad esempio l'interfaccia a riga di comando o la console di sviluppatori ASK. Questi strumenti non sono integrati con il repository di progetto. Il loro utilizzo comporta un disallineamento tra la competenza e il codice nel repository.

Fase 1: crea il progetto e collega il tuo account sviluppatore di Amazon

In questo tutorial, crei una competenza utilizzando Node.js in esecuzione su AWS Lambda. La maggior parte dei passaggi sono analoghi per altri linguaggi, anche se il nome della competenza è diverso. Consulta il file README.md nel repository del progetto per i dettagli sul modello di progetto specifico scelto.

1. Accedi aAWS Management Console, quindi apri la AWS CodeStar console all'indirizzo https://console.aws.amazon.com/codestar/.

2. Scegliere la regione AWS in cui si desidera creare il progetto e le sue risorse. Lo skill runtime di Alexa è disponibile nelle seguenti AWS regioni:

   • Asia Pacifico (Tokyo)

   • UE (Irlanda)

   • Stati Uniti orientali (Virginia settentrionale)

   • Stati Uniti occidentali (Oregon)

3. Seleziona Create project (Crea progetto).

4. Nella pagina Choose a project template (Scegli un modello di progetto):

   1. Per il tipo di applicazione, scegli Alexa Skill.

   2. Per Linguaggio di programmazione, scegli Node.js.

5. Scegliere la casella che contiene le selezioni.

6. Per Project name (Nome progetto), immettere un nome per il progetto (ad esempio, My Alexa Skill). Se usi un nome diverso, assicurati di usarlo durante questo tutorial. AWS CodeStarsceglie un identificatore correlato per questo progetto per l'ID del progetto (ad esempio, my-alexa-skill). Se visualizzi un ID progetto diverso, assicurati di usarlo durante tutto il tutorial.

7. Scegli AWS CodeCommit per il repository in questo tutorial e non modificare il valore del nome del repository.

8. Scegli Connect Amazon developer account (Collega account sviluppatore Amazon) per collegare il tuo account sviluppatore di Amazon per l'hosting della competenza. Se non disponi di un account sviluppatore Amazon, crea un account e completa prima la registrazione tramite Amazon Developers.

9. Accedi con le credenziali sviluppatore di Amazon. Scegli Consenti, quindi scegli Conferma per completare la connessione.

10. Se disponi di più ID fornitori associati al tuo account sviluppatore di Amazon, scegli quello che desideri utilizzare per questo progetto. Assicurati di utilizzare un account con il ruolo Amministratore o Sviluppatore assegnato.

11. Seleziona Successivo.

12. (Facoltativo) Se è la prima volta che lo utilizzi AWS CodeStar in questa AWS regione, inserisci il nome visualizzato e l'indirizzo email che desideri utilizzare AWS CodeStar per il tuo utente IAM. Seleziona Successivo.

13. Attendere che AWS CodeStar crei il progetto. Questo processo potrebbe richiedere diversi minuti. Non continuate finché non vedrete il banner Project provisioned.

Fase 2: testa la competenza nel simulatore Alexa

Nella prima fase, AWS CodeStar ha creato una competenza e l'ha distribuita alla fase di sviluppo competenze Alexa. Successivamente, devi testare la competenza nel simulatore Alexa.

1. Nel progetto nella AWS CodeStar console, scegli Visualizza applicazione. Si apre una nuova scheda nel simulatore Alexa.

2. Accedi con le credenziali sviluppatore di Amazon per l'account che hai collegato al progetto nella Fase 1.

3. Sotto Test, scegli Development (Sviluppo) per abilitare il testing.

4. Specificare ask hello node hello. Il nome di invocazione predefinito per la competenza è hello node.

5. La competenza deve rispondere Hello World!.

Quando la competenza è abilitata nel simulatore Alexa, puoi richiamarla anche su un dispositivo abilitato per Alexa registrato al tuo account sviluppatore di Amazon. Per testare la competenza su un dispositivo, pronuncia Alexa, ask hello node to say hello.

Per ulteriori informazioni sul simulatore Alexa, consulta Test della competenza nella console sviluppatore.

Fase 3: esplora le risorse del progetto

Come parte della creazione del progetto, hai AWS CodeStar anche creato AWS risorse per tuo conto. Queste risorse includono un archivio di progetto che utilizza CodeCommit, una pipeline di distribuzione CodePipeline e una AWS Lambda funzione. È possibile accedere a queste risorse dalla barra di navigazione. Ad esempio, scegliendo Repository vengono visualizzati i dettagli relativi al CodeCommit repository. È possibile visualizzare lo stato di distribuzione della pipeline nella pagina Pipeline. È possibile visualizzare un elenco completo delle AWS risorse create come parte del progetto selezionando Panoramica nella barra di navigazione. Questo elenco include i collegamenti per ciascuna risorsa.

Fase 4: effettua una modifica nella risposta della competenza

In questa fase, apporti una piccola modifica alla risposta della competenza per comprendere il ciclo di iterazione.

1. Nella barra di navigazione, scegli Repository. Scegli il link sotto Nome del deposito e il repository del tuo progetto si aprirà in una nuova scheda o finestra. Questo repository contiene la specifica di build (buildspec.yml), lo stack applicativo AWS CloudFormation (template.yml), il file Readme e il codice sorgente della competenza nel formato pacchetto competenza (struttura del progetto).

2. Passa al file lambda > custom > index.js (in caso di Node.js). Questo file contiene il codice di gestione delle richieste, che utilizza il kit SDK ASK.

3. Scegliere Modifica.

4. Sostituisci la stringa Hello World! alla riga 24 con la stringa Hello. How are you?.

5. Scorri fino alla fine del file. Inserisci il nome dell'autore, l'indirizzo e-mail e un messaggio di commit opzionale.

6. Scegli Commit changes (Conferma modifiche) per confermare le modifiche nel repository.

7. Torna al progetto AWS CodeStar e controlla la pagina Pipeline. Ora dovresti vedere la distribuzione della pipeline.

8. Quando la pipeline termina la distribuzione, testa di nuovo la competenza nel simulatore Alexa. La competenza ora deve rispondere con Hello. How are you?.

Fase 5: configura la workstation locale per la connessione al repository di progetto

In precedenza hai apportato una piccola modifica al codice sorgente direttamente dalla CodeCommit console. In questa fase configuri il repository di progetto con la workstation locale in modo da poter modificare e gestire il codice dalla riga di comando o dal tuo IDE preferito. La procedura seguente spiega come configurare gli strumenti a riga di comando.

1. Se necessario, vai al pannello di controllo del progetto in AWS CodeStar.

2. Nella barra di navigazione, scegli IDE.

3. In Accedi al codice del tuo progetto, Visualizza le istruzioni nell'interfaccia a riga di comando.

4. Segui le istruzioni per completare le attività seguenti:

   1. Installa Git sulla workstation locale scaricandolo da un sito web come Git Downloads.

   2. Installa la CLI di AWS. Per ulteriori informazioni, consulta Installazione di AWS Command Line Interface.

   3. Configura la AWS CLI con la chiave di accesso utente IAM e la chiave segreta. Per informazioni, consulta Configurazione della AWS CLI.

   4. Clona il CodeCommit repository del progetto sulla tua workstation locale. Per ulteriori informazioni, consulta Connect to a CodeCommit Repository.

Fasi successive

Questo tutorial ti ha illustrato come iniziare a utilizzare una competenza di base. Per continuare il tuo percorso di sviluppo delle competenze, consulta le seguenti risorse.

• Scopri i fondamenti di una skill guardando How Alexa Skills Work e altri video sul canale Alexa Developers. YouTube

• Comprendere i vari componenti della competenza consultando la documentazione per il formato del pacchetto di competenza, gli schemi manifest delle competenze e gli schemi di modello di interazione.

• Trasformare le idee in competenze consultando la documentazione su Alexa Skills Kit e SDK ASK.