This site is obsolete and should be used for reference only. The information in this documentation is not guaranteed to work for Bot Framework SDK versions past 4.9.1.

Tutorial: Create (csharp)

Provision your Azure resources

The Skill Template requires the following Azure dependencies to run correctly:

  • Azure Web App
  • Azure Storage Account (Transcripts)
  • Azure Application Insights (Telemetry)
  • Azure CosmosDb (State)
  • Language Understanding

Review the pricing and terms for the services and adjust to suit your scenario.

To deploy your Skill using the Azure Resource Manager (ARM) template provided in the project template, follow these steps:

  1. Open PowerShell Core (pwsh.exe)
  2. Change to the project directory of your skill.
  3. Run the following command to login to Azure:
     az login 
  4. If you have multiple subscriptions on your Azure account, change the active subscription to the subscription you wish to deploy your Azure resources to.

  5. Run the following command to deploy your Azure resources using the default settings:

     ./Deployment/Scripts/deploy.ps1 
    ParameterDescriptionRequired?
    nameThe name for your Azure resources.Yes
    resourceGroupThe name for your Azure resource group. Default value is the name parameter.No
    locationThe region for your Azure resource group and resources.Yes
    appIdThe application Id for your Microsoft App Registration.No
    appPasswordThe password for your Microsoft App Registration. If appId is provided this should be the password for your existing Microsoft App Registration. Otherwise, a new registration will be created using this password.Yes
    parametersFileOptional configuration file for ARM Template deployment.No
    createLuisAuthoringIndicates whether a new LUIS authoring resource should be created. If false, luisAuthoringKey and luisEndpoint parameters must be provided.Yes
    luisAuthoringKeyThe authoring key for the LUIS portal. Must be valid key for luisAuthoringRegionNo
    luisAuthoringRegionThe region to deploy LUIS apps.Yes
    armLuisAuthoringRegionThe region to deploy LUIS authoring resource in Azure (only required for Azure Gov deployments)No
    luisEndpointThe LUIS endpoint for deploying and managing LUIS applications. Required if createLuisAuthoring is set to false.No
    useGovFlag indicating if the deployment is targeting the Azure Government Cloud. Defaults to false.No
    qnaEndpointEndpoint for deploying QnA Maker knowledge bases (only required for Azure Gov deployments. See note below for more information.).No
    languagesSpecifies which languages to deploy cognitive models in a comma separated string (e.g. “en-us,de-de,es-es”). Defaults to “en-us”.No
    projDirLocation to save appsettings.json and cognitivemodels.json configuration files. Defaults to current directory.No
    logFileLog file for any errors that occur during script execution. Defaults to Deployment folderNo

You can find more detailed deployment steps including customization instructions in the Deployment Scripts reference.

For manual deployment steps, refer to the Deploy using CLI tools and Deploy using web tutorials.

close