Tutorial: Criar um projeto de habilidade do Alexa no AWS CodeStar

O AWS CodeStar é um serviço de desenvolvimento baseado em nuvem no AWS que fornece as ferramentas necessárias para desenvolver, compilar e implantar rapidamente aplicativos no AWS. Com o AWS CodeStar, é possível configurar toda a sua cadeia de ferramentas de entrega contínua em alguns minutos, o que permite agilizar o lançamento de código. Os modelos de projeto de habilidade do Alexa no AWS CodeStar permitem que você crie uma simples habilidade "Hello World" do Alexa diretamente de sua conta do AWS com apenas alguns cliques. Os modelos também criam um pipeline de implantação básico para você começar a usar um fluxo de integração contínua (CI) para o desenvolvimento de habilidades.

Os principais benefícios da criação de habilidades do Alexa com o AWS CodeStar são a possibilidade de você começar a usar o desenvolvimento de habilidades no AWS e conectar sua conta de desenvolvedor da Amazon ao projeto para implantar habilidades para o estágio de desenvolvimento diretamente do AWS. Você também pode obter um pipeline de implantação (CI) pronto para uso com um repositório com todo o código-fonte para o projeto. Você pode configurar esse repositório com seu IDE preferencial para criar habilidades com as ferramentas que já conhece.

Pré-requisitos

• Crie uma conta de desenvolvedor da Amazon acessando https://developer.amazon.com. O cadastro é gratuito. Esta conta é proprietária de suas habilidades do Alexa.

• Se você ainda não tiver uma conta da AWS, use o procedimento a seguir para criar uma.

  Para cadastrar-se na AWS

  1. Abra https://aws.amazon.com/ e selecione Criar uma conta AWS.

     nota

     Se você fez login no AWS Management Console usando credenciais do Usuário raiz da conta da AWS, escolha Sign in to a different account (Fazer login em uma conta diferente). Se você fez login no console usando as credenciais do IAM, selecione Fazer login usando credenciais da Usuário raiz da conta da AWS. Em seguida, escolha Criar uma nova conta do AWS.

  2. Siga as instruções online.

Importante

Depois de criar o projeto de habilidade do Alexa, faça todas as edições somente no repositório do projeto. Recomendamos que você não edite essa habilidade diretamente usando nenhuma outra ferramenta do Alexa Skills Kit (ASK), como a CLI do ASK ou o console do desenvolvedor do ASK. Essas ferramentas não estão integradas ao repositório do projeto. Usá-las fará com que a habilidade e o código de repositório percam a sincronia.

Etapa 1: Criar o projeto e conectar sua conta de desenvolvedor da Amazon

Neste tutorial, você cria uma habilidade usando o Node.js em execução no AWS Lambda. A maioria das etapas são as mesmas para outros idiomas, embora o nome da habilidade seja diferente. Consulte o arquivo README.md no repositório do projeto para obter detalhes específicos do modelo de projeto que você escolher.

1. Faça login no AWS Management Console e então abra o console do AWS CodeStar em https://console.aws.amazon.com/codestar/.

2. Escolha a região da AWS onde você deseja criar o projeto e seus recursos. O runtime da skill da Alexa está disponível nas seguintes regiões do AWS:

   • Ásia-Pacífico (Tóquio)

   • UE (Irlanda)

   • Leste dos EUA (N. da Virgínia)

   • Oeste dos EUA (Oregon)

3. Escolha Create project (Criar projeto).

4. Na página Choose a project template (Escolher um modelo de projeto):

   1. Em Categoria de aplicativo, selecione Alexa Skill.

   2. Em Linguagem de programação, selecione Node.js.

5. Escolha a caixa que contém suas seleções.

6. Em Project name (Nome do projeto), digite o nome do projeto (por exemplo, My Alexa Skill). Se você usar um nome diferente, certifique-se de usá-lo ao longo de todo este tutorial. O AWS CodeStar escolhe um identificador relacionado para o Project ID (ID do projeto) do projeto (por exemplo, minha-habilidade-do-alexa). Se vir outro ID de projeto, certifique-se de usá-lo durante todo este tutorial.

7. Selecione AWS CodeCommit para o repositório neste tutorial e não altere o valor Repository name (Nome do repositório).

8. Selecione Connect Amazon developer account (Conectar conta de desenvolvedor da Amazon) para vincular sua conta de desenvolvedor da Amazon para hospedar a habilidade. Se você não tiver uma conta de desenvolvedor da Amazon, crie uma conta e conclua primeiro o registro com a Amazon Developers.

9. Faça login com suas credenciais de desenvolvedor da Amazon. Escolha Permitir e, em seguida, escolha Confirmar para concluir a conexão.

10. Se você tiver vários IDs de fornecedor associados à sua conta de desenvolvedor da Amazon, selecione aquele que deseja usar para este projeto. Certifique-se de usar uma conta com a função de administrador ou desenvolvedor atribuída.

11. Escolha Next (Próximo).

12. (Opcional) Se esta for a primeira vez que você usa o AWS CodeStar nessa região da AWS, insira o nome de exibição e o endereço de e-mail que o AWS CodeStar deve usar para o usuário do IAM. Escolha Next (Próximo).

