Skip to content
Learn how to use Watson Assistant and Watson Discovery. This application demonstrates a simple abstraction of a chatbot interacting with a Cloudant NoSQL database, using a Slack UI.
Branch: master
Clone or download
imgbot and Steve Martinelli [ImgBot] Optimize images (#189)
*Total -- 4,752.10kb -> 2,836.24kb (40.32%)

/doc/source/images/create_discovery_service.png -- 237.65kb -> 121.10kb (49.04%)
/doc/source/images/create_cloudant_service.png -- 343.13kb -> 176.78kb (48.48%)
/doc/source/images/create_conversation_service.png -- 239.99kb -> 123.91kb (48.37%)
/doc/source/images/dialog.png -- 481.21kb -> 251.18kb (47.8%)
/doc/source/images/add_data_to_discovery.png -- 95.57kb -> 50.58kb (47.08%)
/doc/source/images/create_service.png -- 84.22kb -> 44.58kb (47.07%)
/doc/source/images/env_vars.png -- 89.86kb -> 48.28kb (46.27%)
/doc/source/images/process_discovery.png -- 96.69kb -> 52.56kb (45.64%)
/doc/source/images/launch_discovery.png -- 167.74kb -> 92.65kb (44.77%)
/doc/source/images/launch_conversation.png -- 196.04kb -> 109.81kb (43.99%)
/doc/source/images/find_conversation_workspace.png -- 83.94kb -> 50.23kb (40.16%)
/doc/source/images/manage_slack_settings.png -- 73.47kb -> 45.11kb (38.6%)
/doc/source/images/select_files_for_discovery.png -- 120.93kb -> 74.49kb (38.41%)
/doc/source/images/cloudantChooseLegacy.png -- 270.18kb -> 167.79kb (37.9%)
/doc/source/images/watsonOnlineManageData.png -- 249.51kb -> 155.50kb (37.68%)
/doc/source/images/open_conversation_menu.png -- 65.80kb -> 41.24kb (37.32%)
/doc/source/images/create_discovery.png -- 32.33kb -> 20.55kb (36.42%)
/doc/source/images/convo_remove.png -- 251.07kb -> 159.71kb (36.39%)
/doc/source/images/view_conversation_workspace_id.png -- 77.77kb -> 49.53kb (36.31%)
/doc/source/images/convo_add.png -- 194.06kb -> 125.14kb (35.51%)
/doc/source/images/view_bot_token.png -- 95.01kb -> 61.79kb (34.96%)
/doc/source/images/view_discovery_ids.png -- 335.40kb -> 218.81kb (34.76%)
/doc/source/images/convo_list.png -- 440.30kb -> 288.63kb (34.45%)
/doc/source/images/nameSlackbot.png -- 16.17kb -> 10.67kb (34.03%)
/doc/source/images/convo_init.png -- 157.47kb -> 104.45kb (33.67%)
/doc/source/images/architecture.png -- 50.48kb -> 34.51kb (31.65%)
/doc/source/images/failedToBindDisco.png -- 64.94kb -> 45.20kb (30.39%)
/python-flask-server/static/css/img/watson.png -- 39.30kb -> 27.80kb (29.26%)
/doc/source/images/import_conversation_workspace.png -- 21.60kb -> 15.66kb (27.51%)
/doc/source/images/name_discovery.png -- 37.17kb -> 29.07kb (21.78%)
/doc/source/images/name_bot.png -- 25.16kb -> 22.00kb (12.57%)
/doc/source/images/invite_bot.png -- 17.93kb -> 16.94kb (5.5%)
Latest commit 3d9f576 Apr 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Iam apikey (#169) Sep 25, 2018
doc/source/images [ImgBot] Optimize images (#189) Apr 20, 2019
python-flask-server [ImgBot] Optimize images (#189) Apr 20, 2019
tools New disco files (#155) Apr 24, 2018
watsononlinestore Fix Issue with bad input. Dec 13, 2018
.gitattributes Update .gitattributes Mar 24, 2017
.gitignore New disco files (#155) Apr 24, 2018
.travis.yml Add flake8 to .travis.yml Mar 13, 2017
ACKNOWLEDGEMENTS.md Update ACKNOWLEDGEMENTS.md Jul 19, 2017
CONTRIBUTING.md Mention troubleshooting near deploy button. Misc markdown/link tweaks. ( Dec 19, 2018
DEVELOPING.md update DEVELOPING file Mar 30, 2017
LICENSE Revise license Nov 11, 2017
MAINTAINERS.md Update MAINTAINERS.md Jul 24, 2018
Procfile Add web UI to watson-online-store Jan 9, 2018
README-pt.md DNM! Revert "Revert "Use a new name"" (#133) Mar 20, 2018
README.md Add instructions to choose Cloudant Legacy. (#188) Apr 10, 2019
README_ko.md DNM! Revert "Revert "Use a new name"" (#133) Mar 20, 2018
TESTING.md Add TESTING.md Mar 24, 2017
__init__.py Deploy to bluemix (#33) Mar 23, 2017
env.sample IAM changes for Discovery Jul 25, 2018
manifest.yml Add web UI to watson-online-store Jan 9, 2018
requirements.txt Update SDK and pin requirements. Dec 13, 2018
run.py Iam apikey (#169) Sep 25, 2018
setup.py DNM! Revert "Revert "Use a new name"" (#133) Mar 20, 2018
test-requirements.txt Pin pytest-cov dependency Jan 14, 2019

README.md

Build Status

Creating a Retail Chatbot using Watson Assistant, Discovery and Database Services

Read this in other languages: 한국어

Watson Conversation is now Watson Assistant. Although some images in this code pattern may show the service as Watson Conversation, the steps and processes will still work.

In this developer code pattern we will create a Watson Assistant based chatbot that allows a user to: 1) find items to purchase using Watson Discovery, and 2) add and remove items from their cart by updating a Cloudant NoSQL Database.

When the reader has completed this code pattern, they will understand how to:

  • Create a chatbot dialog with Watson Assistant
  • Dynamically store and update a Cloudant NoSQL database based on chatbot results
  • Seed data into Watson Discovery and leverage its natural language capabilities
  • Manage and customize a Slack group to add a chatbot

"architecture diagram"

Flow

  1. The user sends a message to the slackbot for online store.
  2. Slack sends this message to the running application.
  3. The application orchestrates the interactions between the various Watson services.
  4. The application queries the Cloudant database for the user's information, including the contents of their shopping cart, and writes the contents back to the database as they change.
  5. The application interacts with Watson Assistant to determine which response to send to Slack, and information passed back and forth in the conversation context determines actions within the application.
  6. Watson Discovery is used to get information about the items in the online store.

Included Components

  • Watson Assistant: Create a chatbot with a program that conducts a conversation via auditory or textual methods.
  • Watson Discovery: A cognitive search and content analytics engine for applications to identify patterns, trends, and actionable insights.
  • Cloudant NoSQL DB: A fully managed data layer designed for modern web and mobile applications that leverages a flexible JSON schema.
  • Slack: Slack is a cloud-based set of team collaboration tools and services with chat bot integration.

Featured Technologies

  • Python: Python is a programming language that lets you work more quickly and integrate your systems more effectively.

Watch the Video

"video"

Steps

NOTE: Perform steps 1-7 OR click the Deploy to IBM Cloud button and hit Deploy and then jump to step 6.

NOTE: The Watson Discovery service is not available in the London region, so this application will require deployment in one of the other IBM Cloud regions.

Deploy to IBM Cloud

Deploy to IBM Cloud

If you encounter deployment errors, refer to Troubleshooting.

You can use the View app button to use a simple web UI to chat. For the Slack integration, use your Slack UI to chat after completing the additional slack configuration. Use the IBM Cloud dashboard to find and manage the app.

Run locally

  1. Clone the repo
  2. Create IBM Cloud services
  3. Get IBM Cloud credentials and add to .env
  4. Configure Watson Assistant
  5. Configure Watson Discovery
  6. Configure Slack
  7. Run the application

1. Clone the repo

Clone the watson-online-store locally. In a terminal, run:

git clone https://github.com/ibm/watson-online-store

We’ll be using the file data/workspace.json and the folder data/ibm_store/

2. Create IBM Cloud services

Create the following services:

NOTE: When provisioning Cloudant, for Available authentication methods choose Use both legacy credentials and IAM:

Cloudant choose legacy

3. Get IBM Cloud services Credentials and add to .env file

As you create the IBM Cloud services, you'll need to create service credentials and get the username and password:

"credentials"

Copy the watson-online-store/env.sample file to watson-online-store/.env and populate the service credentials and URLs as you create the credentials:

# Copy this file to .env and replace the credentials with
# your own before running run.py.

# Watson Assistant
WORKSPACE_ID=<add_assistant_workspace>
ASSISTANT_URL=<add_assistant_url>
## Un-comment and use either username+password or IAM apikey.
# ASSISTANT_USERNAME=<add_assistant_username>
# ASSISTANT_PASSWORD=<add_assistant_password>
# ASSISTANT_IAM_APIKEY=<add_assistant_apikey>

# Cloudant DB
CLOUDANT_USERNAME=<add_cloudant_username>
CLOUDANT_PASSWORD=<add_cloudant_password>
CLOUDANT_DB_NAME=watson_online_store
CLOUDANT_URL=<add_cloudant_url>

# Watson Discovery
DISCOVERY_URL=<add_discovery_url>
DISCOVERY_ENVIRONMENT_ID=<add_discovery_environment>
DISCOVERY_COLLECTION_ID=<add_discovery_collection>
## Un-comment and use either username+password or IAM apikey.
# DISCOVERY_USERNAME=<add_discovery_username>
# DISCOVERY_PASSWORD=<add_discovery_password>
# DISCOVERY_IAM_APIKEY=<add_discovery_apikey>

# Slack
SLACK_BOT_TOKEN=<add_slack_bot_token>
SLACK_BOT_USER=wos

4. Configure Watson Assistant

Import the Assistant workspace.json

  • Find the Assistant service in your IBM Cloud Dashboard.
  • Click on the service and then click on Launch tool.
  • Go to the Skills tab.
  • Click Create new
  • Click the Import skill tab.
  • Click Choose JSON file, go to your cloned repo dir, and Open the workspace.json file in data/workspace.json.
  • Select Everything and click Import.

To find the WORKSPACE_ID for Watson Assistant:

  • Go back to the Skills tab.
  • Find the card for the workspace you would like to use. Look for watson-online-store.
  • Click on the three dots in the upper right-hand corner of the card and select View API Details.
  • Copy the Workspace ID GUID. Save it for the .env file

"Get Workspace ID"

Optionally, to view the conversation dialog select the workspace and choose the Dialog tab, here's a snippet of the dialog:

dialog

5. Configure Watson Discovery

Launch the Watson Discovery tool. wait for the storage to be set up. Create a new data collection by clicking Upload your own data Discovery will setup your storage. (You may be invited to upgrade for production quality, but you will be able to use this code pattern with the free trial version).

name_discovery

Seed the content by using either Drag and drop your documents here or browse from your computer. Choose the JSON files under data/ibm_store/.

Click on the left menu Manage Data icon and then click your newly created Data collection:

manage data

Under the Overview tab, Collection Info section, click Use this collection in API and copy the Collection ID and the Environment ID into your .env file as DISCOVERY_COLLECTION_ID and DISCOVERY_ENVIRONMENT_ID.

"Discovery IDs"

6. Configure Slack

Note: This code pattern includes Slack integration, but if you are only interested in the web UI, you can skip this step.

Create a slack group or use an existing one if you have sufficient authorization. (Refer to Slack's how-to on creating new groups.) To add a new bot, go to the Slack group’s application settings by navigating to https://<slack_group>.slack.com/apps/manage and selecting the Custom Integrations menu on the left.

manage_slack_settings

Click on Bots and then click the green Add Configuration button.

Give the bot a meaningful name. Note that the @ symbol is pre-populated by Slack and you do not include that in your .env configuration file. Save this in .env as SLACK_BOT_USER.

nameSlackbot

Once created save the API Token that is generated into the .env file as SLACK_BOT_TOKEN if you are running locally, or save this if you are using Deploy to IBM Cloud.

view_bot_token

Run /invite <botame> in a channel to invite the bot, or message it directly.

invite_bot

7. Run the application

If you used the Deploy to IBM Cloud button...

If you used Deploy to IBM Cloud, most of the setup is automatic, but not the Slack configuration. For that, we have to update a few environment variables.

In the IBM Cloud dashboard find the App that was created. Click on Runtime on the menu and navigate to the Environment variables tab.

env_vars

Update the three environment variables:

  • Set SLACK_BOT_TOKEN to the token you saved in Step 6
  • Set SLACK_BOT_USER to the name of your bot from Step 6
  • Leave CLOUDANT_DB_NAME set to watson-online-store

Save the new values and restart the application, watch the logs for errors.

If you decided to run the app locally...

The general recommendation for Python development is to use a virtual environment (venv). To install and initialize a virtual environment, use the venv module on Python 3 (you install the virtualenv library for Python 2.7):

# Create the virtual environment using Python. Use one of the two commands depending on your Python version.
# Note, it may be named python3 on your system.

$ python -m venv mytestenv       # Python 3.X
$ virtualenv mytestenv           # Python 2.X

# Now source the virtual environment. Use one of the two commands depending on your OS.

$ source mytestenv/bin/activate  # Mac or Linux
$ ./mytestenv/Scripts/activate   # Windows PowerShell

Now go to the cloned repo directory:

cd watson-online-store

Install the Python requirements for this code pattern. Run:

pip install -r requirements.txt

TIP 💡 To terminate the virtual environment use the deactivate command.

Finally, run the application:

python run.py

Sample output

Start a conversation with your bot:

convo_init

Add an item to your cart:

convo_add

Troubleshooting

  • Error deploying to IBM Cloud:

    "Fail to Bind Discover"

    This indicates that the Discovery service is still being provisioned. Wait a few minutes and click the Run button to restart the application.

  • Large amount of Red Logging info appears.

    This is expected. The color for logging in IBM Cloud will be red, regardless of the nature of the message. The log levels are set to Debug to assist the developer in seeing how the code is executing. This can be changed to logging.WARN or logging.ERROR in the python code.

Links

Learn more

  • Artificial Intelligence Code Patterns: Enjoyed this code pattern? Check out our other AI code patterns.
  • AI and Data Code Pattern Playlist: Bookmark our playlist with all of our code pattern videos
  • With Watson: Want to take your Watson app to the next level? Looking to utilize Watson Brand assets? Join the With Watson program to leverage exclusive brand, marketing, and tech resources to amplify and accelerate your Watson embedded commercial solution.

License

This code pattern is licensed under the Apache License, Version 2. Separate third-party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 and the Apache License, Version 2.

Apache License FAQ

You can’t perform that action at this time.