Vytvoření projektu CLU

V tomto článku se dozvíte, jak nastavit tyto požadavky a vytvořit projekt.

Požadavky

Než začnete používat modul CLU, budete potřebovat několik věcí:

• Předplatné Azure – Vytvořte si ho zdarma.
• Prostředek Azure AI Language

Vytvoření prostředku jazyka

Než začnete používat modul CLU, budete potřebovat prostředek Azure AI Language.

Poznámka:

• K vytvoření prostředku jazyka musíte mít přiřazenou roli vlastníka ve skupině prostředků.

Vytvoření nového prostředku z webu Azure Portal

1. Přihlaste se k webu Azure Portal a vytvořte nový prostředek jazyka Azure AI.

2. Vyberte Vytvořit nový prostředek.

3. V zobrazeném okně vyhledejte službu Jazyk.

4. Vyberte příkaz Vytvořit.

5. Vytvořte prostředek jazyka s následujícími podrobnostmi.

   Podrobnosti o instanci	Požadovaná hodnota
   Oblast	Jedna z podporovaných oblastí pro váš prostředek jazyka.
   Název	Požadovaný název prostředku jazyka
   Cenová úroveň	Jedna z podporovaných cenových úrovní pro váš prostředek jazyka.

Vytvoření nového prostředku jazyka ze sady Language Studio

Pokud se poprvé přihlásíte, zobrazí se v sadě Language Studio okno, které vám umožní zvolit existující prostředek jazyka nebo vytvořit nový. Prostředek můžete vytvořit také tak, že kliknete na ikonu nastavení v pravém horním rohu a vyberete Prostředky a potom kliknete na Vytvořit nový prostředek.

Vytvořte prostředek jazyka s následujícími podrobnostmi.

Podrobnosti o instanci	Požadovaná hodnota
Předplatné Azure	Vaše předplatné Azure.
Skupina zdrojů Azure	Vaše skupina prostředků Azure
Název prostředku Azure	Název vašeho prostředku jazyka
Umístění	Podporované oblasti pro váš prostředek jazyka.
Cenová úroveň	Podporované cenové úrovně pro váš prostředek jazyka.

Důležité

• Při vytváření prostředku jazyka nezapomeňte povolit spravovanou identitu .
• Přečtěte si a potvrďte oznámení zodpovědné umělé inteligence.

Přihlášení k sadě Language Studio

1. Přejděte do sady Language Studio a přihlaste se pomocí svého účtu Azure.

2. V okně Zvolit prostředek jazyka, které se zobrazí, vyhledejte své předplatné Azure a zvolte prostředek jazyka. Pokud prostředek nemáte, můžete vytvořit nový.

   Podrobnosti o instanci	Požadovaná hodnota
   Předplatné Azure	Vaše předplatné Azure.
   Skupina zdrojů Azure	Název vaší skupiny prostředků Azure
   Název prostředku Azure	Název vašeho prostředku Azure.
   Umístění	Jedna z podporovaných oblastí pro váš prostředek jazyka. Například "USA – západ 2".
   Cenová úroveň	Jedna z platných cenových úrovní pro váš prostředek jazyka. Službu můžete vyzkoušet pomocí úrovně Free (F0).

   

Vytvoření projektu konverzace

Jakmile máte vytvořený zdroj jazyka, vytvořte projekt Konverzační language Understanding.

Language Studio

1. V sadě Language Studio vyhledejte část s názvem Vysvětlení otázek a konverzačního jazyka a vyberte Porozumění konverzačnímu jazyku.
   

2. Tím se dostanete na stránku projektů pro porozumění konverzačnímu jazyku. Vyberte Vytvořit nový projekt.

   

Pokud chcete vytvořit nový projekt, musíte zadat následující podrobnosti:

Hodnota	Popis
Name	Název projektu Po vytvoření není možné ho změnit.
Popis	Volitelný popis projektu.
Primární jazyk promluv	Primární jazyk projektu. Vaše trénovací data by měla být primárně v tomto jazyce.
Povolení více jazyků	Jestli chcete projektu povolit podporu více jazyků najednou.

Až budete hotovi, vyberte Další a zkontrolujte podrobnosti. Proces dokončete výběrem možnosti Vytvořit . Teď byste měli vidět obrazovku Schémata sestavení v projektu.

Rozhraní REST API

Odešlete požadavek PATCH pomocí následující adresy URL, hlaviček a textu JSON k vytvoření nového projektu.

Adresa URL požadavku

Při vytváření požadavku rozhraní API použijte následující adresu URL. Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.
Content-Type	Application/merge-patch+json

Text

Jako tělo použijte následující ukázkový JSON.

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

Klíč	Zástupný symbol	Hodnota	Příklad
projectName	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	EmailApp
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka pro promluvy použité v projektu. Pokud je projekt vícejazyčný, zvolte kód jazyka většiny promluv.	en-us
multilingual	true	Logická hodnota, která umožňuje mít v datové sadě dokumenty ve více jazycích a při nasazení modelu můžete dotazovat model v libovolném podporovaném jazyce (nemusí nutně být součástí trénovacích dokumentů). Další informace o podpoře více jazyků najdete v tématu Podpora jazyků.	true

