alexa tesco skill

Habilidade Alexa Tesco

Descrição

Alexa Skill Integration com Tesco. Permite controlar a voz das compras em mantimentos da Tesco. É possível adicionar produtos à cesta de supermercado apenas usando a voz.

Características

No momento, ele apenas permite adicionar um produto à cesta

• Adicione um item à cesta de compras da Tesco
  • Alexa pede à Tesco para adicionar leite à cesta
  • Alexa pede à Tesco para adicionar leite
• Adicione vários itens à cesta da Tesco Mercearies
  • Alexa pede à Tesco para adicionar o leite tempos três
  • Alexa pede à Tesco que adicione um pouco de leite -> isso solicitará uma pergunta sobre quantos.

Requisitos

• Nodejs 6 e npm
• Um Amazon Echo/Dot
• Uma conta de desenvolvedor da Amazon
• Uma conta de compras da Tesco
• Uma conta ifttt
• Um servidor para processar as solicitações provenientes do eco. Neste guia, usarei a AWS Lambda, então precisamos da ALS uma Amazon AWS Accout

Integração de alto nível

Instalação

Ok, vamos começar clonando este projeto:

 git clone https://github.com/onegambler/alexa-tesco-skill.git

Ifttt

A Tesco não fornece APIs públicas para adicionar produtos à cesta de supermercados; Felizmente, o IFTTT tem uma integração da Tesco que fornece exatamente o que estamos procurando. Então, vamos criar uma conta com ifttt (se você não tiver uma) e adicionar um applet para fazer o trabalho:

• Clique em My Applets e depois New applet
• Clique no this e pesquise Webhooks .
  • Dê permissão ao Serviço clicando em Connect e, em seguida, Receive a web request
  • Como Event Name defina tesco_search . Isso precisa ser o mesmo!
  • E clique em create trigger
• Clique agora no that e procure por Tesco
  • Dê permissão ao serviço clicando em Connect e depois Search for and add product to basket
  • Escreva {{Value1}} What to search for campo. Isso também pode ser feito clicando em ingredients e depois value1
  • Por fim, clique em Create action e Finish

No final, você deve ter um applet que se pareça com o seguinte:

Depois de criar o applet, precisamos copiar o URL do fabricante. Portanto, navegue até a página da criadora, clique aqui nas configurações e você verá as informações da conta. Algo assim:

 Account Info
Connected as ...
URL https://maker.ifttt.com/use/<KEY>
Status active

Copie o <KEY> e mantenha isso em algum lugar, pois precisaremos usá -lo mais tarde.

Personalizando os produtos

Agora precisamos informar a habilidade de quais produtos podem ser pesquisados ​​e adicionados à cesta. No projeto, abra o arquivo products.yml . Ele contém uma lista das compras mais comuns. Alexa entenderá apenas os produtos contidos na lista. Você pode adicionar qualquer produto que desejar, desde que possa ser encontrado usando a barra de pesquisa de compras no Tesco.com. Também deve -se notar que a ação IFTTT

Pesquisará o Tesco.com por produtos que correspondem ao texto da pesquisa e adicione o primeiro resultado à sua cesta.

Por esse motivo, se queremos uma ação mais precisa e evitamos adicionar o item errado, podemos especificar seu ID na lista. Para fazer isso, vá para a página da web da Tesco Mercearies e obtenha os IDs para os produtos que você deseja. Em cada página do produto, você pode encontrar o ID no URL

 http://www.tesco.com/groceries/product/details/?id=264245536

Nesse caso, 264245536 e adicione -o ao products.yml como mostrado abaixo.

 products :
    - banana :
        id : ' 275280804 '
        aliases :
            - bananas
    - cherry tomatoes :
    - milk :
        id : ' 260569996 '

Ao especificar o ID do produto, podemos personalizar ainda mais a lista:

    - mens deodorant :
        id : ' 272227552 '
        aliases :
            - Roberto's deodorant

Depois que os produtos são mapeados, você pode salvar e passar para a próxima etapa.

Construindo a habilidade

Instale a versão 6 do nó com o NPM, se você ainda não o fez e verifique se ele funciona corretamente.

Em seguida, cd na pasta Alexa-Tesco-Skill e execute

 npm install

Para baixar todas as dependências.

O projeto vem com alguns scripts gulp para facilitar o processo de construção. Então, vamos instalá -lo globalmente

 npm install -g gulp

OK, agora podemos transformar o projeto em um arquivo zip que pode ser carregado no Lambda.

 gulp build

