How to create projects in orchestration workflow

Orchestration workflow allows you to create projects that connect your applications to:

  • Custom Language Understanding
  • Question Answering
  • LUIS

Prerequisites

Before you start using orchestration workflow, you will need several things:

Create a Language resource

Before you start using orchestration workflow, 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.
  • If you are planning to use question answering, you have to enable question answering in resource creation

Create a new resource from the Azure portal

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

  2. Click on Continue to create your resource

  3. Create a Language resource with following details.

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

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 Azure resource name
Location Learn more about supported regions.
Pricing tier Learn more about supported pricing tiers.

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

To create a new intent, click on +Add button and start by giving your intent a name. You will see two options, to connect to a project or not. You can connect to (LUIS, question answering, or Conversational Language Understanding) projects, or choose the no option.

Create an orchestration workflow project

Once you have a Language resource created, create an orchestration workflow project.

  1. In Language Studio, find the section labeled Understand questions and conversational language and select Orchestration Workflow.

    A screenshot showing the location of the orchestration workflow section in the Language Studio landing page.

  2. This will bring you to the Orchestration workflow project page. Select Create new project. To create a project, you will need to provide the following details:

Value Description
Name A name for your project.
Description Optional project description.
Utterances primary language The primary language of your project. Your training data should primarily be in this language.

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

Import an orchestration workflow project

You can export an orchestration workflow project as a JSON file at any time by going to the orchestration workflow projects page, selecting a project, and from the top menu, clicking on Export.

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.

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

A screenshot showing the Conversational Language Understanding import button.

Export project

You can export an orchestration workflow project as a JSON file at any time by going to the orchestration workflow projects page, selecting a project, and pressing Export.

Get orchestration 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.

  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.

A screenshot showing how to import orchestration project.

Next Steps

Build schema