Zodra u tevreden bent over hoe uw model presteert, is het klaar om te worden geïmplementeerd en kunt u er query's op uitvoeren voor voorspellingen uit utterances. Het implementeren van een model maakt het beschikbaar voor gebruik via de voorspellings-API.
Controleer de modelprestaties om te bepalen hoe uw model presteert.
Zie de levenscyclus van projectontwikkeling voor meer informatie.
Model implementeren
Nadat u de prestaties van het model hebt gecontroleerd en hebt besloten dat het geschikt is voor gebruik in uw omgeving, moet u het toewijzen aan een implementatie om er query's op uit te voeren. Als u het model toewijst aan een implementatie, is het beschikbaar voor gebruik via de voorspellings-API. Het is raadzaam om een implementatie te maken met de naam production waaraan u het beste model toewijst dat u tot nu toe hebt gemaakt en deze in uw systeem te gebruiken. U kunt een andere implementatie staging maken waarmee u het model waaraan u momenteel werkt kunt toewijzen om het te testen. U kunt maximaal 10 implementaties in uw project hebben.
Selecteer Een model implementeren in het menu aan de linkerkant.
Selecteer Implementatie toevoegen om de wizard Implementatie toevoegen te starten.
Selecteer Een nieuwe implementatienaam maken om een nieuwe implementatie te maken en wijs een getraind model toe vanuit de vervolgkeuzelijst hieronder. U kunt anders een bestaande implementatienaam overschrijven selecteren om het model dat wordt gebruikt door een bestaande implementatie effectief te vervangen.
Notitie
Het overschrijven van een bestaande implementatie vereist geen wijzigingen in uw voorspellings-API-aanroep , maar de resultaten die u krijgt, zijn gebaseerd op het zojuist toegewezen model.
Selecteer een getraind model in de vervolgkeuzelijst Model .
Selecteer Implementeren om de implementatietaak te starten.
Nadat de implementatie is voltooid, wordt er een vervaldatum weergegeven naast de implementatie. Het verloop van de implementatie is wanneer uw geïmplementeerde model niet beschikbaar is om te worden gebruikt voor voorspelling. Dit gebeurt meestal twaalf maanden nadat een trainingsconfiguratie is verlopen.
Implementatietaak verzenden
Maak een PUT-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om te beginnen met het implementeren van een conversational language understanding-model.
Gebruik de volgende header om uw aanvraag te verifiëren.
Sleutel
Waarde
Ocp-Apim-Subscription-Key
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.
Aanvraagtekst
{
"trainedModelLabel": "{MODEL-NAME}",
}
Sleutel
Tijdelijke aanduiding
Waarde
voorbeeld
trainedModelLabel
{MODEL-NAME}
De modelnaam die wordt toegewezen aan uw implementatie. U kunt alleen getrainde modellen toewijzen. Deze waarde is hoofdlettergevoelig.
myModel
Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat het is gelukt. Pak de operation-location waarde uit in de antwoordheaders. Deze wordt als volgt opgemaakt:
U kunt deze URL gebruiken om de status van de implementatietaak op te halen.
Status van implementatietaak ophalen
Wanneer u een geslaagde implementatieaanvraag verzendt, wordt de volledige aanvraag-URL voor het controleren van de status van de taak (inclusief uw eindpunt, projectnaam en taak-id) opgenomen in de header van operation-location het antwoord.
Gebruik de volgende GET-aanvraag om de status van uw implementatietaak op te halen. Vervang de tijdelijke aanduidingen door uw eigen waarden.
Nadat u klaar bent met het testen van een model dat is toegewezen aan één implementatie, kunt u het toewijzen aan een andere implementatie. Het wisselen van implementaties omvat:
Het model dat is toegewezen aan de eerste implementatie en het toewijzen aan de tweede implementatie.
waarbij het model wordt toegewezen aan de tweede implementatie en dit toewijst aan de eerste implementatie.
Dit kan worden gebruikt om uw production en staging implementaties te wisselen wanneer u het model staging wilt toewijzen aan en toe te wijzen aan production.
Als u een implementatie wilt verwijderen uit Language Studio, selecteert u de pagina Model implementeren . Selecteer vervolgens de implementatie die u wilt verwijderen en selecteer Implementatie verwijderen in het bovenste menu.
Maak een DELETE-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om een implementatie van gesprekstaal te verwijderen.
Implementatiebronnen toewijzen in andere regio's in Language Studio:
Zorg ervoor dat u uzelf hebt toegewezen als Cognitive Services-taaleigenaar aan de resource die u hebt gebruikt om het project te maken.
Ga naar de pagina Een model implementeren in Language Studio.
Selecteer het tabblad Regio's .
Selecteer Implementatieresource toevoegen.
Selecteer een taalresource in een andere regio.
U bent nu klaar om uw project te implementeren in de regio's waaraan u resources hebt toegewezen.
Voor het programmatisch toewijzen van implementatiebronnen is Microsoft Entra-verificatie vereist**. Microsoft Entra-id wordt gebruikt om te bevestigen dat u toegang hebt tot de resources die u wilt toewijzen aan uw project voor implementatie in meerdere regio's. Raadpleeg de documentatie voor Verificatie van Azure AI-services om programmatisch Microsoft Entra-verificatie te gebruiken bij het maken van REST API-aanroepen.
Resource toewijzen
Dien een POST-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om implementatiebronnen toe te wijzen.
Aanvraag-URL
Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.
Het volledige resource-id-pad dat u wilt toewijzen. Gevonden in Azure Portal op het tabblad Eigenschappen voor de resource, binnen het veld Resource-id .
Het aangepaste subdomein van de resource die u wilt toewijzen. Gevonden in Azure Portal op het tabblad Sleutels en eindpunt voor de resource, onderdeel van het veld Eindpunt in de URL https://<your-custom-subdomain>.cognitiveservices.azure.com/
contosoresource
region
{REGION-CODE}
Een regiocode die de regio aangeeft van de resource die u wilt toewijzen. Gevonden in Azure Portal op het tabblad Sleutels en eindpunt voor de resource, als onderdeel van het veld Locatie/regio .
eastus
Resourcestatus toewijzen ophalen
Gebruik de volgende GET-aanvraag om de status van uw implementatieresourcetaak op te halen. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.
De naam voor uw project. Deze waarde is hoofdlettergevoelig.
myProject
{JOB-ID}
De taak-id voor het ophalen van de implementatiestatus van uw toewijzing. Dit is de operation-location headerwaarde die u van de API hebt ontvangen als reactie op uw aanvraag voor de implementatieresource.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
De versie van de API die u aanroept.
2022-10-01-preview
Headers
Gebruik de volgende header om uw aanvraag te verifiëren.
Sleutel
Waarde
Ocp-Apim-Subscription-Key
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.
Hoofdtekst van antwoord
Zodra u de aanvraag hebt verzonden, krijgt u het volgende antwoord. Blijf dit eindpunt peilen totdat de statusparameter is gewijzigd in 'geslaagd'.
Wanneer u een implementatieresource uit een project verwijdert of verwijdert, verwijdert u ook alle implementaties die zijn geïmplementeerd in de regio van die resource.
Implementatiebronnen in andere regio's intrekken of verwijderen met Behulp van Language Studio:
Ga naar het tabblad Regio's op de pagina Een model implementeren.
Selecteer de resource die u wilt intrekken.
Selecteer de knop Toewijzing verwijderen.
Typ in het venster dat wordt weergegeven de naam van de resource die u wilt verwijderen.
Resource intrekken
Dien een POST-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om implementatiebronnen uit uw project uit te schakelen of te verwijderen.
Aanvraag-URL
Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.
Gebruik de volgende GET-aanvraag om de status van uw taak voor het ongedaan maken van implementatiebronnen op te halen. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.
De naam voor uw project. Deze waarde is hoofdlettergevoelig.
myProject
{JOB-ID}
De taak-id voor het ophalen van de implementatiestatus van uw toewijzing. Dit is de operation-location headerwaarde die u van de API hebt ontvangen als reactie op de toewijzing van de resourceaanvraag voor de implementatie ongedaan maken.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
De versie van de API die u aanroept.
2022-10-01-preview
Headers
Gebruik de volgende header om uw aanvraag te verifiëren.
Sleutel
Waarde
Ocp-Apim-Subscription-Key
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.
Hoofdtekst van antwoord
Zodra u de aanvraag hebt verzonden, krijgt u het volgende antwoord. Blijf dit eindpunt peilen totdat de statusparameter is gewijzigd in 'geslaagd'.
