Example video: https://vimeo.com/267224817 Test with plan 32, locations such as: bedroom or kitchen To upload correctly a plan double click upload after adding url.
## What it does
Clerkexa gives directions to users who ask "her" where they can find something. Sentences such as "Where is <destination>" ; "Where can I find <destination>" will make her give people simple directions like "Go forward then left".
The possible destinations are defined on a map on our website plan builder interface: http://doby.fr/alx/plan_builder.php.
### Using the skill
To use the sill, you will first need to setup a map on our planbuilder webpage then you will be able to ask Alexa for your destinations.
### Setup of the map
First you need to have an image of your map.
Then you need to setup your map on http://doby.fr/alx/plan_builder.php:
#### 1) Import your map
Put your map url in the step 1 section on http://doby.fr/alx/plan_builder.php and click upload.
#### 2) Place Alexa on the map
Click on one of the four Alexa buttons with arrows. The arrow selected will define the direction Alexa considers as "forward". Click on the map to place Alexa.
#### 3) Define the junctions on your map (possible paths)
Put the junctions of your map. The junctions represent the potential changes of directions. The whole set of junctions will be all the potential paths Alexa will indicate.
When defining junctions you will be prompted for nearest neighbors, the nearest neighbor of an element is the closest junction. The first junction you place should the closest junction to Alexa and its nearest neighbor Alexa.
To place a junction, click the junct button and click on the map.
Write the name of the closest junction when asked for the nearest neighbor (first junction needs "Alexa" as nearest neighbor, others will be J<number>).
#### 4) Define the destinations on your map (locations where Alexa will guide people).
When all your junction are placed, it is time to put the destinations on the map. The destinations are all the point of the map Alexa will give users instructions to go to.
To place a destination, click the dest button and click on the map, give it the name you want (Id of the destination).
As for junctions write the name of the closest junction when asked for the nearest neighbor, nearest neighbors can only be junctions.
#### 5) Define the synonyms for your destinations (the words alexa will recognize as triggers for guiding to destinations)
On the Add synonymus line on the webpage for every destination you defined enter the name of the destination as Destination and the spoken words you wish Alexa to recognize for that destination. Click on add to register the synonym.
Example: If you named your destination "lift", you can add those pairs : "lift" - "lift" ; "lift" - "elevator"...
You can give as many synonyms you want to a destination and a destination must have at least one synonym.
#### 6) Validate the map and get your map number by email
You will then receive an email on the adress you specified with a number. When initializing the skill you will need to tell Alexa this number.
### Using Clerkexa
Put the Skill Clerkexa on your Alexa device and:
####1) Say "guide me" to trigger the skill
####2) Tell Alexa your plan number
Alexa will then ask for your plan number. You have received your plan number after validating your map on http://doby.fr/alx/plan_builder.php on the email you specified.
Answer to Alexa with "My plan number is [your_plan_number]".
Alexa will then indicate if she found your plan. If not she will ask you again for a plan number.
####3) Ask Alexa for directions
You will then be able to ask Alexa for directions: "Where is [location]?" "Where can I find [location]?" and other alike sentences.
[location] spoken words are all the synonyms you have inputed in the plan builder.
Alexa will then give you directions if she recognized the spoken words or tell you if she did not get what you said.