Så här skapar du projekt i orkestreringsarbetsflödet

Med arbetsflödet för orkestrering kan du skapa projekt som ansluter dina program till:

• Custom Language Understanding (CLU)
• Frågesvar
• LUIS

Förutsättningar

Innan du börjar använda orkestreringsarbetsflödet behöver du flera saker:

• En Azure-prenumeration – Skapa en kostnadsfritt.
• En Azure AI Language-resurs

Skapa en språkresurs

Innan du börjar använda orkestreringsarbetsflödet behöver du en Azure AI Language-resurs.

Kommentar

• Du måste ha en ägarroll tilldelad till resursgruppen för att skapa en språkresurs.
• Om du planerar att använda frågesvar måste du aktivera frågesvar vid skapande av resurser

Skapa en ny resurs från Azure-portalen

1. Gå till Azure-portalen för att skapa en ny Azure AI Language-resurs.

2. Välj Fortsätt för att skapa resursen

3. Skapa en språkresurs med följande information.

   Instansinformation	Obligatoriskt värde
   Region	En av de regioner som stöds.
   Name	Ett namn på språkresursen.
   Prisnivå	En av de prisnivåer som stöds.

Skapa en ny språkresurs från Language Studio

Om det är första gången du loggar in visas ett fönster i Language Studio där du kan välja en befintlig språkresurs eller skapa en ny. Du kan också skapa en resurs genom att klicka på inställningsikonen i det övre högra hörnet, välja Resurser och sedan klicka på Skapa en ny resurs.

Skapa en språkresurs med följande information.

Instansinformation	Obligatoriskt värde
Azure-prenumeration	Din Azure-prenumeration
Azure-resursgrupp	Din Azure-resursgrupp
Azure-resursnamn	Ditt Azure-resursnamn
Plats	Läs mer om regioner som stöds.
Prisnivå	Läs mer om prisnivåer som stöds.

Viktigt!

• Se till att aktivera hanterad identitet när du skapar en språkresurs.
• Läs och bekräfta meddelande om ansvarsfull AI

Logga in på Language Studio

Om du vill skapa en ny avsikt väljer du knappen +Lägg till och börjar med att ge avsikten ett namn. Du ser två alternativ för att ansluta till ett projekt eller inte. Du kan ansluta till (LUIS, frågesvar eller Konversationsspråkförstörelse) eller välja alternativet Nej .

Skapa ett arbetsflödesprojekt för orkestrering

När du har skapat en språkresurs skapar du ett arbetsflödesprojekt för orkestrering.

Language Studio

1. I Language Studio hittar du avsnittet Förstå frågor och konversationsspråk och väljer Orchestration Workflow (Orkestreringsarbetsflöde).

   

2. Då kommer du till projektsidan för orkestreringsarbetsflödet . Välj Skapa nytt projekt. Om du vill skapa ett projekt måste du ange följande information:

Värde	Beskrivning
Namn	Ett namn på projektet.
Description	Valfri projektbeskrivning.
Primärt språk för yttranden	Projektets primära språk. Dina träningsdata bör främst vara på det här språket.

När du är klar väljer du Nästa och granskar informationen. Välj skapa projekt för att slutföra processen. Nu bör du se skärmen Skapa schema i projektet.

REST API:er

Skicka en PATCH-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att skapa ett nytt projekt.

Begäran-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena nedan med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	myProject
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01

Sidhuvuden

Använd följande rubrik för att autentisera din begäran.

Tangent	Värde
Ocp-Apim-Subscription-Key	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

Brödtext

Använd följande JSON-exempel som brödtext.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

