{"id":19403140,"url":"https://github.com/watson-developer-cloud/assistant-dialog-flow-analysis","last_synced_at":"2025-10-26T15:02:50.852Z","repository":{"id":37961001,"uuid":"267695131","full_name":"watson-developer-cloud/assistant-dialog-flow-analysis","owner":"watson-developer-cloud","description":"Dialog Flow Analysis Notebook for Watson Assistant","archived":false,"fork":false,"pushed_at":"2022-11-15T13:36:18.000Z","size":13898,"stargazers_count":28,"open_issues_count":1,"forks_count":13,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-01-07T12:29:59.075Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/watson-developer-cloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-28T20:57:36.000Z","updated_at":"2024-04-11T23:53:46.000Z","dependencies_parsed_at":"2023-01-21T12:17:42.367Z","dependency_job_id":null,"html_url":"https://github.com/watson-developer-cloud/assistant-dialog-flow-analysis","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson-developer-cloud%2Fassistant-dialog-flow-analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson-developer-cloud%2Fassistant-dialog-flow-analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson-developer-cloud%2Fassistant-dialog-flow-analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/watson-developer-cloud%2Fassistant-dialog-flow-analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/watson-developer-cloud","download_url":"https://codeload.github.com/watson-developer-cloud/assistant-dialog-flow-analysis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240578111,"owners_count":19823570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T11:27:21.114Z","updated_at":"2025-10-26T15:02:50.798Z","avatar_url":"https://github.com/watson-developer-cloud.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Watson Assistant Dialog Flow Analysis\n\n\u003e Note: help us stay in touch and improve this notebook by clicking on the :star: star icon (top right).\n\nThis repository hosts the the Watson Assistant Dialog Flow Analysis Notebook and the underlying conversation analytics toolkit library.\n\n\u003cdetails\u003e\n \u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n \n [Introduction](#introduction)\u003cbr\u003e\n [Getting Started](#getting-started)\u003cbr\u003e\n [Guides](#guides)\u003cbr\u003e\n [Frequently Asked Questions](#frequently-asked-questions)\u003cbr\u003e\n [License](#license)\u003cbr\u003e\n [Contributing](#contributing)\u003cbr\u003e\n\n\u003c/details\u003e\n\n## Introduction\n\nThe 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:\n- What are the common conversation steps and flows within the assistant \n- Which flows have low task completion rates and high abandonment (ineffective conversations)\n- Where along the dialog steps users lose engagement with your assistant\n- What are common terms and steps that may lead to abandonment\n\nThis notebook extends the [Measure and Analyze notebooks](https://github.com/watson-developer-cloud/assistant-improve-recommendations-notebook) 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](https://github.com/watson-developer-cloud/assistant-improve-recommendations-notebook/raw/master/notebook/IBM%20Watson%20Assistant%20Continuous%20Improvement%20Best%20Practices.pdf).\n\n\n\u003cimg src=\"./notebooks/images/flow-vis.png\" width=\"50%\"\u003e\n\n## Getting Started\n\nThe 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.\n\n### Using Jupyter Notebook\n1. Install Python 3.6+\n2. Install Jupyter notebook. Checkout the [Jupyter/IPython Notebook Quick Start Guide](https://jupyter-notebook-beginner-guide.readthedocs.io/en/latest/install.html) for more details\n3. Download the [notebooks/Dialog Flow Analysis Notebook.ipynb](https://github.com/watson-developer-cloud/assistant-dialog-flow-analysis/blob/master/notebooks/Dialog%20Flow%20Analysis%20Notebook.ipynb) file.   \n4. Start jupyter server `jupyter notebook`\n5. Run the `Dialog Flow Analysis Notebook.ipynb`\n\n### Using Watson Studio\n1. In Watson Studio, select `Add to Project`--\u003e`Notebook`.  Choose `From URL` and paste this [url](https://raw.githubusercontent.com/watson-developer-cloud/assistant-dialog-flow-analysis/master/notebooks/Dialog%20Flow%20Analysis%20Notebook.ipynb).  Alternately you can select `From file` and upload the `notebooks/Dialog Flow Analysis Notebook.ipynb` file.\n\nAlternately, you can import and modify the [sample notebook on Watson Studio Gallery](https://dataplatform.cloud.ibm.com/exchange/public/entry/view/013c690997e27f3a8d9133265327a9e5?context=wdp).\n\n\n## Guides\n* Learn more about the Dialog Flow Analysis in this [blog](https://medium.com/ibm-watson/do-you-know-where-and-why-users-drop-off-the-conversation-6246e99baddc)\n* See a live example output of the notebook on [Watson Studio Gallery](https://dataplatform.cloud.ibm.com/exchange/public/entry/view/013c690997e27f3a8d9133265327a9e5?context=wdp)\n\n\n## Frequently Asked Questions\nSee [FAQ.md](FAQ.md) for frequently asked questions \n\n## License\nThis library is licensed under the [Apache 2.0 license](http://www.apache.org/licenses/LICENSE-2.0).\n\n## Contributing \nSee [CONTRIBUTING.md](CONTRIBUTING.md) and [DEVELOPER.MD](DEVELOPER.MD) for more details on how to contribute\n\n## Contributor List\n\n\n| | | | | |\n:-------------------------:|:-------------------------:|:-------------------------:|:-------------------------:|:-------------------------:|\n\u003cimg src=\"https://avatars3.githubusercontent.com/u/9696082?s=460\u0026u=459ccd11b224e202f41b5309f6ae881c2714e7ab\u0026v=4\" alt=\"Avi Yaeli\" width=80/\u003e \u003cbr/\u003e \u003cb\u003e[Avi Yaeli](https://github.com/ayaeli)\u003cb\u003e | \u003cimg src=\"https://avatars1.githubusercontent.com/u/13829603?s=400\u0026u=293450598db5209eb471769b5032776034bfcc27\u0026v=4\" alt=\"Sergey Zeltyn\" width=80/\u003e \u003cbr/\u003e \u003cb\u003e[Sergey Zeltyn](https://github.com/Sergey-Zeltyn)\u003cb\u003e | \u003cimg src=\"https://avatars0.githubusercontent.com/u/43827532?s=400\u0026u=817665e525cad70970ea6e0319dda98d1f26910d\u0026v=4\" alt=\"Zhe Zhang\" width=80/\u003e \u003cbr/\u003e \u003cb\u003e[Zhe Zhang](https://github.com/zzhang13)\u003cb\u003e | \u003cimg src=\"https://avatars1.githubusercontent.com/u/24845274?s=400\u0026u=ca3e3ab4bb4c0d6e16b984dc4b4a95fffe53a40c\u0026v=4\" alt=\"Eric Wayne\" width=80/\u003e \u003cbr/\u003e \u003cb\u003e[Eric Wayne](https://github.com/eric-wayne)\u003cb\u003e | \u003cimg src=\"https://avatars0.githubusercontent.com/u/11946512?s=400\u0026u=379d439244faf5202735603dfa23d72dd07bfa0e\u0026v=4\" alt=\"David Boaz\" width=80/\u003e \u003cbr/\u003e \u003cb\u003e[David Boaz](https://github.com/boazdavid)\u003cb\u003e |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwatson-developer-cloud%2Fassistant-dialog-flow-analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwatson-developer-cloud%2Fassistant-dialog-flow-analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwatson-developer-cloud%2Fassistant-dialog-flow-analysis/lists"}