Egyéni szövegelemzés üzembe helyezése állapotmodellhez
Cikk
Ha elégedett a modell teljesítményével, készen áll az üzembe helyezésre, és a szöveg entitásainak felismerésére használható. A modell üzembe helyezése elérhetővé teszi az előrejelzési API-val való használatra.
Miután áttekintette a modell teljesítményét, és úgy döntött, hogy használható a környezetben, hozzá kell rendelnie egy üzembe helyezéshez. A modell üzembe helyezéshez való hozzárendelése elérhetővé teszi az előrejelzési API-val való használatra. Javasoljuk, hogy hozzon létre egy éles üzembe helyezést, amelyhez az eddigi legjobb modellt rendeli hozzá, és használja a rendszerben. Létrehozhat egy másik, átmenetinek nevezett üzemelő példányt, amelyhez hozzárendelheti azt a modellt, amelyen éppen dolgozik, hogy tesztelhesse azt. A projektben legfeljebb 10 üzemelő példány lehet.
Válassza a Modell üzembe helyezése lehetőséget a bal oldali menüben.
Új üzembehelyezési feladat elindításához válassza az Üzembe helyezés hozzáadása lehetőséget.
Új üzembe helyezés létrehozásához válassza az Új üzembe helyezés létrehozása lehetőséget, és rendeljen hozzá egy betanított modellt az alábbi legördülő listából. A meglévő üzembe helyezés felülírásához válassza ezt a lehetőséget, és válassza ki azt a betanított modellt, amelyet hozzá szeretne rendelni az alábbi legördülő menüből.
Feljegyzés
A meglévő üzembe helyezés felülírásához nincs szükség az előrejelzési API-hívás módosítására, de a kapott eredmények az újonnan hozzárendelt modellen alapulnak.
Az üzembe helyezési feladat elindításához válassza az Üzembe helyezés lehetőséget.
A sikeres üzembe helyezés után mellette megjelenik egy lejárati dátum. Az üzembe helyezés lejárata az, amikor az üzembe helyezett modell nem lesz használható előrejelzéshez, ami általában tizenkét hónappal a betanítási konfiguráció lejárta után következik be.
Üzembehelyezési feladat elküldése
PUT-kérés elküldése az alábbi URL-cím, fejlécek és JSON-törzs használatával üzembehelyezési feladat elküldéséhez. Cserélje le az alábbi helyőrző értékeket a saját értékeire.
A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
myProject
{DEPLOYMENT-NAME}
Az üzembe helyezés neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
staging
{API-VERSION}
A meghívni kívánt API verziója. Az itt hivatkozott érték a legújabb kiadott verzióhoz tartozik. A modell életciklusában további információt talál a többi elérhető API-verzióról.
2022-05-01
Fejlécek
A kérés hitelesítéséhez használja az alábbi fejlécet.
Kulcs
Érték
Ocp-Apim-Subscription-Key
Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.
Kérés törzse
Használja a következő JSON-t a kérés törzsében. Használja az üzembe helyezéshez hozzárendelni kívánt modell nevét.
{
"trainedModelLabel": "{MODEL-NAME}"
}
Kulcs
Helyőrző
Érték
Példa
betanítottModelLabel
{MODEL-NAME}
Az üzembe helyezéshez hozzárendelendő modellnév. Csak sikeresen betanított modelleket rendelhet hozzá. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
myModel
Miután elküldte az API-kérést, kapni fog egy 202 választ, amely jelzi, hogy a feladat helyesen lett elküldve. A válaszfejlécekben bontsa ki az operation-location értéket. A következő módon lesz formázva:
{JOB-ID} a kérés azonosítására szolgál, mivel ez a művelet aszinkron. Ezzel az URL-címel lekérheti az üzembe helyezés állapotát.
Üzembehelyezési feladat állapotának lekérése
Az üzembehelyezési feladat állapotának lekérdezéséhez használja a következő GET kérést. Használhatja az előző lépéstől kapott URL-címet, vagy lecserélheti az alábbi helyőrző értékeket a saját értékeire.
A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
myProject
{DEPLOYMENT-NAME}
Az üzembe helyezés neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
staging
{JOB-ID}
A modell betanítási állapotának helyének azonosítója. Ez az location előző lépésben kapott fejlécértékben található.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
A meghívni kívánt API verziója. Az itt hivatkozott érték a legújabb kiadott verzióhoz tartozik. A modell életciklusában további információt talál a többi elérhető API-verzióról.
2022-05-01
Fejlécek
A kérés hitelesítéséhez használja az alábbi fejlécet.
Kulcs
É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ésekor a következő kérést kapja meg. Tartsa le a végpont lekérdezését, amíg az állapotparaméter "sikeres" értékre nem változik. A kérés sikerességét jelző kódot kell kapnia 200 .
Miután elvégezte az egyik üzembe helyezéshez hozzárendelt modell tesztelését, és ezt a modellt egy másik üzembe helyezéshez szeretné hozzárendelni, felcserélheti ezt a két üzembe helyezést. Az üzemelő példányok felcserélése magában foglalja az első üzembe helyezéshez hozzárendelt modell felvételét és a második üzembe helyezéshez való hozzárendelését. Ezután a második üzembe helyezéshez rendelt modellt veszi fel, és rendeli hozzá az első üzembe helyezéshez. Ezzel a folyamattal felcserélheti az éles és átmeneti üzemelő példányokat, ha az előkészítéshezrendelt modellt szeretné használni, és éles környezethez szeretné rendelni.
Ha törölni szeretne egy üzembe helyezést a Language Studióban, lépjen a Modell üzembe helyezése lapra. Válassza ki a törölni kívánt üzembe helyezést, és válassza a Központi telepítés törlése lehetőséget a felső menüből.
Hozzon létre egy DELETE-kérést az alábbi URL-cím, fejlécek és JSON-törzs használatával az üzembe helyezés törléséhez.
A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
myProject
{DEPLOYMENT-NAME}
Az üzembehelyezési név neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
prod
{API-VERSION}
A hívott API verziója. Az itt hivatkozott érték a legújabb kiadott verzióhoz tartozik. A modell életciklusában további információt talál a többi elérhető API-verzióról.
2022-05-01
Fejlécek
A kérés hitelesítéséhez használja az alábbi fejlécet.
Kulcs
É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 az üzembe helyezés törölve lett. A sikeres hívás eredménye a Operation-Location feladat állapotának ellenőrzésére szolgáló fejléccel.
Üzembehelyezési erőforrások hozzárendelése
A projektet több régióban is üzembe helyezheti különböző nyelvi erőforrások hozzárendelésével, amelyek különböző régiókban léteznek.
Üzembehelyezési erőforrások hozzárendelése más régiókban a Language Studióban:
Győződjön meg arról, hogy Cognitive Services-nyelvtulajdonosként hozzárendelte magát a projekt létrehozásához használt erőforráshoz.
Lépjen a Modell üzembe helyezése lapra a Language Studióban.
Válassza a Régiók lapot.
Válassza az Üzembehelyezési erőforrás hozzáadása lehetőséget.
Válasszon ki egy nyelvi erőforrást egy másik régióban.
Most már készen áll a projekt üzembe helyezésére azon régiókban, ahol erőforrásokat rendelt hozzá.
Az üzembehelyezési erőforrások programozott hozzárendeléséhez Microsoft Entra-hitelesítés szükséges. A Microsoft Entra-azonosítóval ellenőrizheti, hogy rendelkezik-e hozzáféréssel a projekthez többrégiós üzembe helyezés céljából hozzárendelni kívánt erőforrásokhoz. A Microsoft Entra-hitelesítés REST API-hívásokhoz való programozott használatához az Azure AI-szolgáltatások dokumentációjából tudhat meg többet.
Erőforrás hozzárendelése
Küldje el a POST-kérelmet az alábbi URL-cím, fejlécek és JSON-törzs használatával az üzembehelyezési erőforrások hozzárendeléséhez.
URL-cím kérése
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.
A hozzárendelni kívánt teljes erőforrás-azonosító elérési útja. Megtalálható az Azure Portalon az erőforrás Tulajdonságok lapján, az Erőforrásazonosító mezőben.
A hozzárendelni kívánt erőforrás egyéni altartománya. Az erőforrás Kulcsok és végpont lapja alatt található az Azure Portalon, az URL-cím Végpont mezőjébenhttps://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
A hozzárendelni kívánt erőforrás régióját meghatározó régiókód. Az azure portalon, az erőforrás Kulcsok és végpont lapján, a Hely/régió mezőben található.
eastus
Erőforrás-állapot hozzárendelésének lekérése
A következő GET kéréssel lekérheti az üzembehelyezési erőforrás-feladat állapotát. Cserélje le az alábbi helyőrző értékeket a saját értékeire.
A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
myProject
{JOB-ID}
A hozzárendelt üzembehelyezési állapot lekérésének feladatazonosítója. Ez abban a operation-location fejlécértékben van, amelyet az API-tól kapott a hozzárendelt üzembehelyezési erőforrás-kérésre válaszul.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
A meghívni kívánt API verziója.
2022-10-01-preview
Fejlécek
A kérés hitelesítéséhez használja az alábbi fejlécet.
Kulcs
É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. A végpont lekérdezése addig tart, amíg a status paraméter a következőre nem változik succeeded: .
Az üzembehelyezési erőforrás projektből való hozzárendelésének megszüntetésekor vagy eltávolításakor az adott erőforrás régiójában üzembe helyezett összes üzemelő példányt is törli.
Üzembehelyezési erőforrások hozzárendelésének megszüntetése vagy eltávolítása más régiókban a Language Studio használatával:
Lépjen a Modellek üzembe helyezése lap Régiók lapjára.
Válassza ki a hozzárendelni kívánt erőforrást.
Válassza a Hozzárendelés eltávolítása gombot.
A megjelenő ablakban írja be az eltávolítani kívánt erőforrás nevét.
Erőforrás hozzárendelésének megszüntetése
Küldje el a POST-kérést a következő URL-cím, fejlécek és JSON-törzs használatával, hogy eltávolítsa vagy eltávolítsa az üzembehelyezési erőforrásokat a projektből.
URL-cím kérése
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.
A következő GET kéréssel lekérheti a nem hozzárendelt üzembehelyezési erőforrások feladatának állapotát. Cserélje le az alábbi helyőrző értékeket a saját értékeire.
A projekt neve. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
myProject
{JOB-ID}
A hozzárendelt üzembehelyezési állapot lekérésének feladatazonosítója. Ez abban a operation-location fejlécértékben van, amelyet az API-tól kapott a nem hozzárendelt üzembehelyezési erőforrás-kérésre válaszul.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
A meghívni kívánt API verziója.
2022-10-01-preview
Fejlécek
A kérés hitelesítéséhez használja az alábbi fejlécet.
Kulcs
É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. Tartsa le a végpont lekérdezését, amíg az állapotparaméter "sikeres" értékre nem változik.