Ferramentas como Voiceflow são incríveis para design e prototipação de skills e muitas vezes até para o desenvolvimento do produto final. O que acontece é que o desenvolvedor pode precisar de mais liberdade para criar suas skills e acaba tropeçando em algumas barreiras em ferramentas lowcode como essa.

Uma solução é implementar sua skill em Node ou Python usando a plataforma web da própria Amazon no developer console. Isso também pode gerar alguns desgastes já que não há versionamento de código, branchs separadas, trabalho paralelo ou algumas das outras das técnicas usadas no desenvolvimento de projetos atualmente.

Para tentar minimizar esse problema, apresento hoje uma solução no VSCode que te ajuda a desenvolver e testar localmente suas skills. Vou colocar o passo a passo para fazer um pequeno projeto e não vou levar em conta a parte de conceitos mas se quiser saber um pouco sobre utterances, intents, slots, prompts e mais, você poderá conferir nessa minha apresentação AQUI.

A primeira coisa é baixar a extensão Alexa Skills Kit (ASK) Toolkit. É uma extensão poderosa com muitas ferramentas pra sincronizar com a sua conta no developer console da amazon. Depois de instalado deverá aparecer no canto esquerdo um ícone igual ao da alexa.

Clicando em “Sign in” para fazer o login, seu navegador vai abrir a tela de login da amazon. Uma vez logado o VSCode já estará sincronizado com sua conta de desenvolvedor na Alexa.

Criar uma skill do zero

Temos algumas opções aqui, inclusive para baixar uma skill para trabalho em paralelo mas nesse exemplo vamos criar uma do zero. O nome da skill é fala animal e vai simplesmente imitar um animal que o usuário vai requisitar.

Depois de confirmar todos os dados essa etapa pode levar alguns minutos….

Finalizado esse processo, podemos conferir nas imagens abaixo a estrutura do projeto que é a mesma estrutura que foi criada e poderá ser acessa via developer console na Amazon e a imagem da direita mostro o projeto devidamente criado na minha conta.

Codificando a skill

Assim como os conceitos, não vou entrar também nos pormenores da linguagem Python e nem nas técnicas aprofundadas de como criar uma skill mas nesse vídeo aqui tem tudo isso muito bem explicado.

Como falei anteriormente, essa skill vai imitar a fala de um cachorro, um gato ou uma vaca. Qualquer animal diferente desses uma mensagem padrão vai ser apresentada.

Uma vez implementado o tratamento da Intent, é necessário configurar as utterances que vão direcionar o usuário para aquela Intent e isso deve ser feito no console da amazon.

Testando sua skill localmente

Agora que tudo está configurado e codificado, vamos ao teste.

Primeiramente você precisa colocar os arquivos de debug. No VSCode >> Run >> Add Configuration e adicionar um Python File.

Uma vez que o arquivo está adicionado, clique novamente em Run >> Add configuration e escolha a opção ASK: Alexa Skills Debugger (Python).

Abra o terminal e rode o comando para instalar as dependências:

pip install ask-sdk-local-debug

Depois que todas as bibliotecas estiverem instaladas é a hora de testar a sua skill e não precisaremos voltar ao developer console.

Acesse o novo menu com o ícone da alexa e clique em Test Skill >> Open Simulator.

Para quem já fez skills no console developer, já identificou que essa tela é bem parecida com a tela de testes na web. Estou colocando a tela local no VSCode e a tela na web como comparação.

Conclusão

Aplicar técnicas mais modernas (ou nem tanto) de desenvolvimento de software na IDE web pode ser complicado, mas usando o nosso conhecido VSCode o paralelismo no desenvolvimento de skills se torna mais simples assim como o versionamento e outras práticas. Recomendo (muito) aliar esse novo conhecimento a ferramentas como o Voice Flow.

Até mais.

Alberto Mariano