13. Aguarde enquanto o AWS CodeStar cria o projeto. Isso pode demorar vários minutos. Não continue até ver o banner provisionado do projeto.

Etapa 2: Testar sua habilidade no Simulador do Alexa

Na primeira etapa, o AWS CodeStar criou uma habilidade para você e a implantou no estágio de desenvolvimento de habilidades do Alexa. Em seguida, você testará a habilidade no Simulador do Alexa.

1. Em seu projeto no console do AWS CodeStar, escolha Exibir aplicativo. Uma nova guia será aberta no Simulador do Alexa.

2. Faça login com suas credenciais de desenvolvedor da Amazon da conta com a qual você se conectou ao seu projeto na Etapa 1.

3. Em Test (Testar), selecione Development (Desenvolvimento) para habilitar os testes.

4. Digite ask hello node hello. O nome de invocação padrão para a habilidade é hello node.

5. Sua habilidade deve responder Hello World!.

Quando a habilidade estiver habilitada no Simulador do Alexa, você também poderá invocá-la em um dispositivo habilitado para o Alexa que estiver registrado em sua conta de desenvolvedor da Amazon. Para testar a habilidade em um dispositivo, diga Alexa, peça ao nó "hello" para dizer "hello".

Para obter mais informações sobre o Simulador do Alexa, consulte Testar sua habilidade no console do desenvolvedor.

Etapa 3: Explorar os recursos do projeto

Como parte da criação do projeto, o AWS CodeStar também criou os recursos do AWS em seu nome. Esses recursos incluem um repositório do projeto usando o CodeCommit, um pipeline de implantação usando o CodePipeline e uma função AWS Lambda. Você pode acessar esses recursos na barra de navegação. Por exemplo, escolher Repositório mostra detalhes sobre o repositório do CodeCommit. Você pode ver o status de implantação do pipeline na página Pipeline. Você pode visualizar uma lista completa de recursos do AWS criados como parte de seu projeto selecionando Visão geral na barra de navegação à esquerda. Essa lista inclui links para cada recurso.

Etapa 4: Fazer uma alteração na resposta da habilidade

Nesta etapa, faça uma pequena alteração na resposta de sua habilidade para compreender o ciclo de iteração.

1. Na barra de navegação, escolha Repositório. Escolha o link em Nome do repositório e o repositório do seu projeto será aberto em uma nova guia ou janela. Esse repositório contém a especificação de compilação (buildspec.yml), a pilha de aplicativos do AWS CloudFormation (template.yml), o arquivo readme e o código-fonte de sua habilidade no formato do pacote da habilidade (estrutura do projeto).

2. Navegue até o arquivo lambda > personalizar > index.js (no caso do Node.js.). Esse arquivo contém o código de manuseio da solicitação, que usa o ASK SDK.

3. Escolha Editar.

4. Substitua a string Hello World! na linha 24 pela string Hello. How are you?.

5. Role para baixo até o final do arquivo. Insira o nome do autor e o endereço de e-mail, bem como uma mensagem opcional de confirmação.

6. Selecione Commit changes (Confirmar alterações) para confirmar as alterações ao repositório.

7. Retorne ao projeto em AWS CodeStar e confira a página do Pipeline. Você agora deverá ver a implantação do pipeline.

8. Quando a implantação do pipeline for concluída, teste a habilidade de novamente no Simulador do Alexa. A habilidade deve responder Hello. How are you?.

Etapa 5: Configurar sua estação de trabalho local para se conectar ao repositório do projeto

Anteriormente, foi feita uma pequena alteração no código-fonte diretamente do console do CodeCommit. Nesta etapa, você configura o repositório do projeto com sua estação de trabalho local, para que possa editar e gerenciar o código na linha de comando ou no seu IDE favorito. As etapas a seguir explicam como configurar as ferramentas de linha de comando.

1. Navegue até o painel do projeto no AWS CodeStar, se necessário.

2. Na barra de navegação, escolha IDE.

3. Em Acessar o código do seu projeto, exibir as instruções abaixo da interface da linha de comando.

4. Siga as instruções para concluir as tarefas a seguir:

   1. Instale o Git em sua estação de trabalho local a partir de um site, como Git Downloads.

   2. Instale a CLI do AWS. Para obter informações, consulte Instalar a interface de linha de comando da AWS.

   3. Configure a CLI do AWS com sua chave de acesso do usuário do IAM e a chave secreta. Para obter informações, consulte Configurar a CLI do AWS.

   4. Clone o repositório do CodeCommit do projeto em sua estação de trabalho local. Para obter instruções, consulte Conectar-se a um repositório do CodeCommit.

Próximas etapas

Este tutorial mostrou como começar com uma habilidade básica. Para continuar sua jornada de desenvolvimento de habilidades, consulte os recursos a seguir.

• Entenda os conceitos básicos de uma habilidade assistindo a Como o Alexa funciona e outros vídeos no canal de desenvolvedores do Alexa no YouTube.

• Entenda os vários componentes da sua habilidade, examinando a documentação do formato de pacote da habilidade, os esquemas do manifesto da habilidade, e os esquemas do modelo de interação.

• Transforme sua ideia em uma habilidade examinando a documentação do Alexa Skills Kit e os ASK SDKs.