Skip to content

Latest commit

 

History

History
106 lines (68 loc) · 3.92 KB

testing-local.md

File metadata and controls

106 lines (68 loc) · 3.92 KB
Raw

Alexa Skill Development for SeizureTracker.com

The following documentation should explain how to set up this custom Alexa skill that can hopefully eventually work with SeizureTracker.com.

The goal here is to use the SeizureTracker.com API and allow any one to do the following things with Alexa voice commands to an Amazon Echo (or Echo Dot!):

  • Count seizures that have occurred today (CountSeizures)
  • Track a seizure (AddSeizure)
  • Mark seizure as being over (EndSeizure)

Local Setup

To get started, you will want to visit this AWS Alexa Developer page, click "Get Started >" under "Alexa Skills Kit", then click the "Add a New Skill" button in the top right corner.

Skill Information

You want to create a "Custom" skill:

  • Name
    • SeizureTracker
  • Invocation Name
    • "seizure tracker"
  • Global Fields
    • Audio Player
      • No

Interaction Model

  • With the new skill builder that's undergoing beta testing on the Amazon Developer website, I believe that you simply need to import the JSON configuration file from this repository!

Configuration

Endpoint

Account Linking

  • Authorization URL
  • Client ID
    • seizuretracker
  • Domain List
    • seizuretracker.com
    • www.seizuretracker.com
    • st.ericoc.com
  • Authorization Grant Type
    • Implicit Grant

SSL Certificate

Simply select the second option of:

My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority

Test > Service Simulator

Make sure that "Enabled" is selected so that the skill is enabled on your account to test with your Echo (or Echo Dot) device.

Finally, an easy way to test all of the above is to enter a phrase such as one of the following in to the "Enter Utterance" field:

  • Track a seizure

    • should hopefully return a valid JSON response that you can listen to within the browser!

  • Seizure is over

    • should also return a valid JSON response indicating that the previous seizure you recorded has been marked as over.

  • Count seizures

    • should let you track the number of seizures that are stored in the database for the current date

Conclusion

This Alexa skill should also be available locally on your Echo (or Echo Dot) device which you can confirm by visiting alexa.amazon.com, searching for the name of the skill that you set originally, and ensuring that it is Enabled as well as linked to your SeizureTracker.com account.

The only caveat to testing it with your voice on your actual device is that you have to ensure that you are within the Alexa skill by using the invocation word that you set in the beginning. This means that you have to phrase your voice commands like so:

  • "Alexa, tell SeizureTracker to track a seizure."
  • "Alexa, tell SeizureTracker that the seizure is over."
  • "Alexa, ask SeizureTracker to count seizures?"

Different phrasing variations of these all work partially based on words Amazon automatically ignores (like "to" and "the", I think?) as well as the Interaction Model defined so you can try lots of different stuff!

Additionally, you can say "open seizure tracker" (based on the invocation word) which will describe what the skill does allowing you to respond immediately and "track a seizure".

There is also a "help" intent (`"Alexa, ask Seizure Tracker for help") which will describe the functionality of the skill before allowing you to simply respond "yes" to track a seizure!