Note: help us stay in touch and improve this notebook by clicking on the ⭐ star icon (top right).

This repository hosts the the Watson Assistant Dialog Flow Analysis Notebook and the underlying conversation analytics toolkit library.

The Watson Assistant Dialog Flow Analysis Notebook can help you assess and analyze user journeys and issues related to the dialog flow of ineffective (low quality) conversations based on production logs. The notebook can help you with questions such as:

• What are the common conversation steps and flows within the assistant
• Which flows have low task completion rates and high abandonment (ineffective conversations)
• Where along the dialog steps users lose engagement with your assistant
• What are common terms and steps that may lead to abandonment

This notebook extends the Measure and Analyze notebooks by providing additional capabilities to assess and analyze effectiveness - focused more on issues related to the dialog flow. For more details, check out IBM Watson Assistant Continuous Improvement Best Practices.

The notebook requires a Jupyter Notebook environment and Python 3.6+. You can either install Jupyter Notebook to run locally or you can use Watson Studio on the cloud.

1. Install Python 3.6+
2. Install Jupyter notebook. Checkout the Jupyter/IPython Notebook Quick Start Guide for more details
3. Download the notebooks/Dialog Flow Analysis Notebook.ipynb file.
4. Start jupyter server jupyter notebook
5. Run the Dialog Flow Analysis Notebook.ipynb

1. Create a new custom runtime environment. Select Python 3.6+ as the base. In the customization section pane, update the list of dependencies as defined in requirements.txt.

dependencies:
  - pip:
    - pandas~=0.24.0
    - textblob>=0.15.3
    - scikit-learn>=0.21.3
    - scipy>=1.3.0
    - numpy>=1.15.4
    - requests>=2.18.4
    - nltk>=3.4.5
    - ibm-watson>=4.3.0
    - tqdm>=4.31.1
    - plotly>=4.5.0

2. Select Add to Project-->Notebook. Choose From URL and paste this url. Alternately you can select From file and upload the notebooks/Dialog Flow Analysis Notebook.ipynb file.
3. Run the notebook using the newly created runtime environment (note: the first time use of the runtime environment, can take a few minutes to prepare)

Coming soon...

See FAQ.md for frequently asked questions

This library is licensed under the Apache 2.0 license.

See CONTRIBUTING.md and DEVELOPER.MD for more details on how to contribute

Avi Yaeli	Sergey Zeltyn	Zhe Zhang
Eric Wayne	David Boaz