Jakmile budete spokojeni s tím, jak model funguje, je připravený k nasazení a k dotazování na předpovědi z výroků. 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ší nasazení s názvem staging, 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 zvolit možnost Přepsat existující název nasazení.
Poznámka:
Přepsání existujícího nasazení nevyžaduje změny volání Prediction API, ale výsledky, které získáte, budou založené na nově přiřazeném 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í nastane, když váš nasazený model nebude dostupný pro předvídání, což obvykle nastává dvanáct měsíců po vypršení platnosti konfigurace trénování.
Odeslat úlohu 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 vašeho nasazení. U této hodnoty se rozlišují malá a velká písmena.
staging
{API-VERSION}
Verze rozhraní API, kterou voláte.
2023-04-01
Hlavičky
K ověření požadavku použijte následující hlavičku.
Klíč
Hodnota
Ocp-Apim-Subscription-Key
Klíč k vašemu zdroji. Používá se k ověřování požadavků rozhraní API.
Tělo požadavku
{
"trainedModelLabel": "{MODEL-NAME}",
}
Klíč
Zástupný symbol
Hodnota
Příklad
označení trénovaného modelu
{MODEL-NAME}
Název modelu, který se přiřadí k vašemu nasazení. Pouze úspěšně natrénované modely můžete přiřadit. 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í.
Zkontrolovat stav ú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.
Chcete-li smazat nasazení v 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í systému rozpoznávání konverzačního jazyka.
Chcete-li přiřadit prostředky nasazení v jiných oblastech v Language Studio:
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 jazykový zdroj 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**. Microsoft Entra ID se používá k potvrzení, že máte přístup k prostředkům, které chcete mít přiřazeny k vašemu projektu pro nasazení ve více regionech. 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 v Azure Portal na kartě Klíče a koncový bod pro prostředek, část pole Koncový bod v 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 obdrželi z API v odpovědi na váš 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.
Klíč
Hodnota
Ocp-Apim-Subscription-Key
Klíč k vašemu zdroji. Používá se k ověřování požadavků rozhraní API.
Tělo 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 zjištění stavu přiřazeného nasazení. Toto je hodnota operation-location hlavičky, kterou jste obdrželi z rozhraní API v reakci na vaši žádost o zrušení přiřazení nasazovacího prostředku.
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.
Klíč
Hodnota
Ocp-Apim-Subscription-Key
Klíč k vašemu zdroji. Používá se k ověřování požadavků rozhraní API.
Tělo 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".