Vytváření projektů v pracovním postupu orchestrace

Pracovní postup orchestrace umožňuje vytvářet projekty, které propojují vaše aplikace s:

• Vlastní porozumění řeči
• Odpovídání na dotazy
• LUIS

Předpoklady

Než začnete používat pracovní postup orchestrace, 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 pracovní postup orchestrace, 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ů.
• Pokud plánujete používat odpovědi na otázky, musíte povolit zodpovězení otázek při vytváření prostředků.

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

1. Přejděte na web Azure Portal a vytvořte nový prostředek jazyka Azure AI.

2. Vyberte Pokračovat a vytvořte prostředek.

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

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

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 Azure
Poloha	Přečtěte si další informace o podporovaných oblastech.
Cenová úroveň	Přečtěte si další informace o podporovaných cenových úrovních.

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

Pokud chcete vytvořit nový záměr, vyberte +Přidat tlačítko a začněte tím, že záměr pojmenujte. Zobrazí se dvě možnosti pro připojení k projektu nebo ne. Můžete se připojit k projektům (LUIS, odpovídání na otázky nebo Konverzační jazykové porozumění) nebo zvolit žádnou možnost.

Vytvoření projektu pracovního postupu orchestrace

Po vytvoření zdroje jazyka vytvořte projekt pracovního postupu orchestrace.

Language Studio

1. V sadě Language Studio vyhledejte část s popiskem Vysvětlení otázek a konverzačního jazyka a vyberte Pracovní postup orchestrace.

   

2. Tím přejdete na stránku projektu pracovního postupu Orchestraation. Vyberte Vytvořit nový projekt. Pokud chcete vytvořit projekt, budete muset zadat následující podrobnosti:

Hodnota	Popis
Name	Název projektu
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.

Až budete hotovi, vyberte Další a zkontrolujte podrobnosti. Výběrem možnosti Vytvořit projekt dokončete proces. 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.

Text

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

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

Key	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

Import projektu pracovního postupu orchestrace

Language Studio

Projekt pracovního postupu orchestrace můžete kdykoli exportovat jako soubor JSON tak, že přejdete na stránku projektů pracovního postupu orchestrace, 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 chcete importovat projekt, vyberte tlačítko se šipkou vedle možnosti Vytvořit nový projekt a vyberte Importovat a pak vyberte soubor JSON.

Rozhraní REST API

Do služby můžete importovat JSON pracovního postupu orchestrace.

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. Nahraďte níže uvedené zástupné hodnoty 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. 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

Poznámka:

Každý záměr by měl být pouze z jednoho typu (CLU, LUIS a qna).

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

{
  "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	Zástupný symbol	Hodnota	Příklad
api-version	{API-VERSION}	Verze rozhraní API, které voláte. Zde použitá verze musí být stejná verze rozhraní API v adrese URL.	2022-03-01-preview
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

Export projektu

Language Studio

Projekt pracovního postupu orchestrace můžete kdykoli exportovat jako soubor JSON tak, že přejdete na stránku projektů pracovního postupu orchestrace, vyberete projekt a stisknete Exportovat.

Rozhraní REST API

Projekt pracovního postupu orchestrace 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í o projektu orchestrace

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.

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 orchestrace pracovního postupu, 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": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration 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