Projektek létrehozása vezénylési munkafolyamatban.

A vezénylési munkafolyamat lehetővé teszi olyan projektek létrehozását, amelyek az alkalmazásokat a következőhöz kötik:

• Egyéni nyelvfelismerés
• Kérdésmegválaszolás
• LUIS

Előfeltételek

A vezénylési munkafolyamat használatának megkezdése előtt több dologra is szüksége lesz:

• Azure-előfizetés – Hozzon létre egyet ingyenesen.
• Azure AI-nyelvi erőforrás

Nyelvi erőforrás létrehozása

A vezénylési munkafolyamat használatának megkezdése előtt szüksége lesz egy Azure AI Language-erőforrásra.

Megjegyzés:

• Egy nyelvi erőforrás létrehozásához tulajdonosi szerepkörrel kell rendelkeznie az erőforráscsoporthoz.
• Ha kérdések megválaszolását tervezi, engedélyeznie kell a kérdések megválaszolását az erőforrás-létrehozás során

Új erőforrás létrehozása az Azure Portalról

1. Lépjen az Azure Portalra egy új Azure AI-nyelvi erőforrás létrehozásához.

2. Válassza a Folytatás lehetőséget az erőforrás létrehozásához

3. Hozzon létre egy nyelvi erőforrást a következő részletekkel.

   Példány részletei	Kötelező érték
   Régió	Az egyik támogatott régió.
   Name	A nyelvi erőforrás neve.
   Tarifacsomag	Az egyik támogatott tarifacsomag.

Új nyelvi erőforrás létrehozása a Language Studióból

Ha először jelentkezik be, megjelenik egy ablak a Language Studióban, amellyel kiválaszthat egy meglévő nyelvi erőforrást, vagy létrehozhat egy újat. Az erőforrásokat úgy is létrehozhatja, hogy a jobb felső sarokban a Beállítások ikonra kattint, az Erőforrások gombra kattint, majd az Új erőforrás létrehozása parancsra kattint.

Hozzon létre egy nyelvi erőforrást a következő részletekkel.

Példány részletei	Kötelező érték
Azure subscription	Az Azure-előfizetése
Azure-erőforráscsoport	Az Azure-erőforráscsoport
Azure-erőforrás neve	Az Azure-erőforrás neve
Hely	További információ a támogatott régiókról.
Tarifacsomag	További információ a támogatott tarifacsomagokról.

Fontos

• Nyelvi erőforrás létrehozásakor mindenképpen engedélyezze a felügyelt identitást .
• A felelős AI-értesítés elolvasása és megerősítése

Bejelentkezés a Language Studióba

Új szándék létrehozásához válassza a +Hozzáadás gombot, és kezdje azzal, hogy nevet ad a szándéknak. Két lehetőség közül választhat, ha csatlakozni szeretne egy projekthez, vagy sem. Csatlakozhat (LUIS, kérdés megválaszolása vagy beszélgetési nyelv megértése) projektekhez, vagy választhatja a nincs lehetőséget.

Vezénylési munkafolyamat-projekt létrehozása

Miután létrehozott egy nyelvi erőforrást, hozzon létre egy vezénylési munkafolyamat-projektet.

Language Studio

1. A Language Studióban keresse meg a Kérdések és a beszélgetés nyelve című szakaszt, és válassza az Orchestration Workflow (Vezénylési munkafolyamat) lehetőséget.

   

2. Ekkor megjelenik az Orchestration munkafolyamat projektoldala . Válassza az Új projekt létrehozása lehetőséget. Projekt létrehozásához a következő adatokat kell megadnia:

Érték	Description
Név	A projekt neve.
Leírás	Választható projektleírás.
Kimondott szövegek elsődleges nyelve	A projekt elsődleges nyelve. A betanítási adatoknak elsősorban ezen a nyelven kell lenniük.

Ha végzett, válassza a Tovább lehetőséget, és tekintse át a részleteket. Válassza a projekt létrehozása lehetőséget a folyamat befejezéséhez. Ekkor megjelenik a Séma összeállítása képernyő a projektben.

REST APIs

Küldjön egy PATCH-kérelmet az alábbi URL-cím, fejlécek és JSON-törzs használatával egy új projekt létrehozásához.

Kérelem URL-címe

Az API-kérés létrehozásakor használja az alábbi URL-címet. Cserélje le az alábbi helyőrző értékeket a saját értékeire.

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

Helyőrző	Value	Példa
{ENDPOINT}	Az API-kérés hitelesítésének végpontja.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	myProject
{API-VERSION}	A hívott API verziója .	2023-04-01

Fejlécek

A kérés hitelesítéséhez használja az alábbi fejlécet.

Key	Érték
Ocp-Apim-Subscription-Key	Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.

Törzs

Használja a következő JSON-mintát testként.

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

