Skip to content

Latest commit

 

History

History
78 lines (54 loc) · 4.04 KB

cli.md

File metadata and controls

78 lines (54 loc) · 4.04 KB
Raw

Build the Omics BioAnalytics Alexa Skill

Setup w/ ASK CLI

About

This readme assumes you have your developer environment ready to go and that you have some familiarity with CLI (Command Line Interface) Tools, AWS, and the ASK Developer Portal.

Pre-requisites

  • Node.js (> v12)
  • Register for an AWS Account
  • Register for an Amazon Developer Account
  • Install and Setup ASK CLI
  • Make and S3 bucket. Set the S3Bucket env variable. Add the following files to your bucket.
  • Make a DynamoDB table with the primary key as "id". Set the table name as an env variable.

Installation

  1. Make sure you are running the latest version of the CLI

    $ npm update -g ask-cli

  2. Clone the repository.

    $ git clone https://github.com/singha53/omics-bioanalytics-alexa-skill.git

  3. If it's your first time using it, initiatialize the ASK CLI by navigating into the repository and running npm command: ask init. Follow the prompts.

    $ cd omics-bioanalytics-alexa-skill
$ ask init

  4. Install npm dependencies by navigating into the /lambda/custom directory and running the npm command: npm install --save

    $ cd lambda/custom
$ npm install

Deployment

ASK CLI will create the skill and the lambda function for you.

  1. Navigate to the project's root directory. you should see a file named 'skill.json' there.

  2. Deploy the skill and the lambda function in one step by running the following command:

    $ ask deploy

Testing

  1. To test, you need to login to Alexa Developer Console, and enable the "Test" switch on your skill from the "Test" Tab.

  2. Simulate verbal interaction with your skill through the command line (this might take a few moments) using the following example:

     $ ask simulate -l en-GB -t "start omics bioanalytics"

 ✓ Simulation created for simulation id: 4a7a9ed8-94b2-40c0-b3bd-fb63d9887fa7
◡ Waiting for simulation response{
  "status": "SUCCESSFUL",
  ...

  3. Once the "Test" switch is enabled, your skill can be tested on devices associated with the developer account as well. Speak to Alexa from any enabled device, from your browser at echosim.io, or through your Amazon Mobile App and say :

    Alexa, start omics bioanalytics

References