CLU-projekt létrehozása

Ebből a cikkből megtudhatja, hogyan állíthatja be ezeket a követelményeket, és hogyan hozhat létre projektet.

Előfeltételek

A CLU 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 CLU 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.

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

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

2. Válassza az Új erőforrás létrehozása lehetőséget

3. A megjelenő ablakban keresse meg a Language service-t

4. Válassza a Létrehozás elemet

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

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

Ú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 Ön nyelvi erőforrásának neve
Hely	A nyelvi erőforrás támogatott régiói .
Tarifacsomag	A nyelvi erőforrás támogatott tarifacsomagjai .

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

1. Lépjen a Language Studióba , és jelentkezzen be az Azure-fiókjával.

2. A megjelenő Nyelvi erőforrás kiválasztása ablakban keresse meg az Azure-előfizetését, és válassza ki a nyelvi erőforrást. Ha nincs erőforrása, létrehozhat egy újat.

   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 neve.
   Azure-erőforrás neve	Az Azure-erőforrás neve.
   Hely	A nyelvi erőforrás egyik támogatott régiója . Például: "USA 2. nyugati régiója".
   Tarifacsomag	A nyelvi erőforrás egyik érvényes tarifacsomagja . Az ingyenes (F0) szinttel kipróbálhatja a szolgáltatást.

   

Beszélgetési projekt létrehozása

Miután létrehozott egy Nyelvi erőforrást, hozzon létre egy Beszélgetési nyelvértés projektet.

Language Studio

1. A Language Studióban keresse meg a Kérdések és a társalgási nyelv megértése című szakaszt, és válassza a Beszélgetési nyelv megértése lehetőséget.
   

2. Ekkor megjelenik a Beszélgetés nyelvének megértése projektek lapja. Válassza az Új projekt létrehozása lehetőséget.

   

Új projekt létrehozásához meg kell adnia a következő adatokat:

Érték	Description
Név	A projekt neve. A létrehozás után nem módosítható
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.
Több nyelv engedélyezése	Lehetővé szeretné-e tenni, hogy a projekt egyszerre több nyelvet is támogatjon.

Ha végzett, válassza a Tovább lehetőséget, és tekintse át a részleteket. A folyamat befejezéséhez válassza a létrehozás lehetőséget . 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.
Content-Type	'application/merge-patch+json'

Törzs

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

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

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
multilingual	true	Logikai érték, amely lehetővé teszi, hogy a dokumentumok több nyelven is szerepeljenek az adathalmazban, és a modell üzembe helyezésekor bármilyen támogatott nyelven lekérdezheti a modellt (ez nem feltétlenül szerepel a betanítási dokumentumokban). A többnyelvű támogatásról további információt a Nyelvi támogatás című témakörben talál.	true

Projekt importálása

Language Studio

A Beszélgetési nyelv megértése projektet bármikor exportálhatja JSON-fájlként, ha a beszélgetési projektek lapjára lép, kiválaszt egy projektet, majd a felső menüben az Exportálás gombra kattint.

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.

Ha már rendelkezik LUIS-alkalmazással, importálhatja a LUIS-alkalmazást közvetlenül a Beszélgetési nyelv megértése szolgáltatásba, és létrehoz egy beszélgetési projektet, amely tartalmazza a jelenleg elérhető összes elemet: szándékokat, ML-entitásokat és kimondott szövegeket. További információkért tekintse meg a LUIS migrálási cikkét .

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 LUIS vagy a Beszélgetési nyelv megértése JSON-fájlt.

REST APIs

CLU JSON-t importálhat 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 a 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, és meg kell egyeznie az importálandó JSON-fájl projektnevével.	EmailAppDemo
{API-VERSION}	A meghívni kívánt 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

Az elküldött JSON-törzs az alábbi példához hasonló. A JSON-objektummal kapcsolatos további részletekért tekintse meg a referenciadokumentációt.

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

Key	Helyőrző	Value	Példa
{API-VERSION}	A meghívni kívánt API verziója .	2023-04-01
projectName	{PROJECT-NAME}	A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.	EmailAppDemo
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
multilingual	true	Logikai érték, amely lehetővé teszi, hogy a dokumentumok több nyelven is szerepeljenek az adathalmazban. A modell üzembe helyezésekor a modellt bármilyen támogatott nyelven lekérdezheti, beleértve a betanítási dokumentumokban nem szereplő nyelveket is.	true
dataset	{DATASET}	Megtudhatja , hogyan taníthat be egy modellt az adatok tesztelési és betanítási csoportok közötti felosztásáról. A mező lehetséges értékei a következők Train : és Test.	Train

Sikeres kérés esetén az API-válasz egy operation-location url-címmel rendelkező fejlécet tartalmaz, amellyel ellenőrizheti az importálási feladat állapotát. A formátuma a következő:

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

Projekt exportálása

Language Studio

A Beszélgetési nyelv megértése projektet bármikor exportálhatja JSON-fájlként, ha a beszélgetési projektek lapjára lép, kiválaszt egy projektet, és lenyomja az Exportálás billentyűt.

REST APIs

A Conversational Language Understanding-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.

A CLU 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, és engedélyezheti/letilthatja a többnyelvű adatkészletet a projektbeállításokban.

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

   

REST APIs

A projekt adatainak lekéréséhez küldjön 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": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation 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