1.0.1 • Published 1 year ago

botium-connector-azure-clu v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Botium Connector for Azure Conversational Language Understanding

NPM

Codeship Status for codeforequity-at/botium-connector-azure-clu npm version license

This is a Botium connector for testing your Azure Conversational Language Understanding intent resolution logic.

Did you read the Botium in a Nutshell articles? Be warned, without prior knowledge of Botium you won't be able to properly use this library!

How it works

Azure Conversational Language Understanding is just a stateless NLP recognition engine, extracting intent, and entities. You can use corresponding Botium NLP Asserters

It can be used as any other Botium connector with all Botium Stack components:

Prerequisites

See also Quickstart: Conversational language understanding)

Install Botium and Azure Conversational Language Understanding Connector

When using Botium CLI:

> npm install -g botium-cli
> npm install -g botium-connector-azure-clu
> botium-cli init
> botium-cli run

When using Botium Bindings:

> npm install -g botium-bindings
> npm install -g botium-connector-azure-clu
> botium-bindings init mocha
> npm install && npm run mocha

When using Botium Box:

Already integrated into Botium Box, no setup required

Connecting Azure Conversational Language Understanding

Create a botium.json with Azure resource key, and endpoint:

{
  "botium": {
    "Capabilities": {
      "PROJECTNAME": "Botium Project Azure CLU",
      "CONTAINERMODE": "azure-clu",
      "AZURE_CLU_ENDPOINT_URL": "xxx",
      "AZURE_CLU_ENDPOINT_KEY": "xxx",
      "AZURE_CLU_PROJECT_NAME": "xxx",
      "AZURE_CLU_DEPLOYMENT_NAME": "xxx"
    }
  }
}

Botium setup is ready, you can begin to write your BotiumScript files.

Supported Capabilities

Set the capability CONTAINERMODE to azure-clu to activate this connector.

AZURE_CLU_ENDPOINT_URL

See Resource key, and endpoint of the Azure CLU project

AZURE_CLU_ENDPOINT_KEY

See Resource key, and endpoint of the Azure CLU project

AZURE_CLU_PROJECT_NAME

The name of the Azure CLU project

AZURE_CLU_DEPLOYMENT_NAME

The Azure CLU deployment to test.

AZURE_CLU_API_VERSION

API version. Default: 2022-05-01

AZURE_CLU_PARTICIPANT_ID

The participiant ID. See Azure API doc

AZURE_CLU_LANGUAGE

The language of the conversation.

AZURE_CLU_DIRECT_TARGET

The direct target. See Azure API doc

AZURE_CLU_TARGET_PROJECT_PARAMETERS

The target project parameters. See Azure API doc

Possible values:

  • staging
  • production