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.
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 .
Vyberte Přidat nasazení a spusťte novou úlohu nasazení.
Výběrem možnosti Vytvořit nové nasazení vytvořte nové nasazení a v rozevíracím seznamu níže přiřaďte natrénovaný model. Existující nasazení můžete také přepsat tak, že vyberete tuto možnost a v rozevíracím seznamu níže vyberete natrénovaný model, který k němu chcete přiřadit.
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.
Pro vlastní odpovědi na otázky nebo nepřipojené záměry se nevyžadují žádné konfigurace.
Projekty LUIS musí být publikovány do slotu nakonfigurovaného během nasazování orchestrace a vlastní databáze pro odpovědi na otázky musí být také publikovány v produkčních slotech.
Výběrem možnosti Nasadit odešlete ú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 a začněte nasazovat model pracovního postupu orchestrace.
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:
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
{JOB-ID}
ID pro vyhledání stavu trénování modelu. Toto je hodnota location hlavičky, kterou jste obdrželi z rozhraní API v reakci na požadavek na nasazení modelu.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{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 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".
Pokud chcete odstranit nasazení ze sady Language Studio, přejděte na stránku Nasazení modelu . 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".