PLC/vPLC>> stealth-alexa>> 返回
项目作者： hellostealth

项目描述 ：
Stealth driver for voice bots via Amazon Alexa
高级语言： Ruby
项目地址: git://github.com/hellostealth/stealth-alexa.git
创建时间： 2018-12-10T22:41:59Z
项目社区：https://github.com/hellostealth/stealth-alexa
开源协议：MIT License
下载


Stealth Alexa

The Stealth Alexa driver adds the ability to build Alexa voice bots via Stealth. Alexa bots can be accessed via a wide array of Alexa-enabled products, including Amazon’s own Echo devices (including those with displays).

This Stealth integration provides a way of building Alexa Skills using Stealth. Though the patterns for voice bots are the same as text-based bots, the reply types supported are unique.

Gem Version

Configure the Integration

Replies

Alexa replies are unique in that each request is processed synchronously (unlike most other Stealth integrations). Therefore, each reply should only contain a single reply.

Here are the supported replies for the Alexa integration:

Speech

These are standard replies for Alexa Skills. They are similar to text replies in other integrations. They can be sent like:

  1. - reply_type: speech
  2.   text: Hello World!

If your speech contains difficult to pronouce words or you wish to add effects to the speech, you can send along SSML to help Alexa pronouce the words.

  1. - reply_type: speech
  2.   ssml: "I want to tell you a secret. <amazon:effect name="whispered">I see dead people.</amazon:effect>"

Optionally, you can specify a playBehavior for how Alexa treats your reply. More info here.

  1. - reply_type: speech
  2.   text: Hello World!
  3.   play_behavior: 'ENQUEUE'

Reprompts

Reprompts are sent to the user when either they fail to respond or their response did not match one of your mapped intents. Reprompts are optional and if one is not set, nothing is sent to the user.

If you set reprompt: true, Stealth will re-send your speech.

  1. - reply_type: speech
  2.   text: Hello World!
  3.   reprompt: true

You may also customize your reprompt by specifying a complete speech object:

  1. - reply_type: speech
  2.   text: "Today will provide you a new learning opportunity. Stick with it and the possibilities will be endless. Can I help you with anything else?"
  3.   reprompt:
  4.     text: "Can I help you with anything else?"

You can also specify an SSML reprompt.

Cards

Cards are rich media that can be displayed via the Alexa mobile app or on devices that may feature a screen. Stealth supports all four card types:

  • Simple - a card that contain a title and plain text content
  • Standard - a card that contain a title, plain text content, and an image
  • LinkAccount - a card that displays a link to an authorization URI that the user can use to link their Alexa account with a user in another system. See Account Linking for Custom Skills for details.
  • AskForPermissionsConsent - A card that asks the customer for consent to obtain specific customer information, such as Alexa lists or address information. See Alexa Shopping and To-Do Lists and Enhance Your Skill with Address Information.

Simple card:

  1. - reply_type: card
  2.   type: Simple
  3.   title: Hello World
  4.   content: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas pretium, sem sed placerat elementum, purus quam iaculis dolor, a euismod urna magna et sem.

For standard cards, you can specify a large and small image. For more info on the dimensions and file format, please check out Alexa’s documentation.

  1. - reply_type: card
  2.   type: Standard
  3.   title: Hello World
  4.   content: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas pretium, sem sed placerat elementum, purus quam iaculis dolor, a euismod urna magna et sem.
  5.   small_image_url: https://loremflickr.com/720/480
  6.   large_image_url: https://loremflickr.com/1200/800

Sessions

By default, Stealth will keep a session open between replies. If you would like to end a session, you can set the end_session key to any reply:

  1. - reply_type: speech
  2.   text: Hello World!
  3.   end_session: true

Session Attributes

While your user’s session is active, you can pass along key-value pairs in your responses. These will be spent back by Alexa in their requests. This is useful for multi-step scripts, like for example ordering a pizza.

To set these session values, you can include the session_values key in any your responses (except AudioPlayer and PlaybackController replies).

  1. - reply_type: speech
  2.   text: Hello World!
  3.   session_values:
  4.     x: 1
  5.     y: blue

Directives

Coming soon.

Delays

Delays are not supported for Alexa bots.