Skip to content

Latest commit

 

History

History
166 lines (126 loc) · 13.1 KB

configuring.md

File metadata and controls

166 lines (126 loc) · 13.1 KB
Raw

Configuring Intu

Your instance of Intu is pre-configured with the following Watson services from Bluemix: Conversation, Weather Company Data, Speech to Text, and Text to Speech. The pre-configuration is enabled for 30 days. If you want to continue to use Intu after 30 days, you must create your own instances of these services and configure Intu to use them.

This page will walk you through the following:

  1. Creating and configuring the necessary services for Intu
  2. What extra functionality is available if you create and configure additional services
  3. Creating and configuring optional services for Intu

A. Creating required instances of Watson services

In order to use Intu, at minimum you need operational instances of the following services in Bluemix: Conversation, Speech to Text, and Text to Speech.

Note: While Weather Company Data is one of the 30 day trial pre-configured services, it is not required to use Intu. It does, however, offer additional functionality (as described below).

###To create and configure an instance of Watson Conversation Service:

  1. Verify you are logged into Bluemix.
  2. Click here to be taken to the Conversation Service page in Bluemix.
  3. Click the Create button located at the bottom of the page.
  4. Wait a few moments while your new service is being created. Once it is created you will automatically be taken to your new service's page.
  5. Click on the Service credentials tab.
  6. Click on the View credentials button. The credentials for your new Bluemix service will be displayed.
  7. Copy and paste the username and password into the Intu Gateway by completing the following steps:
    1. Click on MANAGE on the left-hand sidebar of the Intu Gateway.
    2. Click on Services. You will be taken to the Services page on the Gateway.
    3. If not yet selected, select your Organization and Group towards the top of the page.
    4. You should see all your services displayed.
    5. Click the Edit button (pencil icon) for ConversationV1.
    6. Paste your username and password into the USER ID and PASSWORD fields.
    7. Click SAVE

Note for Conversation service only: In addition to configuring your username and password for this service, you also need to update the Workspace IDs.

The Intu Starter Kit contains a Conversation service workspace that helps you visualize how intents, entities, and dialog are developed. You can expand on the workspace in the kit or use it as a guide for developing your own later.

  1. Log in to Intu Gateway.
  2. Click Downloads.
  3. Download the Intu Starter Kit.
  4. Complete the instructions in readme.txt.

###To create and configure an instance of Watson Speech to Text Service:

  1. Verify you are logged into Bluemix.
  2. Click here to be taken to the Speech to Text Service page in Bluemix.
  3. Click the Create button located at the bottom of the page.
  4. Wait a few moments while your new service is being created. Once it is created you will automatically be taken to your new service's page.
  5. Click on the Service credentials tab.
  6. Click on the View credentials button. The credentials for your new Bluemix service will be displayed.
  7. Copy and paste the username and password into the Intu Gateway by completing the following steps:
    1. Click on MANAGE on the left-hand sidebar of the Intu Gateway.
    2. Click on Services. You will be taken to the Services page on the Gateway.
    3. If not yet selected, select your Organization and Group towards the top of the page.
    4. You should see all your services displayed.
    5. Click the Edit button (pencil icon) for SpeechToTextV1.
    6. Paste your username and password into the USER ID and PASSWORD fields.
    7. Click SAVE

###To create and configure an instance of Watson Text to Speech Service:

  1. Verify you are logged into Bluemix.
  2. Click here to be taken to the Text to Speech Service page in Bluemix.
  3. Click the Create button located at the bottom of the page.
  4. Wait a few moments while your new service is being created. Once it is created you will automatically be taken to your new service's page.
  5. Click on the Service credentials tab.
  6. Click on the View credentials button. The credentials for your new Bluemix service will be displayed.
  7. Copy and paste the username and password into the Intu Gateway by completing the following steps:
    1. Click on MANAGE on the left-hand sidebar of the Intu Gateway.
    2. Click on Services. You will be taken to the Services page on the Gateway.
    3. If not yet selected, select your Organization and Group towards the top of the page.
    4. You should see all your services displayed.
    5. Click the Edit button (pencil icon) for TextToSpeechV1.
    6. Paste your username and password into the USER ID and PASSWORD fields.
    7. Click SAVE

B. Additional functionality that can be used with Intu

While only Conversation, Speech to Text, and Text to Speech are required for running Intu, you can add more Bluemix services for even more usability. In the section below you can read about additional Intu features that can be used if you have the necessary Bluemix services configured in your Intu Gateway.

