How to create a CLU project

Use this article to learn how to set up these requirements and create a project.

Prerequisites

Before you start using CLU, you will need several things:

Create a Language resource

Before you start using CLU, you will need an Azure Language resource.

Note

  • You need to have an owner role assigned on the resource group to create a Language resource.

Create a new resource from the Azure portal

  1. Go to the Azure portal to create a new Azure Language resource.

  2. Click on Create a new resource

  3. In the window that appears, search for Language service

  4. Click Create

  5. Create a Language resource with following details.

    Instance detail Required value
    Region One of the supported regions for your Language resource.
    Name Required name for your Language resource
    Pricing tier One of the supported pricing tiers for your Language resource.

Create a new Language resource from Language Studio

If it's your first time logging in, you'll see a window in Language Studio that will let you choose an existing Language resource or create a new one. You can also create a resource by clicking the settings icon in the top-right corner, selecting Resources, then clicking Create a new resource.

Create a Language resource with following details.

Instance detail Required value
Azure subscription Your Azure subscription
Azure resource group Your Azure resource group
Azure resource name Your Language resource name
Location A supported regions for your Language resource.
Pricing tier A supported pricing tiers for your Language resource.

Important

  • Make sure to to enable Managed Identity when you create a Language resource.
  • Read and confirm Responsible AI notice

Sign in to Language Studio

  1. Go to the Language Studio and sign in with your Azure account.

  2. In the Choose a language resource window that appears, find your Azure subscription, and choose your Language resource. If you don't have a resource, you can create a new one.

    Instance detail Required value
    Azure subscription Your Azure subscription.
    Azure resource group Your Azure resource group name.
    Azure resource name Your Azure resource name.
    Location One of the supported regions for your Language resource. For example "West US 2".
    Pricing tier One of the valid pricing tiers for your Language resource. You can use the Free (F0) tier to try the service.

    A screenshot showing the resource selection screen in Language Studio.

Create a conversation project

Once you have a Language resource created, create a Conversational Language Understanding project.

  1. In Language Studio, find the section named Understand questions and conversational language and select Conversational language understanding.
    A screenshot showing the location of Custom Language Understanding in the Language Studio landing page.

  2. This will bring you to the Conversational language understanding projects page. Select Create new project.

    A screenshot showing the conversation project page in Language Studio.

To create a new project you need to provide the following details:

Value Description
Name A name for your project. Once it's created, it can't be changed
Description Optional project description.
Utterances primary language The primary language of your project. Your training data should primarily be in this language.
Enable multiple languages Whether you would like to enable your project to support multiple languages at once.

Once you're done, select Next and review the details. Select create to complete the process. You should now see the Build Schema screen in your project.

Import project

You can export a Conversational Language Understanding project as a JSON file at any time by going to the conversation projects page, selecting a project, and from the top menu, clicking on Export.

A screenshot showing the Conversational Language Understanding export button.

That project can be reimported as a new project. If you import a project with the exact same name, it replaces the project's data with the newly imported project's data.

If you have an existing LUIS application, you can import the LUIS application JSON to Conversational Language Understanding directly, and it will create a Conversation project with all the pieces that are currently available: Intents, ML entities, and utterances. See the LUIS migration article for more information.

To import a project, click on the arrow button next to Create a new project and select Import, then select the LUIS or Conversational Language Understanding JSON file.

A screenshot showing the Conversational Language Understanding import button.

Export project

You can export a Conversational Language Understanding project as a JSON file at any time by going to the conversation projects page, selecting a project, and pressing Export.

Get CLU project details

  1. Go to your project settings page in Language Studio.

  2. You can see project details.

  3. In this page you can update project description and enable/disable Multi-lingual dataset in project settings.

  4. You can also retrieve your resource primary key from this page.

    A screenshot of the project settings page.

Delete project

When you don't need your project anymore, you can delete your project using Language Studio. Select projects from the left navigation menu, select project you want to delete and click on Delete from the top menu.

Next Steps

Build schema