Beta License Agreement

This product is still in beta and may undergo further changes.

The following are instructions for using various equipment with Sisense’s BI Everywhere software functionality (the equipment and the BI Everywhere software is collectively referred to herein as the “Product”). This notice is to remind users that the Product is a beta release offering and is not warranted to be at the level of performance of a commercially available product offering. In addition, the Product may be substantially modified prior to first commercial release, or at Sisense’s option may not be released commercially in the future. As such, by using the equipment along with the Sisense Software, each user agrees (i) to follow all instructions provided by Sisense with respect to the installation and use of the equipment with the Sisense Software, including the below, and (ii) that such use continues to be for testing and evaluation purposes only.

The Product and Documentation are provided “AS IS” without warranty of any kind, and Sisense and its licensors and suppliers disclaim all warranties, express, implied or statutory, including without limitation any implied warranties of title, non-infringement of third party rights, merchantability, or fitness for a particular purpose. The entire risk arising out of the use or performance of the Product remains with the user.

For the sake of clarity, the provisions in the license agreement between the licensee of the Sisense Software and Sisense (the “License Agreement”), providing any representations, warranties or indemnities shall not apply to the Product. For purposes of the limitation of liability provisions of the License Agreement, no amount has been paid or is payable to Sisense in connection with the Product. However, the license provisions continue to apply to the Sisense Software and the confidentiality provisions of the License Agreement shall continue to apply to those portions of the information shared with you by Sisense that are Confidential Information as defined in the License Agreement or any confidentiality agreement in effect between the licensee and Sisense.

Introduction

Sisense provides you with the means to interact with your data through traditional point-and-click interfaces as well as through voice commands. With a single voice command, you can retrieve and hear your numeric KPIs. The Sisense-Enabled Echo searches your widgets and dashboards to provide you with the best result according to your command.

Sisense enables Amazon’s Echo, which is a voice-powered, wireless-enabled speaker that interfaces with Alexa, to retrieve your data in Sisense. Alexa is a cloud-based voice service that powers the Echo. Alexa’s default capabilities such as playing music can be extended through skills. Sisense has developed a Sisense skill that extends the Echo’s functionality and returns numeric KPIs through voice commands.

This page provides the following information:

  1. How does it Work: Describes how the Sisense-Enabled Echo works.
  2. Setting up the Sisense-Enabled Echo: Describes how to set up the Sisense-Enabled Echo.
  3. Querying the Sisense-Enabled Echo: Describes how to query the Sisense-Enabled Echo.
  4. Troubleshooting: Describes how to troubleshoot potential issues with the Sisense-Enabled Echo.

How does it Work?

After launching Sisense via voice command, you can retrieve numeric data quickly by asking Alexa about your KPIs similar to issuing traditional queries through Sisense.  Your Sisense-Enabled Echo listens for the command and forwards it to Alexa.

alexadiagram

Alexa handles your requests and routes the request to the Sisense ElastiCube where your information is retrieved. Alexa then translates this data into an audio response played back by your Sisense-Enabled Echo.

Setting Up Sisense-Enabled Echo

Sisense has developed a skill that enables you to retrieve your data via voice commands. This skill takes requests from the Alexa service and leverages the Sisense APIs to retrieve your data.

To enable your Sisense-Enabled Echo to accept your voice commands and pass them through the Alexa service and the Sisense APIs, you will need to enable the Sisense skill.

Before setting up your Sisense-Enabled Echo, you may want to create a new user with a single dashboard associated with their account so you can easily test your Echo without returning unexpected results from various dashboards.

Note: To participate in the Sisense-Enabled Echo Beta Program, your Sisense server must be accessible over the Internet without a VPN.

To set up the Sisense-Enabled Echo:

  1. Download the Alexa app from the app store and activate it using your email address.
  2. Turn on your Echo and connect it to your WIFI.
  3. Open the Sisense Skill page and click Enable.
  4. After you have enabled the skill, the Link Account button is displayed.
  5. Click Link Account to display the Sisense Insights page in a new window. If you have a pop-up blocker enabled, you may need to allow the website insights.sisense.com to be opened in a new window.
  6. In the Sisense Insights page you link the Sisense skill to your Sisense account. Enter the following details:
  7. Sisense server address: The address of your Sisense account including “http://.
    Email address: Your Sisense account email address.
    Password: The password of your Sisense account.
  8. Click Authenticate. Your account is now authenticated and you can begin to work with the Sisense-Enabled Echo.

