Develop Alexa Skills for Amazon Echo with PHP

transcript

Develop Alexa Skills Develop Alexa Skills for Amazon Echo with PHPfor Amazon Echo with PHP

AWS Tech Community Days, Cologne, 27/09/2017AWS Tech Community Days, Cologne, 27/09/2017

Ralf EggertRalf EggertCEO Travello GmbH, Trainer, Author, Coach,CEO Travello GmbH, Trainer, Author, Coach,

PHP Developer & Alexa Skill DeveloperPHP Developer & Alexa Skill Developer

Three questions!Three questions!

AWS Tech Community DaysAWS Tech Community DaysRalf EggertRalf Eggert 44 from from 5858

AgendaAgenda

Amazon Alexa Basics

Prepare skill

Why PHP?

Implement skill code

Learnings

Amazon Alexa BasicsAmazon Alexa Basics

How does an Alexa request work?How does an Alexa request work?

AWSLambdaFunction

Alexa Voice Service

AWSLambdaFunction

Alexa Voice Service

Voice Command

AWSLambdaFunction

Alexa Voice Service

Voice Command

Voice Request

AWSLambdaFunction

Alexa Voice Service

Voice Command

Voice Request

JSON Request

AWSLambdaFunction

Alexa Voice Service

Voice Command

Voice Request

JSON Request

JSON Response

AWSLambdaFunction

Alexa Voice Service

Text Response

Voice Command

Voice Request

JSON Request

JSON Response

AWSLambdaFunction

Alexa Voice Service

Text Response

Voice Response

Card Response

Voice Command

Voice Request

JSON Request

JSON Response

Alternative requestAlternative request

HTTPSEndpoint

Server

Alexa Voice Service

Text Response

Voice Response

Card Response

Voice Command

Voice Request

JSON Request

JSON Response

Alexa Voice Service (AVS)Alexa Voice Service (AVS)

Alexa Voice Service

AutomaticSpeech

Recognition(ASR)

NaturalLanguage

Understanding(NLU)

TextTo

Speech(TTS)

VoiceCommandMapping

Alexa Skills Kit (ASK)Alexa Skills Kit (ASK)

Alexa Skills Kit

Interaction-Model /Skill Builder

Configuration

Publishing /Privacy

TestService Simulator

Beta Test

ASK OverviewASK Overview

Alexa Skill BuilderAlexa Skill Builder

AWS Lambda FunctionsAWS Lambda Functions

Why PHP?Why PHP?

Possible solutionsPossible solutions

Compile PHP for AWS

Use supported runtime engine for AWS

Use own HTTPS endpoint server

Use supported runtime engine?Use supported runtime engine?

Compile PHP for AWS Lambda?Compile PHP for AWS Lambda?

https://goo.gl/N9VVvb

Use own HTTPS endpoint server?Use own HTTPS endpoint server?

Solution foundSolution found

Compile PHP for AWS

Use supported runtime engine for AWS

Use own HTTPS endpoint server

Disadvantages own HTTPS endpointDisadvantages own HTTPS endpoint

Some dev-tools only work with Lambda (API, CLI)

Need to build own library for Alexa

Server administration

Advantages own HTTPS endpointAdvantages own HTTPS endpoint

Use any software you want

Full control over server environment

Privacy concerns (soft concern)

Open-source PHP libraryOpen-source PHP library

https://github.com/travello-gmbh/

My current tech stackMy current tech stack

Prepare skillPrepare skill

Create sample dialogsCreate sample dialogs

Sample dialog ISample dialog I

Alexa, start my zoo!

Welcome to your zoo.

Please name an animal in my zoo!

An elephant lives in your zoo.

Thanks, Alexa.

You are welcome.

Sample dialog IISample dialog II

Alexa, start my zoo!

Welcome to your zoo.

How many animals live in my zoo?

42 animals live in your zoo.

Thanks, Alexa.

You are welcome.

Create flow diagramsCreate flow diagrams

Flow diagrammFlow diagramm

Welcome to your zoo

Start my zoo

An elephantlives in your zoo

42 animalslive in your zoo

»name« »number«

You're welcome

»thanks« »thanks«

»thanks«

Configure Alexa Skills KitConfigure Alexa Skills Kit

Create custom slot typesCreate custom slot types

Create custom intentsCreate custom intents

Configure HTTPS endpointConfigure HTTPS endpoint

Configure SSL certificateConfigure SSL certificate

Test HTTPS endpointTest HTTPS endpoint

Implement skill codeImplement skill code

Install sample applicationInstall sample application

$ git clone https://github.com/travello-gmbh/example-zoo-skill

$ cd example-zoo-skill

$ composer install

$ sudo chmod -R 777 data/cache/

// setup a virtual host for http://example-zoo-skill

