Skapa ett CLU-projekt

Använd den här artikeln om du vill lära dig hur du konfigurerar dessa krav och skapar ett projekt.

Förutsättningar

Innan du börjar använda CLU 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 CLU 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.

Skapa en ny resurs från Azure Portal

1. Logga in på Azure Portal för att skapa en ny Azure AI Language-resurs.

2. Välj Skapa en ny resurs

3. I fönstret som visas söker du efter Språktjänst

4. Välj Skapa

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

   Instansinformation	Obligatoriskt värde
   Region	En av de regioner som stöds för språkresursen.
   Name	Obligatoriskt namn för språkresursen
   Prisnivå	En av de prisnivåer som stöds för din Språkresurs.

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	Namnet på språkresursen
Plats	En region som stöds för din språkresurs.
Prisnivå	En prisnivå som stöds för din språkresurs.

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

1. Gå till Language Studio och logga in med ditt Azure-konto.

2. I fönstret Välj en språkresurs som visas letar du upp din Azure-prenumeration och väljer din Språkresurs. Om du inte har någon resurs kan du skapa en ny.

   Instansinformation	Obligatoriskt värde
   Azure-prenumeration	Din Azure-prenumeration.
   Azure-resursgrupp	Namnet på din Azure-resursgrupp.
   Azure-resursnamn	Ditt Azure-resursnamn.
   Plats	En av de regioner som stöds för språkresursen. Till exempel "USA, västra 2".
   Prisnivå	En av de giltiga prisnivåerna för språkresursen. Du kan använda nivån Kostnadsfri (F0) för att prova tjänsten.

   

Skapa ett konversationsprojekt

När du har skapat en språkresurs skapar du ett projekt för konversationsspråkstolkning.

Language Studio

1. I Language Studio hittar du avsnittet Förstå frågor och konversationsspråk och väljer Konversationsspråkförstärelse.
   

2. På så sätt kommer du till projektsidan för språktolkning för konversationer. Välj Skapa nytt projekt.

   

Om du vill skapa ett nytt projekt måste du ange följande information:

Värde	Beskrivning
Name	Ett namn på projektet. När den har skapats kan den inte ändras
beskrivning	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.
Aktivera flera språk	Om du vill att projektet ska ha stöd för flera språk samtidigt.

När du är klar väljer du Nästa och granskar informationen. Välj skapa 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ärans-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.
Content-Type	"application/merge-patch+json"

Brödtext

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

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Nyckel	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
multilingual	true	Ett booleskt värde som gör att du kan ha dokument på flera språk i datauppsättningen och när din modell distribueras kan du fråga modellen på alla språk som stöds (inte nödvändigtvis i dina träningsdokument). Mer information om flerspråkig support finns i Språkstöd .	true

Importera projekt

Language Studio

Du kan exportera ett projekt för konversationsspråktolkning som en JSON-fil när som helst genom att gå till sidan konversationsprojekt, 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 har ett befintligt LUIS-program kan du importera LUIS-programmets JSON till Conversational Language Understanding direkt, och det skapar ett konversationsprojekt med alla delar som för närvarande är tillgängliga: Avsikter, ML-entiteter och yttranden. Mer information finns i LUIS-migreringsartikeln .

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

REST API:er

Du kan importera en CLU JSON 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ärans-URL

Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena 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 och måste matcha projektnamnet i JSON-filen som du importerar.	EmailAppDemo
{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

JSON-brödtexten som du skickar liknar följande exempel. Mer information om JSON-objektet finns i referensdokumentationen .

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Nyckel	Platshållare	Värde	Exempel
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01
projectName	{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	EmailAppDemo
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
multilingual	true	Ett booleskt värde som gör att du kan ha dokument på flera språk i datauppsättningen. När din modell distribueras kan du fråga modellen på alla språk som stöds, inklusive språk som inte ingår i dina träningsdokument.	true
dataset	{DATASET}	Se hur du tränar en modell för information om hur du delar upp dina data mellan en test- och träningsuppsättning. Möjliga värden för det här fältet är Train och Test.	Train

Vid en lyckad begäran innehåller API-svaret en operation-location rubrik med en URL som du kan använda för att kontrollera status för importjobbet. Den är formaterad så här:

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

Exportera projekt

Language Studio

Du kan exportera ett Projekt för konversationsspråktolkning som en JSON-fil när som helst genom att gå till sidan konversationsprojekt, välja ett projekt och trycka på Exportera.

REST API:er

Du kan exportera ett projekt för konversationsspråkstolkning 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ärans-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 CLU-projektinformation

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 och aktivera/inaktivera flerspråkig datauppsättning i projektinställningar.

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

   

REST API:er

Om du vill hämta projektinformationen 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": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation 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ärans-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