Import projektu

Language Studio

Projekt Konverzační language Understanding můžete kdykoli exportovat jako soubor JSON tak, že přejdete na stránku projektů konverzace, vyberete projekt a v horní nabídce kliknete na Exportovat.

Tento projekt je možné znovu importovat jako nový projekt. Pokud importujete projekt se stejným názvem, nahradí data projektu nově importovanými daty projektu.

Pokud máte existující aplikaci LUIS, můžete json aplikace LUIS importovat přímo do Konverzační služby Language Understanding a vytvoří projekt konverzace se všemi aktuálně dostupnými částmi: Záměry, entity ML a promluvy. Další informace najdete v článku o migraci služby LUIS.

Pokud chcete importovat projekt, vyberte tlačítko se šipkou vedle možnosti Vytvořit nový projekt a vyberte Importovat a pak vyberte soubor JSON služby LUIS nebo Konverzační language Understanding.

Rozhraní REST API

Do služby můžete importovat JSON CLU.

Odešlete požadavek POST pomocí následující adresy URL, hlaviček a textu JSON pro import projektu.

Adresa URL požadavku

Při vytváření požadavku rozhraní API použijte následující adresu URL. Zástupné hodnoty nahraďte vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. Tato hodnota se rozlišují malá a velká písmena a musí odpovídat názvu projektu v importovaném souboru JSON.	EmailAppDemo
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Text

Text JSON, který odešlete, je podobný následujícímu příkladu. Další podrobnosti o objektu JSON najdete v referenční dokumentaci .

{
  "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": []
      }
    ]
  }
}

Klíč	Zástupný symbol	Hodnota	Příklad
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01
projectName	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	EmailAppDemo
language	{LANGUAGE-CODE}	Řetězec určující kód jazyka pro promluvy použité v projektu. Pokud je projekt vícejazyčný, zvolte kód jazyka většiny promluv.	en-us
multilingual	true	Logická hodnota, která umožňuje mít v datové sadě dokumenty ve více jazycích. Po nasazení modelu můžete dotazovat model v libovolném podporovaném jazyce , včetně jazyků, které nejsou součástí trénovacích dokumentů.	true
dataset	{DATASET}	Podívejte se, jak vytrénovat model pro informace o rozdělení dat mezi testovací a trénovací sadu. Možné hodnoty pro toto pole jsou Train a Test.	Train

Po úspěšném požadavku bude odpověď rozhraní API obsahovat hlavičku operation-location s adresou URL, kterou můžete použít ke kontrole stavu úlohy importu. Formátuje se takto:

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

Export projektu

Language Studio

Projekt Konverzační funkce Language Understanding můžete kdykoli exportovat jako soubor JSON tak, že přejdete na stránku projektů konverzace, vyberete projekt a stisknete Exportovat.

Rozhraní REST API

Konverzační projekt Language Understanding můžete kdykoli exportovat jako soubor JSON.

K exportu projektu vytvořte požadavek POST pomocí následující adresy URL, hlaviček a textu JSON.

Adresa URL požadavku

Při vytváření požadavku rozhraní API použijte následující adresu URL. Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	EmailApp
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Po odeslání požadavku rozhraní API obdržíte 202 odpověď, která značí úspěch. V hlavičce odpovědi extrahujte operation-location hodnotu. Bude formátován takto:

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

JOB-ID slouží k identifikaci vašeho požadavku, protože tato operace je asynchronní. Pomocí této adresy URL získáte formát JSON exportovaného projektu pomocí stejné metody ověřování.

Získání podrobností projektu CLU

Language Studio

1. V sadě Language Studio přejděte na stránku nastavení projektu.

2. Zobrazí se podrobnosti o projektu.

3. Na této stránce můžete aktualizovat popis projektu a povolit nebo zakázat vícejazyčnou datovou sadu v nastavení projektu.

4. Primární klíč prostředku můžete načíst také z této stránky.

   

Rozhraní REST API

Pokud chcete získat podrobnosti o projektu, odešlete požadavek GET pomocí následující adresy URL a hlaviček. Zástupné hodnoty nahraďte vlastními hodnotami.

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Text odpovědi

Po odeslání požadavku se zobrazí následující odpověď.

{
  "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}"
}

Po odeslání požadavku rozhraní API obdržíte 200 odpověď s informacemi o úspěchu a textu odpovědi JSON s podrobnostmi o projektu.

Odstranit projekt

Language Studio

Pokud už projekt nepotřebujete, můžete projekt odstranit pomocí sady Language Studio. V levé navigační nabídce vyberte Projekty , vyberte projekt, který chcete odstranit, a pak v horní nabídce vyberte Odstranit .

Rozhraní REST API

Pokud už projekt nepotřebujete, můžete projekt odstranit pomocí rozhraní API.

Vytvořte požadavek DELETE pomocí následující adresy URL, hlaviček a textu JSON k odstranění projektu pro porozumění konverzačnímu jazyku.

Adresa URL požadavku

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

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Po odeslání požadavku rozhraní API obdržíte 202 odpověď s informací o úspěchu, což znamená, že projekt byl odstraněn.

Další kroky

Sestavení schématu