4.2 Definir sua habilidade do Alexa

Introdução

Este exercício o guiará por todas as etapas necessárias para definir e configurar uma nova habilidade do Amazon Alexa.

Pré-requisitos

Antes de criar e configurar uma habilidade do Amazon Alexa, você deve:

  1. Ter uma conta de desenvolvedor do Amazon e fazer logon
  2. Ter uma conta AWS e fazer logon

Consulte Exercício 4.1 para obter mais detalhes.

4.2.1 Criar uma habilidade do Alexa

Para criar uma nova habilidade, siga estas etapas:

Na tela Amazon Developer Dashboard (https://developer.amazon.com/dashboard), selecione Alexa Skills Kit no menu Alexa.

Selecionar Alexa Skill

No alexa developer console, clique no botão Create Skill.

Console do desenvolvedor do Alexa

Na tela Criar uma nova habilidade:

  • Especifique AEP como o Skill name.
  • Selecione English (UK) ou English (US) como o Default Language.
  • Selecione Personalizado como o modelo a ser usado na seção Escolha um modelo para adicionar à sua habilidade.

Criar habilidade

Selecione Provisionar seu próprio como o método a ser usado na seção Escolha um método para hospedar os recursos de backend da sua habilidade.

Criar Habilidade 2

Em seguida, clique em Criar habilidade.

OBSERVAÇÃO

Sua tela pode parecer um pouco diferente dependendo do idioma padrão que você selecionou.

Na tela Escolher um modelo, selecione Iniciar do zero como o modelo a ser usado na seção Escolher um modelo.

Clique em Escolher.

Escolha um template

Sua habilidade está sendo criada agora, e depois você acabará na tela principal de habilidade AEP, que se parece com isto:

Tela principal do Platform Skill

4.2.2 Definir nome de invocação

Para que sua habilidade seja invocada, ela precisa de um nome de invocação. Para definir isso:

Clique em Invocações no menu esquerdo e, em seguida, clique em Skill Invocation Name. Altere o Skill Invocation Name para adobe experience platform. Em seguida, clique em Salvar Modelo.

Nome da Chamada

Isso atualizará a invocação de sua habilidade do Alexa para que você possa dizer Alexa, abrir a adobe experience platform ao testar sua habilidade em uma das próximas etapas.

4.2.3 Definir intenções, amostras e slots

O próximo passo é configurar a interação com nossa habilidade. A interação com uma habilidade da Alexa ocorre por meio das chamadas intenções, das quais a Amazon oferece cinco intenções integradas (por exemplo, AMAZON.HelpIntent, para pedir ajuda). Cada intenção define as declarações de amostra; frases usadas para invocar a intenção. E cada intenção pode ter um ou mais valores de slot; valores fornecidos como entrada para a intenção.

Em vez de permitir que você defina passo a passo as várias intenções, declarações e valores de slot que precisamos para nossa habilidade, usaremos um arquivo JSON para configurar tudo isso de uma só vez. Para fazer isso:

Em seguida, clique em Modelo de interação no menu à esquerda e, em seguida, clique em Editor JSON.

Editor JSON

Baixe e abra o arquivo AWS Alexa Interaction Model.

Selecione tudo e, em seguida, copie tudo.

Simples

No painel Editor JSON à direita, selecione tudo e cole o código que você copiou na etapa anterior, substituindo o texto que já estava lá. Isso carregará o modelo de interação.

Clique em Salvar Modelo.

Arrastar e soltar arquivo JSON

Clique em Intenções no menu à esquerda, depois disso você verá as várias intenções específicas para nossa habilidade no painel à esquerda, por exemplo LdapIntent, GetProductIntent, … UseEmailAddressIntent. Algumas dessas intenções têm um slot, por exemplo, productId para GetProductIntent.

Salvar modelo

4.2.3 Definir as interfaces

Agora definiremos a interface para a habilidade. As interfaces definem como você interage com sua habilidade: somente por voz ou a habilidade também suportará exibição e toque? Se queremos que nossa habilidade use os eventos de exibição e toque, precisamos habilitar essa interface. Além disso, a implementação de nossas habilidades usará o BETA (Amazon Presentation Language). Para configurar corretamente:

Clique em Interfaces no menu à esquerda.

Interfaces

No painel Interfaces, verifique se Alexa Presentation Language e Autodelegation estão ativadas.

Ativar interfaces

Role para cima e clique em Salvar interfaces.

Ativar interfaces

4.2.4 Configurar a implementação

A lógica da sua habilidade é implementada usando o SDK do Alexa NodeJS v2.

Você precisa da funcionalidade implantada no AWS Lambda para poder chamá-la a partir da habilidade. E também é necessário dizer a sua habilidade onde encontrar essa funcionalidade sem servidor para que ela possa chamá-la quando necessário.

Primeiro, vamos configurar sua funcionalidade sem servidor para a habilidade. Para fazer isso:

Certifique-se de estar conectado no AWS Management Console (https://us-east-2.console.aws.amazon.com/console/home).

Selecione um data center preferido na caixa de listagem suspensa no menu superior direito. Por exemplo Leste dos EUA (Ohio) ou UE (Irlanda).

Data Center

Em Find Services digite lambda e pressione Enter.

Lambda

Você acabará na tela inicial AWS Lambda. Clique em Criar uma função.

Tela principal da função Lambda

Na tela Criar função:

  • Selecione Autor do zero
  • Forneça à sua função de habilidade um Nome da função, por exemplo AEP
  • Selecione Node.js 14.x na lista suspensa Runtime

Autor do zero

Clique em Alterar função de execução padrão. Em seguida, selecione Criar uma nova função com permissões Lambda básicas.

Em seguida, clique em Criar função.

Permissões

Você acabará na tela de definição de função AEP, com a guia Code ativa. Clique em Adicionar acionador.

Definição de função da plataforma

Na lista suspensa do acionador disponível, selecione Alexa Skills Kit. Agora, também é necessário fornecer a ID de habilidade da sua habilidade de Alexa.

Configuração necessária

OBSERVAÇÃO

Se Alexa Skills Kit não estiver disponível na lista Adicionar acionadores, o data center selecionado não oferece suporte para isso. Selecione outro data center (por exemplo, EU (Irlanda)) que fornece o acionador Alexa Skills Kit.

Volte para sua habilidade do Alexa. Clique em Endpoint no menu à esquerda. Procure por Seu ID de habilidade. Clique em Copiar para a Área de Transferência.

Endpoint

Clique em Copiar para a área de transferência para copiar a habilidade.

Volte para a tela de definição de função AEP na tela inicial AWS Lambda.

Cole a ID de habilidade no campo ID de habilidade abaixo de Verificação de ID de habilidade. Certifique-se de que Ativar está selecionado, que é a configuração padrão e recomendada.

Em seguida, clique em Adicionar.

Configurar ID de habilidade

De volta à tela da função AWS Lambda, clique em Camadas em aep.

Selecionar plataforma

Na guia Code, clique em Upload from e selecione .zip file.

Código da função

Você verá isso. Baixe o AWS Alexa Lambda Code e salve o arquivo zip em algum lugar em seu computador como aepability.zip.

Clique em Upload.

Código da função

Escolha aepability.zip que você salvou no computador na caixa de diálogo do navegador de arquivos. Clique em Abrir.

Plataforma Skill ZIP

Clique em Salvar.

Plataforma Skill ZIP

Em seguida, vá para a guia Configuration e clique em Environment Variables.

Variáveis de ambiente

Clique em Editar e adicione as variáveis necessárias da tabela abaixo, para que o painel Variáveis de ambiente tenha esta aparência.

Variáveis de ambiente

Chave Valor
alexaBrandName luma
emailAddress rmaur@adobe.com
ldap --demoProfileLdap--
configurationId --configurationID--
IMPORTANTE
  • Defina seu alexaBrandName como a versão em minúsculas do nome da marca (por exemplo, Luma como luma),
  • Se o nome da marca contiver um &, substitua-o por e. Como exemplo, H&M torna-se h e m.

Certifique-se de substituir alexaBrandName, ldap e emailAddress pelos seus detalhes de configuração específicos.

Clique em Salvar quando terminar.

Variáveis de ambiente

Como etapa final, você precisa copiar o Nome do Recurso do Amazon (ARN) que representa essa funcionalidade para nossa habilidade.

Clique no ícone de cópia ao lado de ARN - arm:aws.lambda:… texto conforme indicado.

SAIBA

Volte para seu Console do desenvolvedor do Alexa.

Na tela de configuração Endpoint, cole o ARN copiado da etapa anterior no campo Região padrão (obrigatório).

Endpoint

Em seguida, clique em Salvar Endpoints.

4.2.5 Finalizar a habilidade

Depois de configurar a invocação, intenções, interfaces e endpoint, a etapa final é criar a versão final da sua habilidade.

Para fazer isso:

  • Selecione Invocation no menu esquerdo e clique em Skill Invocation Name.
  • Clique em Salvar Modelo e em Criar Modelo. Isso vai construir o modelo da habilidade. Isso pode demorar um pouco.

Build iniciada

Verifique se, na tela principal da sua habilidade, todos os itens na Lista de verificação do construtor de habilidades (exceto para os Produtos dentro da habilidade opcionais) estão marcados. Para fazer isso:

Clique em Criar. Seu console do desenvolvedor alexa deve exibir marcas de seleção verdes para os primeiros quatro itens na Lista de verificação do construtor de habilidades.

Concluído

Sua habilidade e sua implementação agora estão prontas para serem usadas.

Terminou este exercício.

Próxima etapa: 4.3 Use sua habilidade Alexa

Voltar ao Módulo 4

Voltar para todos os módulos

Nesta página