Se tudo correu bem, agora você deve ver uma pasta dist e um arquivo dist.zip .

Amazon Lambda

Conforme mencionado antes de precisarmos de uma conta da AWS, pois implantaremos o código no AWS Lambda, que processará as solicitações. Os primeiros 1.000.000 de solicitações/mês são gratuitos, então mais do que suficiente para não gastar um centavo.

Há muitos tutoriais, então não vou entrar em detalhes.

Antes de configurá -lo, observe!

"Verifique se você selecionou as habilidades N.Virginia for English (EUA) ou a região da UE (Irlanda) para o inglês (Reino Unido) e as habilidades alemãs. A região é exibida no canto superior direito. Fornecendo sua função Lambda na correta região impede problemas de latência "

Aqui está um link útil para configurar um Lambda para uma habilidade Alexa, siga a criação de uma função lambda para um parágrafo de habilidades do Alexa :

• https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/develding-an-alexa-skill-as-a-lambda-function

Notas

• Crie o lambda como Blank Function
• Configure um Alexa Skills Kit como gatilho
• Use Node.js 4.3 como ambiente de tempo de execução
• Definir index.handler como manipulador

Então, algo assim

Para trabalhar corretamente, o Lambda precisa de algumas variáveis ​​de ambiente, na guia general precisamos adicionar:

• APP_ID : É a sequência de identificação Lambda, não é um parâmetro obrigatório, mas torna um pouco mais seguro, fazendo com que seu Lambda aceite apenas solicitações de sua habilidade específica. Pode ser encontrado na página Alexa Skill Set Up.
• Ifttt_url : é o URL do ifttt webhook. Deve ser https://maker.ifttt.com/trigger
• Ifttt_key : é a chave ifttt salva antes

Lembre -se de salvar o valor Lambda Arn, encontrado no canto superior direito da caixa de diálogo, precisaremos dele mais tarde.

Configuração de habilidade

Depois de configurar seu Lambda, você precisará de uma conta de desenvolvedor da Amazon para criar uma nova habilidade do Alexa.

1. Skill Information da guia

   • Adicione Name e Invocation Name . Esteja ciente de que o segundo é o nome que você usará para ativar a habilidade. Eu uso Tesco , para que eu possa dizer "Alexa Ask Tesco ..", mas depende completamente de você.
   • Clique no sem Audio Player

2. Interaction Model da guia

   • Certifique -se de executar o comando gulp build , pois ele gerará arquivos do products.yml necessário para a habilidade configurada
   • Cole o conteúdo de dist/speechAssets/IntentSchema.json no campo Intent Schema
   • Cole o conteúdo de dist/speechAssets/SampleUtterances.txt no campo Sample Utterances .
   • Crie um Custom Slot Type chamado GROCERY e adicione o conteúdo do arquivo dist/speechAsset/slot-types/GROCERY . Mais informações sobre slots personalizados podem ser encontrados aqui.

3. Configuration da guia

   • Defina AWS Lambda ARN como Service Endpoint Type , selecione a região geográfica correta (o mesmo que o lambda) e insira o Lambda ARN no campo de entrada.

4. Ignore outras guias (não queremos publicar a habilidade) e clique em Save

Instruções mais detalhadas podem ser encontradas no seguinte: etapas para criar uma habilidade de casa inteligente

Juntando tudo

Ok, quase lá. Como última etapa, precisamos implantar o arquivo na AWS Lambda. O projeto vem com node-aws-lambda ; Um utilitário de nós usado para a implantação da Lambda. Você pode ler mais sobre isso aqui. Sinceramente, prefiro fazer isso manualmente, para não precisar lidar com chaves de acesso e tokens; Então, vamos voltar ao recém -criado Lambda - na página do console da AWS - e vamos fazer o upload do arquivo dist.zip . Em seguida, clique em save e devemos estar prontos para ir. Tente adicionar um pouco de leite e veja se funciona!

Problemas

Aqui estão alguns problemas que você pode enfrentar usando a habilidade

• O item mapeado não está mais disponível : Infelizmente, ainda não encontrei uma maneira de saber se um item fica indisponível para uma filial Tesco específica. O IFTTT não responde com erros nesse caso, então o Alexa dirá que tudo correu bem, mesmo que o produto não seja adicionado à cesta. A Tesco também não fornece APIs para obter esse tipo de informação. Na minha experiência, isso acontece principalmente com frutas e legumes sazonais e não foi um grande problema para mim até agora. Ainda estou procurando uma solução alternativa.