Een back-up maken van uw gespreksmodellen voor taalkennis en deze herstellen
Wanneer u een taalresource maakt in Azure Portal, geeft u een regio op waarin deze moet worden gemaakt. Vanaf dat tijdstip vinden uw resource en alle bewerkingen met betrekking tot deze resource plaats in de opgegeven Azure-serverregio. Het is zeldzaam, maar niet onmogelijk, om een netwerkprobleem te krijgen dat een hele regio raakt. Als uw oplossing altijd beschikbaar moet zijn, moet u deze ontwerpen voor een failover naar een andere regio. Hiervoor zijn twee Azure AI-taalbronnen in verschillende regio's vereist en de mogelijkheid om uw CLU-modellen te synchroniseren tussen regio's.
Als uw app of bedrijf afhankelijk is van het gebruik van een CLU-model, raden we u aan om een replica van uw project te maken in een andere ondersteunde regio. Als er een regionale storing optreedt, hebt u vervolgens toegang tot uw model in de andere failoverregio waar u uw project hebt gerepliceerd.
Het repliceren van een project betekent dat u de metagegevens en assets van uw project exporteert en in een nieuw project importeert. Dit maakt alleen een kopie van uw projectinstellingen, intenties, entiteiten en utterances. U moet nog steeds de modellen trainen en implementeren die beschikbaar zijn voor gebruik met runtime-API's.
In dit artikel leert u hoe u de API's voor exporteren en importeren kunt gebruiken om uw project te repliceren van de ene resource naar de andere in verschillende ondersteunde geografische regio's, richtlijnen voor het synchroon houden van uw projecten en wijzigingen die nodig zijn voor uw runtime-verbruik.
Vereisten
- Twee Azure AI-taalbronnen in verschillende Azure-regio's, elk in een andere regio.
Eindpunt van uw resourcesleutels ophalen
Gebruik de volgende stappen om de sleutels en het eindpunt van uw primaire en secundaire resources op te halen. Deze worden gebruikt in de volgende stappen.
Ga naar de overzichtspagina van uw resource in Azure Portal. Selecteer sleutels en eindpunt in het menu aan de linkerkant. U gebruikt het eindpunt en de sleutel voor de API-aanvragen
Tip
Noteer sleutels en eindpunten voor zowel primaire als secundaire resources. Gebruik deze waarden om de volgende tijdelijke aanduidingen te vervangen: {PRIMARY-ENDPOINT}, {PRIMARY-RESOURCE-KEY}en {SECONDARY-RESOURCE-KEY}{SECONDARY-ENDPOINT} .
Noteer ook de projectnaam, de modelnaam en de implementatienaam. Gebruik deze waarden om de volgende tijdelijke aanduidingen te vervangen: {PROJECT-NAME}en {DEPLOYMENT-NAME}{MODEL-NAME} .
Uw primaire projectassets exporteren
Exporteer eerst de projectassets uit het project in uw primaire resource.
Exporttaak verzenden
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {PRIMARY-ENDPOINT} en {PRIMARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
Maak een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te exporteren.
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.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | EmailApp |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
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. |
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:
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
JOB-ID wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. Gebruik deze URL om de geëxporteerde project-JSON op te halen met dezelfde verificatiemethode.
Status van exporttaak ophalen
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {PRIMARY-ENDPOINT} en {PRIMARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
Gebruik de volgende GET-aanvraag om de status van uw exporttaak 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.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | myProject |
{JOB-ID} |
De id voor het zoeken naar de status van uw exporttaak. 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. | 2023-04-01 |
Kopteksten
Gebruik de volgende header om uw aanvraag te verifiëren.
| Toets | Beschrijving | Waarde |
|---|---|---|
Ocp-Apim-Subscription-Key |
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen. | {YOUR-PRIMARY-RESOURCE-KEY} |
Hoofdtekst van de reactie
{
"resultUrl": "{Endpoint}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/export/jobs/xxxxxx-xxxxx-xxxxx-xx/result?api-version={API-VERSION}",
"jobId": "xxxx-xxxxx-xxxxx-xxx",
"createdDateTime": "2022-04-18T15:23:07Z",
"lastUpdatedDateTime": "2022-04-18T15:23:08Z",
"expirationDateTime": "2022-04-25T15:23:07Z",
"status": "succeeded"
}
Gebruik de URL van de resultUrl sleutel in de hoofdtekst om de geëxporteerde assets uit deze taak weer te geven.
Exportresultaten ophalen
Dien een GET-aanvraag in met behulp van de {RESULT-URL} ontvangen van de vorige stap om de resultaten van de exporttaak weer te geven.
Kopteksten
Gebruik de volgende header om uw aanvraag te verifiëren.
| Toets | Beschrijving | Waarde |
|---|---|---|
Ocp-Apim-Subscription-Key |
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen. | {PRIMARY-RESOURCE-KEY} |
Kopieer de hoofdtekst van het antwoord zoals u deze wilt gebruiken als hoofdtekst voor de volgende importtaak.
Importeren in een nieuw project
Importeer nu de geëxporteerde projectassets in uw nieuwe project in de secundaire regio, zodat u het kunt repliceren.
Importtaak verzenden
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
Verzend een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te importeren.
Aanvraag-URL
Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de tijdelijke aanduidingen door uw eigen waarden.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig en moet overeenkomen met de projectnaam in het JSON-bestand dat u importeert. | EmailAppDemo |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
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
De JSON-hoofdtekst die u verzendt, is vergelijkbaar met het volgende voorbeeld. Raadpleeg de referentiedocumentatie voor meer informatie over het JSON-object.
{
"projectFileVersion": "{API-VERSION}",
"stringIndexType": "Utf16CodeUnit",
"metadata": {
"projectKind": "Conversation",
"settings": {
"confidenceThreshold": 0.7
},
"projectName": "{PROJECT-NAME}",
"multilingual": true,
"description": "Trying out CLU",
"language": "{LANGUAGE-CODE}"
},
"assets": {
"projectKind": "Conversation",
"intents": [
{
"category": "intent1"
},
{
"category": "intent2"
}
],
"entities": [
{
"category": "entity1"
}
],
"utterances": [
{
"text": "text1",
"dataset": "{DATASET}",
"intent": "intent1",
"entities": [
{
"category": "entity1",
"offset": 5,
"length": 5
}
]
},
{
"text": "text2",
"language": "{LANGUAGE-CODE}",
"dataset": "{DATASET}",
"intent": "intent2",
"entities": []
}
]
}
}
| Sleutel | Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|---|
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
|
projectName |
{PROJECT-NAME} |
De naam van uw project. Deze waarde is hoofdlettergevoelig. | EmailAppDemo |
language |
{LANGUAGE-CODE} |
Een tekenreeks die de taalcode opgeeft voor de uitingen die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de uitingen. | en-us |
multilingual |
true |
Een booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben. Wanneer uw model is geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal , inclusief talen die niet zijn opgenomen in uw trainingsdocumenten. | true |
dataset |
{DATASET} |
Lees hoe u een model traint voor informatie over het splitsen van uw gegevens tussen een test- en trainingsset. Mogelijke waarden voor dit veld zijn Train en Test. |
Train |
Na een geslaagde aanvraag bevat het API-antwoord een operation-location header met een URL die u kunt gebruiken om de status van de importtaak te controleren. De indeling is als volgt:
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
Status van importtaak ophalen
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
Wanneer u een geslaagde aanvraag voor het importeren van een project verzendt, wordt de volledige aanvraag-URL voor het controleren van de status van de importtaak (inclusief uw eindpunt, projectnaam en taak-id) opgenomen in de header van operation-location het antwoord.
Gebruik de volgende GET-aanvraag om een query uit te voeren op de status van uw importtaak. U kunt de URL die u hebt ontvangen uit de vorige stap gebruiken of de tijdelijke aanduidingen vervangen door uw eigen waarden.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | myProject |
{JOB-ID} |
De id voor het zoeken naar de status van uw importtaak. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
Kopteksten
Gebruik de volgende header om uw aanvraag te verifiëren.
| Toets | Beschrijving | Waarde |
|---|---|---|
Ocp-Apim-Subscription-Key |
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen. | {YOUR-PRIMARY-RESOURCE-KEY} |
Hoofdtekst van de reactie
Zodra u de aanvraag hebt verzonden, krijgt u het volgende antwoord. Blijf dit eindpunt peilen totdat de statusparameter is gewijzigd in 'geslaagd'.
{
"jobId": "xxxxx-xxxxx-xxxx-xxxxx",
"createdDateTime": "2022-04-18T15:17:20Z",
"lastUpdatedDateTime": "2022-04-18T15:17:22Z",
"expirationDateTime": "2022-04-25T15:17:20Z",
"status": "succeeded"
}
Uw model trainen
Nadat u uw project hebt geïmporteerd, hebt u alleen de assets en metagegevens en assets van het project gekopieerd. U moet uw model nog steeds trainen, wat het gebruik van uw account in rekening brengt.
Trainingstaak verzenden
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
Maak een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om een trainingstaak te verzenden.
Aanvraag-URL
Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de tijdelijke aanduidingen door uw eigen waarden.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:train?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | EmailApp |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
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. |
Aanvraagtekst
Gebruik het volgende object in uw aanvraag. Het model krijgt de naam van de waarde die u voor de parameter gebruikt zodra de modelLabel training is voltooid.
{
"modelLabel": "{MODEL-NAME}",
"trainingMode": "{TRAINING-MODE}",
"trainingConfigVersion": "{CONFIG-VERSION}",
"evaluationOptions": {
"kind": "percentage",
"testingSplitPercentage": 20,
"trainingSplitPercentage": 80
}
}
| Sleutel | Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|---|
modelLabel |
{MODEL-NAME} |
De naam van uw model. | Model1 |
trainingConfigVersion |
{CONFIG-VERSION} |
De versie van het trainingsconfiguratiemodel. Standaard wordt de nieuwste modelversie gebruikt. | 2022-05-01 |
trainingMode |
{TRAINING-MODE} |
De trainingsmodus die moet worden gebruikt voor training. Ondersteunde modi zijn Standaardtraining, snellere training, maar alleen beschikbaar voor Engels en Geavanceerde training die wordt ondersteund voor andere talen en meertalige projecten, maar omvat langere trainingstijden. Meer informatie over trainingsmodi. | standard |
kind |
percentage |
Splitsmethoden. Mogelijke waarden zijn percentage of manual. Zie hoe u een model traint voor meer informatie. |
percentage |
trainingSplitPercentage |
80 |
Percentage van uw getagde gegevens die moeten worden opgenomen in de trainingsset. Aanbevolen waarde is 80. |
80 |
testingSplitPercentage |
20 |
Percentage van uw getagde gegevens die moeten worden opgenomen in de testset. Aanbevolen waarde is 20. |
20 |
Notitie
De trainingSplitPercentage en testingSplitPercentage zijn alleen vereist als Kind deze is ingesteld percentage op en de som van beide percentages moet gelijk zijn aan 100.
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:
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
U kunt deze URL gebruiken om de status van de trainingstaak op te halen.
Trainingsstatus ophalen
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
Wanneer u een geslaagde trainingsaanvraag 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 de trainingsvoortgang van uw model op te halen. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.
Aanvraag-URL
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{YOUR-ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | EmailApp |
{JOB-ID} |
De id voor het zoeken naar de trainingsstatus van uw model. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
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'.
{
"result": {
"modelLabel": "{MODEL-LABEL}",
"trainingConfigVersion": "{TRAINING-CONFIG-VERSION}",
"trainingMode": "{TRAINING-MODE}",
"estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z",
"trainingStatus": {
"percentComplete": 3,
"startDateTime": "2022-04-18T15:45:06.8190649Z",
"status": "running"
},
"evaluationStatus": {
"percentComplete": 0,
"status": "notStarted"
}
},
"jobId": "xxxxx-xxxxx-xxxx-xxxxx-xxxx",
"createdDateTime": "2022-04-18T15:44:44Z",
"lastUpdatedDateTime": "2022-04-18T15:45:48Z",
"expirationDateTime": "2022-04-25T15:44:44Z",
"status": "running"
}
| Sleutel | Weergegeven als | Opmerking |
|---|---|---|
modelLabel |
De modelnaam | Model1 |
trainingConfigVersion |
De configuratieversie van de training. Standaard wordt de nieuwste versie gebruikt. | 2022-05-01 |
trainingMode |
De geselecteerde trainingsmodus. | standard |
startDateTime |
De tijd waarop de training is gestart | 2022-04-14T10:23:04.2598544Z |
status |
De status van de trainingstaak | running |
estimatedEndDateTime |
Geschatte tijd voor het voltooien van de trainingstaak | 2022-04-14T10:29:38.2598544Z |
jobId |
Uw trainingstaak-id | xxxxx-xxxx-xxxx-xxxx-xxxxxxxxx |
createdDateTime |
Aanmaakdatum en -tijd van trainingstaak | 2022-04-14T10:22:42Z |
lastUpdatedDateTime |
Laatst bijgewerkte datum en tijd voor trainingstaak | 2022-04-14T10:23:45Z |
expirationDateTime |
Verloopdatum en -tijd van trainingstaak | 2022-04-14T10:22:42Z |
Uw model implementeren
Dit is de stap waarin u het getrainde model beschikbaar maakt voor formulierverbruik via de voorspellings-API voor runtime.
Tip
Gebruik dezelfde implementatienaam als uw primaire project voor eenvoudiger onderhoud en minimale wijzigingen in uw systeem om uw verkeer om te leiden.
Implementatietaak verzenden
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
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.
Aanvraag-URL
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | myProject |
{DEPLOYMENT-NAME} |
De naam voor uw implementatie. Deze waarde is hoofdlettergevoelig. | staging |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
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. |
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:
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
U kunt deze URL gebruiken om de status van de implementatietaak op te halen.
De implementatiestatus ophalen
Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.
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.
Aanvraag-URL
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
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. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
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'.
{
"jobId":"{JOB-ID}",
"createdDateTime":"{CREATED-TIME}",
"lastUpdatedDateTime":"{UPDATED-TIME}",
"expirationDateTime":"{EXPIRATION-TIME}",
"status":"running"
}
Wijzigingen in het aanroepen van de runtime
In uw systeem, bij de stap waarin u runtime-API aanroept , controleert u op de antwoordcode die wordt geretourneerd door de taak-API verzenden. Als u een consistente fout ziet bij het indienen van de aanvraag, kan dit duiden op een storing in uw primaire regio. Als de fout eenmaal niet betekent dat er een storing optreedt, kan dit een tijdelijk probleem zijn. Probeer de taak opnieuw te verzenden via de secundaire resource die u hebt gemaakt. Gebruik voor de tweede aanvraag uw {YOUR-SECONDARY-ENDPOINT} en secundaire sleutel als u de bovenstaande {PROJECT-NAME} stappen hebt gevolgd en {DEPLOYMENT-NAME} hetzelfde zou zijn, zodat er geen wijzigingen nodig zijn voor de aanvraagbody.
Als u teruggaat naar het gebruik van uw secundaire resource, ziet u een lichte toename van de latentie vanwege het verschil in regio's waarin uw model wordt geïmplementeerd.
Controleren of uw projecten niet zijn gesynchroniseerd
Het behoud van de versheid van beide projecten is een belangrijk onderdeel van het proces. U moet regelmatig controleren of er updates zijn aangebracht in uw primaire project, zodat u ze naar uw secundaire project verplaatst. Op deze manier kunt u, als uw primaire regio uitvalt en u naar de secundaire regio gaat, vergelijkbare modelprestaties verwachten, omdat deze al de meest recente updates bevat. Het instellen van de frequentie van het controleren of uw projecten gesynchroniseerd zijn, is een belangrijke keuze. We raden u aan deze controle dagelijks uit te voeren om de versheid van gegevens in uw secundaire model te garanderen.
Projectdetails ophalen
Gebruik de volgende URL om de projectgegevens op te halen. Een van de sleutels die in de hoofdtekst worden geretourneerd, geeft de laatste wijzigingsdatum van het project aan. Herhaal de volgende stap twee keer, één voor uw primaire project en een ander voor uw secundaire project en vergelijk de tijdstempel die voor beide wordt geretourneerd om te controleren of ze niet zijn gesynchroniseerd.
Gebruik de volgende GET-aanvraag om uw projectgegevens op te halen. U kunt de URL die u hebt ontvangen uit de vorige stap gebruiken of de onderstaande tijdelijke aanduidingen vervangen door uw eigen waarden.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}
| Tijdelijke aanduiding | Weergegeven als | Opmerking |
|---|---|---|
{ENDPOINT} |
Het eindpunt voor het verifiëren van uw API-aanvraag. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
De naam voor uw project. Deze waarde is hoofdlettergevoelig. | myProject |
{API-VERSION} |
De versie van de API die u aanroept. | 2023-04-01 |
Kopteksten
Gebruik de volgende header om uw aanvraag te verifiëren.
| Toets | Beschrijving | Waarde |
|---|---|---|
Ocp-Apim-Subscription-Key |
De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen. | {YOUR-PRIMARY-RESOURCE-KEY} |
Hoofdtekst van de reactie
{
"createdDateTime": "2022-04-18T13:53:03Z",
"lastModifiedDateTime": "2022-04-18T13:53:03Z",
"lastTrainedDateTime": "2022-04-18T14:14:28Z",
"lastDeployedDateTime": "2022-04-18T14:49:01Z",
"projectKind": "Conversation",
"projectName": "{PROJECT-NAME}",
"multilingual": true,
"description": "This is a sample conversation project.",
"language": "{LANGUAGE-CODE}"
}
Herhaal dezelfde stappen voor uw gerepliceerde project met behulp van {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY}. Vergelijk de geretourneerde lastModifiedDateTime waarden van beide projecten. Als uw primaire project eerder is gewijzigd dan uw secundaire project, moet u de stappen herhalen voor het exporteren, importeren, trainen en implementeren van uw model.
Volgende stappen
In dit artikel hebt u geleerd hoe u de API's voor exporteren en importeren kunt gebruiken om uw project te repliceren naar een secundaire taalresource in een andere regio. Bekijk vervolgens de API-referentiedocumenten om te zien wat u nog meer kunt doen met het ontwerpen van API's.