Querying the Sisense-Enabled Echo

There are two ways you can query your Sisense-Enabled Echo. The first option is to ask a question in a single question session. The second option is to ask your questions in a multi-question session, in which you ask multiple questions in a single session. The difference between the two options is that in single question sessions, you must invoke Sisense each time you ask a question. In a multi-question session, you invoke Sisense once, and then ask your questions without having to invoke Sisense again until after you exit the session.

When querying your Sisense-Enabled Echo, there are three ingredients that should be part of your request.

  1. Invocation phrases
  2. Connector words/phrases
  3. Intent requests

Single Question Session

alexaphrase

Multi-Question Session

Invocation: Echo/Alexa, Start Sisense (Opens a multi-question session)

Connector and Intent:

“What is my total sales?”

“Get total visits”

“Provide Total Sales”

“Exit” (Closes a multi-question session)

The invocation phrase is the name of the custom skill where you want to request information. In a single question session, you include the invocation phrase each time you ask a question. In a multi-question session, you can invoke Sisense once by starting Sisense via a voice command and exit the session by saying ‘Exit’. When you invoke Sisense in either session type, Alexa forwards your request to Sisense.

The second ingredient is the connector words or phrases. These words are supported by the Alexa service in combination with the invocation name for a custom skill to request information.

An example of a connector phrase is in bold below:

Alexa, ask <skill> what is my <intent request>

For a list of supported connector words, click here.

The third ingredient is your intent request. The intent request is a request for specific information that corresponds to the skill, in this case, Sisense. Intent requests are defined by Sisense. Sisense supports the following intent requests:

  • Widgets: The names of numeric widgets.
  • Dashboards: The names of dashboards. Alexa returns a list of numeric widgets.
  • Dashboardwidget: The name of a widget within a specific dashboard.
  • Build: The name of an ElastiCube to be built.
  • Share: Share a widget that you opened in the last request. For example, if you ask about a Total Sales widget, then want to share that widget with another user, your request would be:
    • Alexa, ask Sisense what is my Total Sales?
    • Alexa, ask Sisense to share with [email protected]

The order is not relevant. You can invoke Sisense at the beginning or your request or following your request. In addition, additional words and phrases such as ‘the’, ‘please’, and ‘I want’ can be added to your request without interfering with the response.

In a multi-question session, you end the session by saying “Exit”.

Examples

After you have enabled the Sisense skill, you can begin to use your Sisense-Enabled Echo.

Single Question Mode:

Widgets: Alexa, ask Sisense What is my Total Sales.
Dashboards: Alexa, ask Sisense to summarize my Sales dashboard.
Dashboardwidget: Alexa, ask Sisense what is my Total Revenue from the Sales Dashboard.
Build: Alexa, ask Sisense to build the Marketing Elasticube.
Share: Alexa, ask Sisense what is my Total Sales, Alexa, ask Sisense to share with [email protected]
Refresh metadata (Updates your dashboard/widget list)
Analyze [Widget Name] (Runs narrative analysis on your column/scatter/pivot widgets)

Multi-Question Mode:

Alexa, Start Sisense. (Creates a session)
What is my Total Revenue?  (Widgets)
Summarize my Sales dashboard. (Dashboards)
What is my Total Revenue from the Sales Dashboard? (Dashboardwidget)
Build the Marketing Elasticube. (Build)
What is my Total SalesShare with [email protected] (Share)
Exit (Exits a session)

Security

There are two potential security issues that arise when working with the Sisense-Enabled Echo. The first issue is what happens to data when you ask a question.  When you ask questions and receive answers, your data is sent to and returned from the Alexa service. This data transfer takes place across secured SSL ensuring that no one can access your data.

The second issue is securing the Sisense-Enabled Echo itself, so no one can access it and retrieve your data. When you say to Alexa, “Deactivate Account”, this disconnects your Sisense-Enabled Echo from your Sisense account. Alexa will ask you to confirm that you want to deactivate your account. If you respond “Yes”, the account is deactivated. No one will be able to access your data through the Sisense-Enabled Echo until the next time you manually reactivate your account.

Troubleshooting

For Amazon Tap and Echo devices, you can use Voice Training. Voice Training helps Alexa understand your speech patterns. During a Voice Training session, the Alexa app shows 25 different phrases, which you say to your device. To learn more, go to Voice Training.

If you have any issues authenticating your Echo, you can try to enable the device from the desktop through the following site.