Key	Platshållare	Värde	Exempel
projectName	{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	EmailApp
language	{LANGUAGE-CODE}	En sträng som anger språkkoden för de yttranden som används i projektet. Om projektet är ett flerspråkigt projekt väljer du språkkoden för de flesta yttrandena.	en-us

Importera ett arbetsflödesprojekt för orkestrering

Language Studio

Du kan exportera ett projekt för orkestreringsarbetsflöde som en JSON-fil när som helst genom att gå till projektsidan för orkestreringsarbetsflödet, välja ett projekt och klicka på Exportera på den översta menyn.

Projektet kan importeras på nytt som ett nytt projekt. Om du importerar ett projekt med exakt samma namn ersätter det projektets data med det nyligen importerade projektets data.

Om du vill importera ett projekt väljer du pilknappen bredvid Skapa ett nytt projekt och väljer Importera och sedan JSON-filen.

REST API:er

Du kan importera ett JSON-orkestreringsarbetsflöde till tjänsten

Skicka en POST-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att importera projektet.

Begäran-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena nedan med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	myProject
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01

Sidhuvuden

Använd följande rubrik för att autentisera din begäran.

Tangent	Värde
Ocp-Apim-Subscription-Key	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

Brödtext

Kommentar

Varje avsikt bör endast vara av en typ från (CLU, LUIS och qna)

Använd följande JSON-exempel som brödtext.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Orchestration",
    "settings": {
      "confidenceThreshold": 0
    },
    "projectName": "{PROJECT-NAME}",
    "description": "Project description",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Orchestration",
    "intents": [
      {
        "category": "string",
        "orchestration": {
          "kind": "luis",
          "luisOrchestration": {
            "appId": "00000000-0000-0000-0000-000000000000",
            "appVersion": "string",
            "slotName": "string"
          },
          "cluOrchestration": {
            "projectName": "string",
            "deploymentName": "string"
          },
          "qnaOrchestration": {
            "projectName": "string"
          }
        }
      }
    ],
    "utterances": [
      {
        "text": "Trying orchestration",
        "language": "{LANGUAGE-CODE}",
        "intent": "string"
      }
    ]
  }
}

Key	Platshållare	Värde	Exempel
api-version	{API-VERSION}	Den version av API:et som du anropar. Den version som används här måste vara samma API-version i URL:en.	2022-03-01-preview
projectName	{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	EmailApp
language	{LANGUAGE-CODE}	En sträng som anger språkkoden för de yttranden som används i projektet. Om projektet är ett flerspråkigt projekt väljer du språkkoden för de flesta yttrandena.	en-us

Exportera projekt

Language Studio

Du kan exportera ett arbetsflödesprojekt för orkestrering som en JSON-fil när som helst genom att gå till projektsidan för orkestreringsarbetsflödet, välja ett projekt och trycka på Exportera.

REST API:er

Du kan exportera ett arbetsflödesprojekt för orkestrering som en JSON-fil när som helst.

Skapa en POST-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att exportera projektet.

Begäran-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena nedan med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	EmailApp
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01

Sidhuvuden

Använd följande rubrik för att autentisera din begäran.

Tangent	Värde
Ocp-Apim-Subscription-Key	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

När du har skickat din API-begäran får du ett 202 svar som anger att det har lyckats. Extrahera värdet i svarshuvudena operation-location . Den formateras så här:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID används för att identifiera din begäran, eftersom den här åtgärden är asynkron. Använd den här URL:en för att hämta det exporterade projektets JSON med samma autentiseringsmetod.

Hämta information om orkestreringsprojekt

Language Studio

1. Gå till sidan projektinställningar i Language Studio.

2. Du kan se projektinformation.

3. På den här sidan kan du uppdatera projektbeskrivningen.

4. Du kan också hämta resursens primärnyckel från den här sidan.

   

REST API:er

Om du vill få information om ett orkestreringsarbetsflödesprojekt skickar du en GET-begäran med hjälp av följande URL och rubriker. Ersätt platshållarvärdena med dina egna värden.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	myProject
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01

Sidhuvuden

Använd följande rubrik för att autentisera din begäran.

Tangent	Värde
Ocp-Apim-Subscription-Key	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

Svarstext

När du har skickat begäran får du följande svar.

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration project.",
  "language": "{LANGUAGE-CODE}"
}

När du har skickat din API-begäran får du ett 200 svar som anger lyckad och JSON-svarstext med projektinformationen.

Ta bort projekt

Language Studio

När du inte längre behöver projektet kan du ta bort projektet med Hjälp av Language Studio. Välj Projekt i den vänstra navigeringsmenyn, välj det projekt som du vill ta bort och välj sedan Ta bort på den översta menyn.

REST API:er

När du inte längre behöver projektet kan du ta bort projektet med hjälp av API:erna.

Skapa en DELETE-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att ta bort ett projekt för förståelse av konversationsspråk.

Begäran-URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	myProject
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01

Sidhuvuden

Använd följande rubrik för att autentisera din begäran.

Tangent	Värde
Ocp-Apim-Subscription-Key	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

När du har skickat din API-begäran får du ett 202 svar som anger att projektet har slutförts, vilket innebär att projektet har tagits bort.

Nästa steg

Skapa ett schema