// with the example-zoo-skill/html/ path as doc root

Test sample applicationTest sample application

/data/postman/collection.json

Update text fileUpdate text file

return [ 'alexaLaunchTitle' => 'Welcome', 'alexaLaunchMessage' => 'Welcome to my zoo', 'alexaRepromptMessage' => 'Another animal or cancel?', 'alexaHelpTitle' => 'Help', 'alexaHelpMessage' => 'You can ask me which animal ' . 'lives in your zoo or how many animals live there.', 'alexaCancelTitle' => 'Thanks', 'alexaCancelMessage' => 'Thanks and see you soon!', 'alexaStopTitle' => 'Thanks', 'alexaStopMessage' => 'Thanks and see you soon!', 'alexaAnimalTitle' => 'An animal', 'alexaAnimalMessage' => '%1$s lives in your zoo!', 'alexaCountTitle' => 'Animal census', 'alexaCountMessage' => '%1$s animals live in your zoo!',];

/data/texts/zoo.common.texts.de-DE.php

Create text helper classCreate text helper class

<?phpnamespace Zoo\Application\Helper;

use TravelloAlexaLibrary\Application\Helper\AbstractTextHelper;

class ZooTextHelper extends AbstractTextHelper implements ZooTextHelperInterface{ public function getAnimalTitle(): string { return $this->commonTexts[$this->locale]['alexaAnimalTitle']; } public function getAnimalMessage(string $animal): string { return sprintf($this->commonTexts[$this->locale]['alexaAnimalMessage'], $animal); } public function getCountTitle(): string { return $this->commonTexts[$this->locale]['alexaCountTitle']; } public function getCountMessage(int $count): string { return sprintf($this->commonTexts[$this->locale]['alexaCountMessage'], $count); }} /module/Zoo/src/Application/Helper/ZooTextHelper.php

Create zoo application ICreate zoo application I

<?phpnamespace Zoo\Application;

use TravelloAlexaLibrary\Application\AbstractAlexaApplication;use TravelloAlexaLibrary\Request\RequestType\IntentRequestType;use Zoo\Application\Helper\ZooTextHelperInterface;

class ZooApplication extends AbstractAlexaApplication{ protected function handleIntentRequest(): bool { $intentRequest = $this->alexaRequest->getRequest();

switch ($intentRequest->getIntent()->getName()) { case 'AnimalIntent': return $this->animalIntent();

case 'AMAZON.StopIntent': return $this->stopIntent();

/* ... */ } }}

/module/Zoo/src/Application/ZooApplication.php

Create zoo application IICreate zoo application II

<?phpnamespace Zoo\Application;

use TravelloAlexaLibrary\Response\Card\Standard;use TravelloAlexaLibrary\Response\OutputSpeech\SSML;

class ZooApplication extends AbstractAlexaApplication{ private function animalIntent(): bool { $zooMessage = $this->textHelper->getAnimalMessage('An elephant');

$this->alexaResponse->setOutputSpeech(new SSML($zooMessage));

$this->alexaResponse->setCard(new Standard( $this->textHelper->getAnimalTitle(), $zooMessage, $this->smallImageUrl, $this->largeImageUrl ));

return true; }}

/module/Zoo/src/Application/ZooApplication.php

Test zoo applicationTest zoo application

/data/postman/collection.json

More featuresMore features

Session attributes step2→

Second intent step4→

https://github.com/travello-gmbh/example-zoo-skill

Species slot type step3→

Coming soon in Library 2.0Coming soon in Library 2.0

https://github.com/travello-gmbh/amazon-alexa-skill-library

Introducing Intent classes

Automatic intent handling

LearningsLearnings

Early successEarly success

6 months top 10 activated skills

75.000 customers so far

64 customer reviews so far

2.500.000 utterances so far

Most accessed DE skill in 05/2017

Biggest challengesBiggest challenges

First name slot type

Signature validation

Category slot type intents→

Chance to break first skill2nd server for tests

More complex VUI / CUI

Certification processCertification process

7 days for feedback (02/2017)

Signature validation issue

16 hours to go live (07/2017)Single-word invocation issue

0 issues»abbrechen« intent issue

Development numbersDevelopment numbers

10 working days total

80% for infrastructure code

15 working days total

90% for skill code

20% for skill code

10% for infrastructure code

LearningsLearnings

Start with simple skill

Test thoroughly

Write a solid code base

Build more than one skill

Design a sophisticated VUI

Do not trust slot-types blindly

Have fun!

Questions?Questions?

Thanks!Thanks!Mail: ralf@travello.audioMail: ralf@travello.audioWeb: www.travello.audioWeb: www.travello.audio

Develop Alexa Skills for Amazon Echo with PHP

Technology