Jakmile budete spokojeni s tím, jak model funguje, je připravený k nasazení a dotazování na předpovědi z promluv. Nasazení modelu zpřístupňuje použití prostřednictvím rozhraní API pro predikce.
Zkontrolujte výkon modelu a zjistěte, jak model funguje.
Další informace najdete v tématu životní cyklus vývoje projektu.
Nasazení modelu
Jakmile si projdete výkon modelu a rozhodnete se, že je vhodné ho použít ve vašem prostředí, musíte ho přiřadit k nasazení, abyste ho mohli dotazovat. Přiřazení modelu k nasazení ho zpřístupní pro použití prostřednictvím rozhraní API pro predikce. Doporučuje se vytvořit nasazení s názvem production , kterému přiřadíte nejlepší model, který jste zatím vytvořili, a použít ho ve svém systému. Můžete vytvořit další volaná staging nasazení, ke kterému můžete přiřadit model, na kterém právě pracujete, abyste ho mohli otestovat. V projektu můžete mít maximálně 10 nasazení.
V nabídce na levé straně vyberte Nasazení modelu .
Výběrem možnosti Přidat nasazení spusťte Průvodce přidáním nasazení .
Výběrem možnosti Vytvořit nový název nasazení vytvořte nové nasazení a v rozevíracím seznamu níže přiřaďte natrénovaný model. Pokud chcete efektivně nahradit model používaný existujícím nasazením, můžete jinak vybrat možnost Přepsat existující název nasazení.
Poznámka:
Přepsání existujícího nasazení nevyžaduje změny volání rozhraní API pro predikce, ale výsledky, které získáte, budou založené na nově přiřazeného modelu.
V rozevíracím seznamu Model vyberte natrénovaný model.
Výběrem možnosti Nasadit spustíte úlohu nasazení.
Po úspěšném nasazení se vedle něj zobrazí datum vypršení platnosti. Vypršení platnosti nasazení je v případě, že nasazený model nebude dostupný pro predikci, což obvykle nastane dvanáct měsíců po vypršení platnosti konfigurace trénování.
Odeslání úlohy nasazení
Vytvořte požadavek PUT pomocí následující adresy URL, hlaviček a textu JSON, abyste mohli začít nasazovat konverzační model pro porozumění jazyku.
Název projektu. U této hodnoty se rozlišují malá a velká písmena.
myProject
{DEPLOYMENT-NAME}
Název nasazení. U této hodnoty se rozlišují malá a velká písmena.
staging
{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 požadavku
{
"trainedModelLabel": "{MODEL-NAME}",
}
Klíč
Zástupný symbol
Hodnota
Příklad
trainedModelLabel
{MODEL-NAME}
Název modelu, který se přiřadí k vašemu nasazení. Úspěšně natrénované modely můžete přiřadit pouze. U této hodnoty se rozlišují malá a velká písmena.
myModel
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:
Tuto adresu URL můžete použít k získání stavu úlohy nasazení.
Získání stavu úlohy nasazení
Když odešlete žádost o úspěšné nasazení, úplná adresa URL požadavku pro kontrolu stavu úlohy (včetně koncového bodu, názvu projektu a ID úlohy) je obsažena v hlavičce odpovědi operation-location .
Stav úlohy nasazení získáte pomocí následujícího požadavku GET . Zástupné hodnoty nahraďte vlastními hodnotami.
Pokud chcete odstranit nasazení ze sady Language Studio, vyberte stránku Nasadit model . Pak vyberte nasazení, které chcete odstranit, a v horní nabídce vyberte Odstranit nasazení .
Pomocí následující adresy URL, hlaviček a textu JSON vytvořte požadavek DELETE , který odstraní nasazení konverzačního jazyka understanding.
Ujistěte se, že jste se přiřadili jako vlastník jazyka Cognitive Services k prostředku, který jste použili k vytvoření projektu.
Přejděte na stránku Nasazení modelu v sadě Language Studio.
Vyberte kartu Oblasti.
Vyberte Přidat prostředek nasazení.
Vyberte prostředek jazyka v jiné oblasti.
Teď jste připraveni nasadit projekt do oblastí, ve kterých jste přiřadili zdroje.
Programové přiřazování prostředků nasazení vyžaduje ověřování Microsoft Entra**. ID Microsoft Entra se používá k potvrzení, že máte přístup k prostředkům, které vás zajímají, přiřazování k projektu pro nasazení ve více oblastech. Informace o programovém použití ověřování Microsoft Entra při volání rozhraní REST API najdete v dokumentaci k ověřování služeb Azure AI.
Přiřazení prostředku
Odešlete požadavek POST pomocí následující adresy URL, hlaviček a textu JSON pro přiřazení prostředků nasazení.
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.
Vlastní subdoména prostředku, který chcete přiřadit. Nachází se na webu Azure Portal na kartě Klíče a koncový bod pro prostředek, část pole Koncový bod v adrese URL. https://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
Kód oblasti určující oblast prostředku, který chcete přiřadit. Nachází se na webu Azure Portal na kartě Klíče a koncový bod prostředku jako součást pole Umístění/oblast .
eastus
Získání stavu přiřazení prostředku
Pomocí následujícího požadavku GET získejte stav úlohy přiřazení prostředku nasazení. Nahraďte níže uvedené zástupné hodnoty vlastními hodnotami.
Název projektu. U této hodnoty se rozlišují malá a velká písmena.
myProject
{JOB-ID}
ID úlohy pro získání stavu přiřazení nasazení. Toto je hodnota operation-location hlavičky, kterou jste získali z rozhraní API v reakci na požadavek na přiřazení prostředku nasazení.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Verze rozhraní API, které voláte.
2022-10-01-preview
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ěď. Pokračujte v dotazování na tento koncový bod, dokud se parametr stavu nezmění na "úspěch".
Název projektu. U této hodnoty se rozlišují malá a velká písmena.
myProject
{JOB-ID}
ID úlohy pro získání stavu přiřazení nasazení. Toto je hodnota operation-location hlavičky, kterou jste obdrželi z rozhraní API v reakci na vaši žádost o prostředek nasazení bez přiřazení.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Verze rozhraní API, které voláte.
2022-10-01-preview
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ěď. Pokračujte v dotazování na tento koncový bod, dokud se parametr stavu nezmění na "úspěch".