Note: For the features listed below to work, you need to use the Conversation workspace downloaded from the Intu Starter Kit located on the Intu Gateway Downloads page. You can use this workspace in addition to any other ones you would like to use.

  1. Greeter Agent: Intu will greet you! For this to work you need to have your camera turned on. If you are running Intu on a Mac, Windows, or Nao robot device and are using the Intu Starter Kit Conversation workspace, simply saying "turn the camera on" will turn your camera on.

    • Additional Bluemix services required: Visual Recognition

    Note: For a more personalized greeting, see Name Agent below.

  2. Weather Agent: Get Intu to tell you about the weather! Examples of weather-related questions you can ask: "What is the weather in Boston" or "What will the weather be like in Las Vegas on Friday".

    • Additional Bluemix services required: Natural Language Understanding and Weather Company Data

  3. Time Agent: Get Intu to tell you what time it is! Examples of time-related questions you can ask: "What time is it right now" or "What time is it in Tokyo".

    • Additional Bluemix services required: Natural Language Understanding and Weather Company Data

  4. Name Agent: You can rename your Intu device or get Intu to learn your name! Examples of name-related queries you can tell Intu: "Your name is now Bobby" or "My name is John". Once Intu learns your name, it will greet you by name using the Greeter Agent mentioned above.

    • Additional Bluemix services required (for renaming only): Natural Language Understanding
    • Additional Bluemix services required (for learning your name): Natural Language Understanding and Visual Recognition

  5. Telephony Agent: Get Intu to call you or someone else! Please see Workshop 4 for more details on how to configure and use the Telephony Agent.

    • Additional services required: Nexmo -- note: This is NOT a Bluemix service

C. Creating additional services in Intu

As mentioned in the previous section, adding the Weather Company Data, Visual Recognition, and Natural Language Understanding Bluemix services can add more functionality to your Intu instance.

###To create and configure an instance of Weather Company Data Service:

  1. Verify you are logged into Bluemix.
  2. Click here to be taken to the Weather Company Data Service page in Bluemix.
  3. Click the Create button located at the bottom of the page.
  4. Wait a few moments while your new service is being created. Once it is created you will automatically be taken to your new service's page.
  5. Click on the Service credentials tab.
  6. Click on the View credentials button. The credentials for your new Bluemix service will be displayed.
  7. Copy and paste the username and password into the Intu Gateway by completing the following steps:
    1. Click on MANAGE on the left-hand sidebar of the Intu Gateway.
    2. Click on Services. You will be taken to the Services page on the Gateway.
    3. If not yet selected, select your Organization and Group towards the top of the page.
    4. You should see all your services displayed.
    5. Click the Edit button (pencil icon) for WeatherCompanyDataV1.
    6. Paste your username and password into the USER ID and PASSWORD fields.
    7. Click SAVE

###To create and configure an instance of Visual Recognition Service:

  1. Verify you are logged into Bluemix.
  2. Click here to be taken to the Visual Recognition Service page in Bluemix.
  3. Click the Create button located at the bottom of the page.
  4. Wait a few moments while your new service is being created. Once it is created you will automatically be taken to your new service's page.
  5. Click on the Service credentials tab.
  6. Click on the View credentials button. The credentials for your new Bluemix service will be displayed.
  7. Copy and paste the api_key and url into the Intu Gateway by completing the following steps:
    1. Click on MANAGE on the left-hand sidebar of the Intu Gateway.
    2. Click on Services. You will be taken to the Services page on the Gateway.
    3. If not yet selected, select your Organization and Group towards the top of the page.
    4. You should see all your services displayed.
    5. Click the + Add Service button. A pop-up form will appear.
    6. In the SERVICE NAME field, put VisualRecognitionV1.
    7. In the USER ID field, paste the api_key obtained from Bluemix. You will leave the PASSWORD field blank as Visual Recognition uses an api key rather than a standard username/password.
    8. In the SERVICE ENDPOINT field, paste the url obtained from Bluemix.
    9. Click SAVE

###To create and configure an instance of Natural Language Understanding Service:

  1. Verify you are logged into Bluemix.
  2. Click here to be taken to the Natural Language Understanding Service page in Bluemix.
  3. Click the Create button located at the bottom of the page.
  4. Wait a few moments while your new service is being created. Once it is created you will automatically be taken to your new service's page.
  5. Click on the Service credentials tab.
  6. Click on the View credentials button. The credentials for your new Bluemix service will be displayed.
  7. Copy and paste the username, password, and url into the Intu Gateway by completing the following steps:
    1. Click on MANAGE on the left-hand sidebar of the Intu Gateway.
    2. Click on Services. You will be taken to the Services page on the Gateway.
    3. If not yet selected, select your Organization and Group towards the top of the page.
    4. You should see all your services displayed.
    5. Click the + Add Service button. A pop-up form will appear.
    6. In the SERVICE NAME field, put NaturalLanguageUnderstandingV1.
    7. Paste your username and password into the USER ID and PASSWORD fields.
    8. In the SERVICE ENDPOINT field, paste the url obtained from Bluemix.
    9. Click SAVE