När du är nöjd med hur din modell fungerar är den redo att distribueras och fråga efter förutsägelser från yttranden. Om du distribuerar en modell blir den tillgänglig för användning via förutsägelse-API:et.
När du har granskat modellens prestanda och bestämt att den är lämplig att användas i din miljö måste du tilldela den till en distribution för att kunna köra frågor mot den. Genom att tilldela modellen till en distribution blir den tillgänglig för användning via förutsägelse-API:et. Vi rekommenderar att du skapar en distribution med namnet production som du tilldelar den bästa modellen som du har skapat hittills och använder den i systemet. Du kan skapa en annan distribution med namnet staging som du kan tilldela den modell som du arbetar med för att kunna testa den. Du kan ha högst 10 distributioner i projektet.
Välj Distribuera en modell från menyn till vänster.
Välj Lägg till distribution för att starta guiden Lägg till distribution .
Välj Skapa ett nytt distributionsnamn för att skapa en ny distribution och tilldela en tränad modell i listrutan nedan. Annars kan du välja Skriv över ett befintligt distributionsnamn för att effektivt ersätta den modell som används av en befintlig distribution.
Kommentar
Om du skriver över en befintlig distribution krävs inte ändringar i ditt Förutsägelse-API-anrop , men de resultat du får baseras på den nyligen tilldelade modellen.
Välj en tränad modell i listrutan Modell .
Välj Distribuera för att starta distributionsjobbet.
När distributionen har slutförts visas ett förfallodatum bredvid den. Distributionen upphör att gälla när den distribuerade modellen inte kommer att användas för förutsägelse, vilket vanligtvis sker tolv månader efter att en träningskonfiguration upphör att gälla.
Skicka distributionsjobb
Skapa en PUT-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att börja distribuera en modell för förståelse av konversationsspråk.
Använd följande rubrik för att autentisera din begäran.
Tangent
Värde
Ocp-Apim-Subscription-Key
Nyckeln till resursen. Används för att autentisera dina API-begäranden.
Begärandetext
{
"trainedModelLabel": "{MODEL-NAME}",
}
Nyckel
Platshållare
Värde
Exempel
trainedModelLabel
{MODEL-NAME}
Modellnamnet som ska tilldelas distributionen. Du kan bara tilldela modeller som tränats. Det här värdet är skiftlägeskänsligt.
myModel
När du har skickat din API-begäran får du ett 202 svar som anger att det har lyckats. Extrahera värdet i svarshuvudena operation-location . Den formateras så här:
Du kan använda den här URL:en för att hämta distributionsjobbets status.
Hämta status för distributionsjobb
När du skickar en lyckad distributionsbegäran finns den fullständiga begärande-URL:en för att kontrollera jobbets status (inklusive din slutpunkt, projektnamn och jobb-ID) i svarets operation-location huvud.
Använd följande GET-begäran för att hämta status för distributionsjobbet. Ersätt platshållarvärdena med dina egna värden.
När du har testat en modell som tilldelats en distribution kanske du vill tilldela den till en annan distribution. Vid byte av distributioner ingår:
Ta modellen som tilldelats den första distributionen och tilldela den till den andra distributionen.
tar modellen som tilldelats till den andra distributionen och tilldelar den till den första distributionen.
Detta kan användas för att växla dina production och staging distributioner när du vill ta den modell som tilldelats till staging och tilldela den till production.
Om du vill ta bort en distribution från Language Studio väljer du sidan Distribuera modell . Välj sedan den distribution som du vill ta bort och välj Ta bort distribution på den översta menyn.
Skapa en DELETE-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att ta bort en distribution av konversationsspråkstolkning.
Så här tilldelar du distributionsresurser i andra regioner i Language Studio:
Kontrollera att du har tilldelat dig själv som cognitive services-språkägare till den resurs som du använde för att skapa projektet.
Gå till sidan Distribuera en modell i Language Studio.
Välj fliken Regioner .
Välj Lägg till distributionsresurs.
Välj en språkresurs i en annan region.
Nu är du redo att distribuera projektet till de regioner där du har tilldelat resurser.
Att tilldela distributionsresurser programmässigt kräver Microsoft Entra-autentisering**. Microsoft Entra-ID används för att bekräfta att du har åtkomst till de resurser som du är intresserad av att tilldela projektet för distribution i flera regioner. Information om hur du programmatiskt använder Microsoft Entra-autentisering när du gör REST API-anrop finns i dokumentationen om Azure AI-tjänsters autentisering.
Tilldela resurs
Skicka en POST-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att tilldela distributionsresurser.
Begärans-URL
Använd följande URL när du skapar din API-begäran. Ersätt platshållarvärdena nedan med dina egna värden.
Den anpassade underdomänen för den resurs som du vill tilldela. Finns i Azure Portal under fliken Nycklar och slutpunkt för resursen, en del av fältet Slutpunkt i URL:enhttps://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
En regionkod som anger regionen för den resurs som du vill tilldela. Finns i Azure Portal under fliken Nycklar och slutpunkt för resursen som en del av fältet Plats/region.
eastus
Hämta resursstatus
Använd följande GET-begäran för att hämta statusen för distributionsresursjobbet. Ersätt platshållarvärdena nedan med dina egna värden.
Namnet på projektet. Det här värdet är skiftlägeskänsligt.
myProject
{JOB-ID}
Jobb-ID:t för att hämta distributionsstatusen för tilldelningen. Det här är i det operation-location rubrikvärde som du fick från API:et som svar på din begäran om distributionsresurs.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Den version av API:et som du anropar.
2022-10-01-preview
Sidhuvuden
Använd följande rubrik för att autentisera din begäran.
Tangent
Värde
Ocp-Apim-Subscription-Key
Nyckeln till resursen. Används för att autentisera dina API-begäranden.
Svarstext
När du har skickat begäran får du följande svar. Fortsätt att avsöka den här slutpunkten tills statusparametern ändras till "lyckades".
När du avtilldelar eller tar bort en distributionsresurs från ett projekt tar du också bort alla distributioner som har distribuerats till resursens region.
Den fullständiga resurs-ID-sökvägen som du vill ta bort tilldelningen av. Finns i Azure Portal under fliken Egenskaper för resursen som fältet Resurs-ID.
Namnet på projektet. Det här värdet är skiftlägeskänsligt.
myProject
{JOB-ID}
Jobb-ID:t för att hämta distributionsstatusen för tilldelningen. Det här är i huvudvärdet operation-location som du fick från API:et som svar på din begäran om att tilldela distributionsresursen.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Den version av API:et som du anropar.
2022-10-01-preview
Sidhuvuden
Använd följande rubrik för att autentisera din begäran.
Tangent
Värde
Ocp-Apim-Subscription-Key
Nyckeln till resursen. Används för att autentisera dina API-begäranden.
Svarstext
När du har skickat begäran får du följande svar. Fortsätt att avsöka den här slutpunkten tills statusparametern ändras till "lyckades".
