{"id":15524427,"url":"https://github.com/codeforequity-at/botium-samples-crawler","last_synced_at":"2026-01-08T00:03:25.014Z","repository":{"id":91176507,"uuid":"287913267","full_name":"codeforequity-at/botium-samples-crawler","owner":"codeforequity-at","description":"Botium Crawler Sample","archived":false,"fork":false,"pushed_at":"2020-08-18T06:47:30.000Z","size":13,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-03T06:35:27.926Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeforequity-at.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-16T09:33:30.000Z","updated_at":"2020-09-01T09:30:46.000Z","dependencies_parsed_at":"2023-07-21T01:46:48.646Z","dependency_job_id":null,"html_url":"https://github.com/codeforequity-at/botium-samples-crawler","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-samples-crawler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-samples-crawler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-samples-crawler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-samples-crawler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeforequity-at","download_url":"https://codeload.github.com/codeforequity-at/botium-samples-crawler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246100488,"owners_count":20723469,"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-10-02T10:51:19.119Z","updated_at":"2026-01-08T00:03:24.970Z","avatar_url":"https://github.com/codeforequity-at.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Botium Crawler - Like a Website Crawler for Conversation Flows\n\nThis is a sample for showing functionality of the [Botium Crawler](https://github.com/codeforequity-at/botium-crawler).\n\n## Requirements\n\nIn order to run this sample, you need:\n* An [IBM Cloud account](https://cloud.ibm.com/registration) with a [Watson Assistant service](https://cloud.ibm.com/docs/assistant?topic=assistant-getting-started)\n* [Docker](https://docs.docker.com/get-docker/)\n* make (or copy \u0026 run the command from the _Makefile_ in a shell window)\n\n## Prepare Watson Assistant\n\nThis sample is using a Watson Assistant workspace from [this](https://github.com/watson-developer-cloud/assistant-intermediate) Github repository. Download the sample workspace from the _\u003cproject_root\u003e/training/banking_workspace.json_ file.\n\n* In Watson Assistant, create a dialog skill and import it from the above file\n* Create an Assistant and choose this dialog skill\n* Open the _Settings_ menu and click on _API details_ to get the **Assistant ID** and the **API key**\n\n## Prepare botium.json\n\nEnter the **Assistant ID** (capability _WATSON\\_ASSISTANT\\_ID_) and the **API key** (capability _WATSON\\_APIKEY_) in the file _botium.json_ in this repository.\n\n## Run Crawler\n\nBefore running the Botium Crawler, let's check the connectivity to your Watson Assistant. First, download the Botium CLI Docker image:\n\n    $ make pull\n\nThis will take some minutes. Afterwards, run this command to enter a text-based chat interface with your Watson Assistant:\n\n    $ make chat\n\nIf the chat is showing the welcome message from the Watson Assistant, we are fine. Enter _#EXIT_ to cancel the chat.\n\nNow everything is prepared for launching the crawler. Run this command:\n\n    $ make crawl\n\nThe crawler now follows every detected path in the conversation flow of your Watson Assistant, starting from the welcome message. It will follow all detected quick replies and options list and choose every possible option. After a while the crawler will come to an end and will ask you if you want to continue on a conversation path for which the Watson Assistant doesn't present quick replies or option lists.\n\nFor example, at some point the chatbot may ask for an appointment:\n\n    \"Which date would be best for you? We need 24 hours notice for an appointment, the earliest would be tomorrow.\"\n\nHere you can enter all the options you want to send to the chatbot as possible response:\n\n    \"tomorrow\"\n    \"next monday\"\n    \"in two weeks\"\n\nBotium Crawler will then continue crawling based on your responses. It will remember your selection in the _crawler-result/userFeedback.json_ file for the next run.\n\nThe BotiumScript files are saved in the _crawler-result/scripts_ directory.\n\n## Run Tests\n\nNow it is time to do a first test run - the following command will run all of the detected conversation flows again:\n\n    $ make test\n    Botium Test-Suite\n      ✓ 1.1.1_WELCOME_MESSAGE_Making a credit _FAILED (490ms)\n      ✓ 1.1.2_WELCOME_MESSAGE_Making a credit _FAILED (1017ms)\n      ✓ 1.1.3_WELCOME_MESSAGE_Making a credit _FAILED (442ms)\n      ✓ 1.2_WELCOME_MESSAGE_Choosing a credi (181ms)\n      ✓ 1.3.1_WELCOME_MESSAGE_Booking an appoi (436ms)\n      ✓ 1.3.2_WELCOME_MESSAGE_Booking an appoi (407ms)\n      ✓ 1.3.3.1_WELCOME_MESSAGE_Booking an appoi (548ms)\n\n    7 passing (7s)\n\n**Congratulations, you just finished your first Botium Crawler run!**\n\n## Edit Feedback and Re-Run Crawler\n\nIf later you see that you want to add additional options to the ones you already gave above:\n\n    $ make feedback\n\nThis will present all selected options for adding, removing or changing. After changing something there, you have to re-run the crawler to detected additional conversation flows.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-samples-crawler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeforequity-at%2Fbotium-samples-crawler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-samples-crawler/lists"}