Key	Helyőrző	Value	Példa
projectName	{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	EmailApp
language	{LANGUAGE-CODE}	A projektben használt kimondott szövegek nyelvi kódját meghatározó sztring. Ha a projekt többnyelvű projekt, válassza ki a kimondott szövegek többségének nyelvi kódját .	en-us

Vezénylési munkafolyamat-projekt importálása

Language Studio

A vezénylési munkafolyamat-projekteket bármikor exportálhatja JSON-fájlként. Ehhez nyissa meg a vezénylési munkafolyamat-projektek oldalát, válasszon ki egy projektet, majd a felső menüben kattintson az Exportálás gombra.

Ez a projekt új projektként újraimportálható. Ha pontosan ugyanazzal a névvel importál egy projektet, az lecseréli a projekt adatait az újonnan importált projekt adataira.

Projekt importálásához válassza az Új projekt létrehozása gomb melletti nyílgombot, majd az Importálás lehetőséget, majd a JSON-fájlt.

REST APIs

A vezénylési munkafolyamat JSON-fájljának importálása a szolgáltatásba

Küldjön post kérelmet a projekt importálásához az alábbi URL-cím, fejlécek és JSON-törzs használatával.

Kérelem URL-címe

Az API-kérés létrehozásakor használja az alábbi URL-címet. Cserélje le az alábbi helyőrző értékeket a saját értékeire.

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

Helyőrző	Value	Példa
{ENDPOINT}	Az API-kérés hitelesítésének végpontja.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	myProject
{API-VERSION}	A hívott API verziója .	2023-04-01

Fejlécek

A kérés hitelesítéséhez használja az alábbi fejlécet.

Key	Érték
Ocp-Apim-Subscription-Key	Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.

Törzs

Megjegyzés:

Minden szándéknak csak egy típusúnak kell lennie (CLU, LUIS és qna)

Használja a következő JSON-mintát testként.

{
  "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	Helyőrző	Value	Példa
api-version	{API-VERSION}	A hívott API verziója. Az itt használt verziónak meg kell egyeznie az URL-cím API-verziójával.	2022-03-01-preview
projectName	{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	EmailApp
language	{LANGUAGE-CODE}	A projektben használt kimondott szövegek nyelvi kódját meghatározó sztring. Ha a projekt többnyelvű projekt, válassza ki a kimondott szövegek többségének nyelvi kódját .	en-us

Projekt exportálása

Language Studio

A vezénylési munkafolyamat-projekteket bármikor exportálhatja JSON-fájlként, ha a vezénylési munkafolyamat-projektek lapjára lép, kiválaszt egy projektet, és lenyomja az Exportálás billentyűt.

REST APIs

A vezénylési munkafolyamat-projekteket bármikor exportálhatja JSON-fájlként.

Hozzon létre egy POST-kérést a következő URL-cím, fejlécek és JSON-törzs használatával a projekt exportálásához.

Kérelem URL-címe

Az API-kérés létrehozásakor használja az alábbi URL-címet. Cserélje le az alábbi helyőrző értékeket a saját értékeire.

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

Helyőrző	Value	Példa
{ENDPOINT}	Az API-kérés hitelesítésének végpontja.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	EmailApp
{API-VERSION}	A hívott API verziója .	2023-04-01

Fejlécek

A kérés hitelesítéséhez használja az alábbi fejlécet.

Key	Érték
Ocp-Apim-Subscription-Key	Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.

Az API-kérés elküldése után egy 202 sikeres választ kap. A válaszfejlécekben bontsa ki az operation-location értéket. A következő módon lesz formázva:

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

JOB-ID a kérés azonosítására szolgál, mivel ez a művelet aszinkron. Ezzel az URL-címvel lekérheti az exportált projekt JSON-t ugyanazzal a hitelesítési módszerrel.

Vezénylési projekt részleteinek lekérése

Language Studio

1. Lépjen a projektbeállítások lapjára a Language Studióban.

2. A projekt részletei láthatók.

3. Ezen a lapon frissítheti a projekt leírását.

4. Az erőforrás elsődleges kulcsát ezen a lapon is lekérheti.

   

REST APIs

A vezénylési munkafolyamat-projekt részleteinek lekéréséhez küldjön egy GET kérést az alábbi URL-címmel és fejlécekkel. Cserélje le a helyőrző értékeket a saját értékeire.

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

Helyőrző	Value	Példa
{ENDPOINT}	Az API-kérés hitelesítésének végpontja.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	myProject
{API-VERSION}	A hívott API verziója .	2023-04-01

Fejlécek

A kérés hitelesítéséhez használja az alábbi fejlécet.

Key	Érték
Ocp-Apim-Subscription-Key	Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.

Válasz törzse

A kérés elküldése után a következő választ kapja.

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

Az API-kérés elküldése után a projekt adataival egy 200 sikeres és JSON-válasz törzset jelző választ kap.

Projekt törlése

Language Studio

Ha már nincs szüksége a projektre, törölheti a projektet a Language Studióval. Válassza a Bal oldali navigációs menü Projektek elemét, jelölje ki a törölni kívánt projektet, majd a felső menüBől válassza a Törlés lehetőséget.

REST APIs

Ha már nincs szüksége a projektre, az API-k használatával törölheti a projektet.

Hozzon létre egy DELETE kérést a következő URL-cím, fejlécek és JSON-törzs használatával egy beszélgetési nyelvértelmező projekt törléséhez.

Kérelem URL-címe

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

Helyőrző	Value	Példa
{ENDPOINT}	Az API-kérés hitelesítésének végpontja.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	myProject
{API-VERSION}	A hívott API verziója .	2023-04-01

Fejlécek

A kérés hitelesítéséhez használja az alábbi fejlécet.

Key	Érték
Ocp-Apim-Subscription-Key	Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.

Az API-kérés elküldése után egy 202 sikeres választ kap, ami azt jelenti, hogy a projekt törölve lett.

Következő lépések

Séma létrehozása