Een model implementeren en entiteiten extraheren uit tekst met behulp van de runtime-API
Artikel
Zodra u tevreden bent over hoe uw model presteert, is het klaar om te worden geïmplementeerd en gebruikt om entiteiten in tekst te herkennen. Het implementeren van een model maakt het beschikbaar voor gebruik via de voorspellings-API.
Vereisten
Een project gemaakt met een geconfigureerd Azure-opslagaccount.
Tekstgegevens die zijn geüpload naar uw opslagaccount.
Controleer de details van de modelevaluatie om te bepalen hoe uw model presteert.
Zie de levenscyclus van projectontwikkeling voor meer informatie.
Model implementeren
Nadat u de prestaties van uw model hebt gecontroleerd en hebt besloten dat het kan worden gebruikt in uw omgeving, moet u het toewijzen aan een implementatie. Als u het model toewijst aan een implementatie, is het beschikbaar voor gebruik via de voorspellings-API. Het is raadzaam om een implementatie met de naam productie te maken waaraan u het beste model toewijst dat u tot nu toe hebt gebouwd en deze in uw systeem kunt gebruiken. U kunt een andere implementatie maken met de naam fasering waaraan 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.
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
Dien een PUT-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om een implementatietaak te verzenden. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.
De naam van uw project. Deze waarde is hoofdlettergevoelig.
myProject
{DEPLOYMENT-NAME}
De naam van uw implementatie. Deze waarde is hoofdlettergevoelig.
staging
{API-VERSION}
De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.
2022-05-01
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.
Aanvraagtekst
Gebruik de volgende JSON in de hoofdtekst van uw aanvraag. Gebruik de naam van het model dat u aan de implementatie wilt toewijzen.
{
"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 de taak correct is verzonden. Pak de operation-location waarde uit in de antwoordheaders. Deze wordt als volgt opgemaakt:
{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U kunt deze URL gebruiken om de implementatiestatus op te halen.
Status van implementatietaak ophalen
Gebruik de volgende GET-aanvraag om de status van de implementatietaak op te vragen. U kunt de URL die u hebt ontvangen uit de vorige stap gebruiken of de onderstaande tijdelijke aanduidingen vervangen door uw eigen waarden.
De naam van uw project. Deze waarde is hoofdlettergevoelig.
myProject
{DEPLOYMENT-NAME}
De naam van 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 in de vorige stap hebt ontvangen.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.
2022-05-01
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'. U moet een 200 code ophalen om het succes van de aanvraag aan te geven.
Nadat u klaar bent met het testen van een model dat is toegewezen aan één implementatie en u dit model wilt toewijzen aan een andere implementatie, kunt u deze twee implementaties wisselen. Het wisselen van implementaties omvat het nemen van het model dat is toegewezen aan de eerste implementatie en het toewijzen ervan aan de tweede implementatie. Vervolgens neemt u het model dat is toegewezen aan de tweede implementatie en wijst u het toe aan de eerste implementatie. U kunt dit proces gebruiken om uw productie- en faseringsimplementaties te wisselen wanneer u het model wilt toewijzen aan fasering en deze wilt toewijzen aan productie.
Als u een implementatie vanuit Language Studio wilt verwijderen, gaat u naar de pagina Een 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 te verwijderen.
De naam voor uw project. Deze waarde is hoofdlettergevoelig.
myProject
{DEPLOYMENT-NAME}
De naam van uw implementatienaam. Deze waarde is hoofdlettergevoelig.
prod
{API-VERSION}
De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Zie de levenscyclus van het model voor meer informatie over andere beschikbare API-versies.
2022-05-01
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.
Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat uw implementatie is verwijderd. Een geslaagde aanroep met een Operation-Location header die wordt gebruikt om de status van de taak te controleren.
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. Als u programmatisch Microsoft Entra-verificatie wilt gebruiken bij het maken van REST API-aanroepen, vindt u meer informatie in de documentatie over Azure AI-services.
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 aangepaste subdomein van de resource die u wilt toewijzen. Gevonden in Azure Portal op het tabblad Sleutels en eindpunt voor de resource, als 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, in 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. Polling van dit eindpunt houden totdat de status parameter wordt gewijzigd succeededin .
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'.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
