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.
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 een nieuwe implementatietaak te starten.
Selecteer Nieuwe implementatie maken om een nieuwe implementatie te maken en wijs een getraind model toe vanuit de vervolgkeuzelijst hieronder. U kunt een bestaande implementatie ook overschrijven door deze optie te selecteren en het getrainde model te selecteren dat u eraan wilt toewijzen in de vervolgkeuzelijst hieronder.
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.
Er zijn geen configuraties vereist voor aangepaste vraagantwoorden of niet-gekoppelde intenties.
LUIS-projecten moeten worden gepubliceerd naar de site die is geconfigureerd tijdens de orchestration-implementatie en aangepaste vragen die KBs beantwoorden, moeten ook worden gepubliceerd naar hun productiesites.
Selecteer Implementeren om uw implementatietaak te verzenden
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 een indelingswerkstroommodel te implementeren.
Gebruik de volgende header om uw aanvraag te verifiëren.
Sleutel
Weergegeven als
Ocp-Apim-Subscription-Key
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.
Aanvraagbody
{
"trainedModelLabel": "{MODEL-NAME}",
}
Sleutel
Tijdelijke aanduiding
Weergegeven als
Opmerking
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
Gebruik de volgende GET-aanvraag om de status van uw implementatietaak 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
{DEPLOYMENT-NAME}
De naam voor uw implementatie. Deze waarde is hoofdlettergevoelig.
staging
{JOB-ID}
De id voor het zoeken naar de trainingsstatus van uw model. Dit is de location headerwaarde die u van de API hebt ontvangen als reactie op uw aanvraag voor modelimplementatie.
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 vanuit Language Studio wilt verwijderen, gaat u naar de pagina Model implementeren . Selecteer 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
Kopteksten
Gebruik de volgende header om uw aanvraag te verifiëren.
Sleutel
Weergegeven als
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
Kopteksten
Gebruik de volgende header om uw aanvraag te verifiëren.
Sleutel
Weergegeven als
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'.
