{"id":15524353,"url":"https://github.com/codeforequity-at/botium-connector-luis","last_synced_at":"2025-04-23T07:31:31.160Z","repository":{"id":74502689,"uuid":"167935300","full_name":"codeforequity-at/botium-connector-luis","owner":"codeforequity-at","description":"Botium Connector for Microsoft LUIS","archived":false,"fork":false,"pushed_at":"2025-01-28T11:17:40.000Z","size":213,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T19:04:34.078Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.botium.at","language":"JavaScript","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":"2019-01-28T09:32:44.000Z","updated_at":"2025-01-08T15:04:25.000Z","dependencies_parsed_at":"2025-01-08T16:31:18.217Z","dependency_job_id":"f513d20c-6620-4dad-86db-98fa04337259","html_url":"https://github.com/codeforequity-at/botium-connector-luis","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-luis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-luis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-luis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforequity-at%2Fbotium-connector-luis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeforequity-at","download_url":"https://codeload.github.com/codeforequity-at/botium-connector-luis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250391103,"owners_count":21422844,"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:03.655Z","updated_at":"2025-04-23T07:31:31.137Z","avatar_url":"https://github.com/codeforequity-at.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Botium Connector for Microsoft LUIS\n\n[![NPM](https://nodei.co/npm/botium-connector-luis.png?downloads=true\u0026downloadRank=true\u0026stars=true)](https://nodei.co/npm/botium-connector-luis/)\n\n[![Codeship Status for codeforequity-at/botium-connector-luis](https://app.codeship.com/projects/671767d0-0777-0137-514b-1ae61d02a015/status?branch=master)](https://app.codeship.com/projects/325831)\n[![npm version](https://badge.fury.io/js/botium-connector-luis.svg)](https://badge.fury.io/js/botium-connector-luis)\n[![license](https://img.shields.io/github/license/mashape/apistatus.svg)]()\n\nThis is a [Botium](https://github.com/codeforequity-at/botium-core) connector for testing your Microsoft LUIS intent resolution logic.\n\n**UPDATE 2020/06/15:** As Chatbots grow in importance, automated testing solutions will remain critical for ensuring that Chatbots actually do what their designers intend. We've been busy working on a product that allows testers to have visual insights and deeper understanding in their Chatbot's performance, offering several solutions to boost their interaction!\n[Botium Coach will be introduced to the market as part of our online event on the 24th of June.](https://www.botium.ai/coach/)\n\n[![](http://img.youtube.com/vi/WsNaDfZ7WHk/0.jpg)](http://www.youtube.com/watch?v=WsNaDfZ7WHk \"Botium Coach is coming on 24th of June\")\n\n__Did you read the [Botium in a Nutshell](https://medium.com/@floriantreml/botium-in-a-nutshell-part-1-overview-f8d0ceaf8fb4) articles? Be warned, without prior knowledge of Botium you won't be able to properly use this library!__\n\n## How it works\n\nLUIS is just a stateless NLP. It does send answer, just returns intent, entities.\nSo you are not able to test the answers, as for a chatbot engine.\nBut you can check intent, and entities, and use other [asserter and logic hook](https://github.com/codeforequity-at/botium-core/wiki/Botium-Scripting#asserters-and-logic-hooks).\n\nYou can assert composite entities too:\n```\nINTENT \u003cCompositeEntityName\u003e.\u003cEntityName\u003e\n```\n\nIt can be used as any other Botium connector with all Botium Stack components:\n* [Botium CLI](https://github.com/codeforequity-at/botium-cli/)\n* [Botium Bindings](https://github.com/codeforequity-at/botium-bindings/)\n* [Botium Box](https://www.botium.at)\n\n## Prerequisites\n\n* __Node.js and NPM__\n* [LUIS account](https://www.luis.ai/home)\n* LUIS project (Just to try this connector you can use public IoT project from Microsoft used for the [interactive demonstration](https://azure.microsoft.com/en-us/services/cognitive-services/language-understanding-intelligent-service/))\n* Application ID\n    * Open your project, then go to Manage, Application Information, Application ID\n    * The Id for the public IoT project is df67dcdb-c37d-46af-88e1-8b97951ca1c2\n* LUIS key\n    * [authoring key](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/luis-get-started-node-get-intent#get-luis-key) (up to 1000 queries to the prediction endpoint API per month for all your LUIS apps)\n    * [subscription keys](https://docs.microsoft.com/en-us/azure/cognitive-services/LUIS/luis-how-to-azure-subscription) (Azure account required, free tier possible)\n* a __project directory__ on your workstation to hold test cases and Botium configuration\n\n## Install Botium and Microsoft LUIS Connector\n\nWhen using __Botium CLI__:\n\n```\n\u003e npm install -g botium-cli\n\u003e npm install -g botium-connector-luis\n\u003e botium-cli init\n\u003e botium-cli run\n```\n\nWhen using __Botium Bindings__:\n\n```\n\u003e npm install -g botium-bindings\n\u003e npm install -g botium-connector-luis\n\u003e botium-bindings init mocha\n\u003e npm install \u0026\u0026 npm run mocha\n```\n\nWhen using __Botium Box__:\n\n_Already integrated into Botium Box, no setup required_\n\n## Connecting Microsoft Luis to Botium\n\nCreate a botium.json with Application ID, and LUIS key:\n\n```javascript\n{\n  \"botium\": {\n    \"Capabilities\": {\n      \"PROJECTNAME\": \"Botium Project LUIS\",\n      \"CONTAINERMODE\": \"luis\",\n      \"LUIS_APP_ID\": \"xxx\",\n      \"LUIS_ENDPOINT_KEY\": \"xxx\"\n    }\n  }\n}\n```\n\nBotium setup is ready, you can begin to write your [BotiumScript](https://github.com/codeforequity-at/botium-core/wiki/Botium-Scripting) files.\n\n## How to start sample\n\nThere is a small demo in [samples/IoT dir](./samples/IoT) with Botium Bindings. This tests the public IoT project.\nSo to start it you have to add your authoring key to the _botium.json_ file. Afterwards:\n\n    \u003e npm install\n    \u003e npm test\n\n## Additional Input Parameters\n\n    #begin\n    UPDATE_CUSTOM LUIS_PARAM|spellCheck|true\n\n## Supported Capabilities\n\nSet the capability __CONTAINERMODE__ to __luis__ to activate this connector.\n\n### LUIS_API_VERSION\nV2 or V3\n\n### LUIS_PREDICTION_ENDPOINT_URL\n_Default: https://westus.api.cognitive.microsoft.com_\n\n### LUIS_PREDICTION_ENDPOINT_SLOT\n_Default: staging_\n\nPossible values:\n* staging\n* production\n\n### LUIS_PREDICTION_STATIC_PARAMS\nStatic parameters to add as endpoint url query parameters\n\n    \"LUIS_PREDICTION_STATIC_PARAMS\": {\n      \"spellCheck\": \"true\",\n      \"verbose\": \"true\"\n    }\n\n### LUIS_APP_ID\n\nSee Prerequisites\n\n### LUIS_ENDPOINT_KEY\n\nSee Prerequisites\n\n### LUIS_AUTHORING_KEY\n\nRequired for test set upload/download\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-luis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-luis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforequity-at%2Fbotium-connector-luis/lists"}