Tutorial Bot - IBM Watson Conversation sample

This application demonstrates an event-based proactive chat bot built using Watson Conversation.

Watson Conversation is a service that runs on Bluemix (IBM's cloud development platform). You can create your own instance and train it to understand and respond to your own domain.

This bot consists of 3 parts: the front-end (which runs in your browser), the backend (which provides the front-end with an API to call), and the Watson Conversation service.

Sign up to Bluemix

1. Go to Bluemix
2. Create an account

Create Watson Conversation service

1. Log in to Bluemix
2. Navigate to the "Catalog"
3. Find the Watson services
4. Click on "Conversation"
5. Click "Create" to create your own instance of the Conversation service

Train Watson

1. From the Conversation service on Bluemix, click "Launch tool". This will take you to the Conversation tooling where you can train your bot
2. Select the upload button on the "Workspaces" page
3. Select "Choose a file" and select "workspace-tutorialbot.json" from this app
4. This will load and open this workspace
5. Navigate back to the "Workspaces" page and click the 3 dots on your workspace tile, and select "View details"
6. Note down the workspace ID for later

Get the Tutorial Bot application

1. Clone or download this app from GitHub

Configure application

1. Go to your Conversation service on Bluemix (via the "Dashboard")
2. Navigate to "Service Credentials" and click "View credentials"
3. Use the username and password here to update CONVERSATION_USERNAME and CONVERSATION_PASSWORD in the .env file in the app
4. Use the workspace ID we got earlier to update WORKSPACE_ID in the .env file

Run the app locally

1. Install Node.js
2. Open Terminal or Command Prompt
3. cd into this project's root directory
4. Run npm install to install the app's dependencies
5. Run npm start to start the app
6. Access the running app in a browser at http://localhost:6008

Run the app on Bluemix

1. Log in to Bluemix
2. Navigate to the "Catalog"
3. Find "Cloud Foundry Apps"
4. Select "SDK for Node.js"
5. Provide a name for your app
6. Click "Create"
7. Modify "manifest.yml" to use your app's name
8. Follow the "Getting Started" instructions in your app on Bluemix to deploy this app