Een back-up maken van uw aangepaste modellen voor tekstclassificatie en deze herstellen

Artikel
10/16/2024

Wanneer u een taalresource maakt, 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-taalresources in verschillende regio's vereist en de mogelijkheid om aangepaste modellen in verschillende regio's te synchroniseren.

Als uw app of bedrijf afhankelijk is van het gebruik van een aangepast tekstclassificatiemodel, 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 en getagde gegevens. U moet nog steeds de modellen trainen en implementeren die beschikbaar zijn voor gebruik met voorspellings-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. Maak een taalresource en verbind deze met een Azure-opslagaccount. Het is raadzaam om beide taalbronnen te verbinden met hetzelfde opslagaccount, maar dit kan iets hogere latentie veroorzaken bij het importeren van uw project en het trainen van een model.

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-text/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.	`MyProject`
`{API-VERSION}`	De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is de nieuwste modelversie die is uitgebracht.	`2022-05-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

Gebruik de volgende JSON in de aanvraagbody die aangeeft dat u alle assets wilt exporteren.

{
  "assetsToExport": ["*"]
}

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:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U gebruikt deze URL om de status van de exporttaak op te halen.

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 het exporteren van uw projectassets op te halen. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

Aanvraag-URL

{ENDPOINT}/language/authoring/analyze-text/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 van uw project. Deze waarde is hoofdlettergevoelig.	`myProject`
`{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. Meer informatie over andere beschikbare API-versies	`2022-05-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 de reactie

{
  "resultUrl": "{RESULT-URL}",
  "jobId": "string",
  "createdDateTime": "2021-10-19T23:24:41.572Z",
  "lastUpdatedDateTime": "2021-10-19T23:24:41.572Z",
  "expirationDateTime": "2021-10-19T23:24:41.572Z",
  "status": "unknown",
  "errors": [
    {
      "code": "unknown",
      "message": "string"
    }
  ]
}

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.

Sleutel	Weergegeven als
`Ocp-Apim-Subscription-Key`	De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

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 het labelbestand te importeren. Zorg ervoor dat het labelsbestand de geaccepteerde indeling volgt.

Als er al een project met dezelfde naam bestaat, worden de gegevens van dat project vervangen.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/: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.	`myProject`
`{API-VERSION}`	De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Meer informatie over andere beschikbare API-versies	`2022-05-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

Gebruik de volgende JSON in uw aanvraag. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

Classificatie met meerdere labels
Classificatie van één label

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customMultiLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customMultiLabelClassification",
    "classes": [
      {
        "category": "Class1"
      },
      {
        "category": "Class2"
      }
    ],
    "documents": [
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class1"
          },
          {
            "category": "Class2"
          }
        ]
      },
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class2"
          }
        ]
      }
    ]
  }
}

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
api-versie	`{API-VERSION}`	De versie van de API die u aanroept. De versie die hier wordt gebruikt, moet dezelfde API-versie in de URL zijn. Meer informatie over andere beschikbare API-versies	`2022-05-01`
projectNaam	`{PROJECT-NAME}`	De naam van uw project. Deze waarde is hoofdlettergevoelig.	`myProject`
projectKind	`customMultiLabelClassification`	Uw projecttype.	`customMultiLabelClassification`
language	`{LANGUAGE-CODE}`	Een tekenreeks die de taalcode opgeeft voor de documenten die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de documenten. Zie taalondersteuning voor meer informatie over meertalige ondersteuning.	`en-us`
meertalig	`true`	Een booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben en wanneer uw model wordt geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal (niet noodzakelijkerwijs opgenomen in uw trainingsdocumenten). Zie taalondersteuning voor meer informatie over meertalige ondersteuning.	`true`
storageInputContainerName	`{CONTAINER-NAME}`	De naam van uw Azure Storage-container waar u uw documenten hebt geüpload.	`myContainer`
klassen	[]	Matrix met alle klassen die u in het project hebt. Dit zijn de klassen waarnaar u uw documenten wilt classificeren.	[]
documents	[]	Matrix met alle documenten in uw project en wat de klassen zijn gelabeld voor dit document.	[]
locatie	`{DOCUMENT-NAME}`	De locatie van de documenten in de opslagcontainer. Omdat alle documenten zich in de hoofdmap van de container bevinden, moet dit de naam van het document zijn.	`doc1.txt`
gegevensset	`{DATASET}`	De testset waarnaar dit document gaat wanneer het wordt gesplitst vóór de training. Zie Hoe u een model traint voor meer informatie over het splitsen van gegevens. Mogelijke waarden voor dit veld zijn `Train` en `Test`.	`Train`

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customSingleLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customSingleLabelClassification",
        "classes": [
            {
                "category": "Class1"
            },
            {
                "category": "Class2"
            }
        ],
        "documents": [
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "class": {
                    "category": "Class2"
                }
            },
            {
                "location": "{DOCUMENT-NAME}",
                "language": "{LANGUAGE-CODE}",
                "dataset": "{DATASET}",
                "class": {
                    "category": "Class1"
                }
            }
        ]
    }
}

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
api-versie	`{API-VERSION}`	De versie van de API die u aanroept. De versie die hier wordt gebruikt, moet dezelfde API-versie in de URL zijn.	`2022-05-01`
projectNaam	`{PROJECT-NAME}`	De naam van uw project. Deze waarde is hoofdlettergevoelig.	`myProject`
projectKind	`customSingleLabelClassification`	Uw projecttype.	`customSingleLabelClassification`
language	`{LANGUAGE-CODE}`	Een tekenreeks die de taalcode opgeeft voor de documenten die in uw project worden gebruikt. Als uw project een meertalige project is, kiest u de taalcode van het merendeel van de documenten. Zie taalondersteuning voor meer informatie over ondersteunde taalcodes.	`en-us`
meertalig	`true`	Een booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben en wanneer uw model wordt geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal (niet noodzakelijkerwijs opgenomen in uw trainingsdocumenten). Zie taalondersteuning voor meer informatie over meertalige ondersteuning.	`true`
storageInputContainerName	`{CONTAINER-NAME}`	De naam van uw Azure Storage-container waar u uw documenten hebt geüpload.	`myContainer`
klassen	[]	Matrix met alle klassen die u in het project hebt. Dit zijn de klassen waarnaar u uw documenten wilt classificeren.	[]
documents	[]	Matrix met alle documenten in uw project en tot welke klasse dit document behoort.	[]
locatie	`{DOCUMENT-NAME}`	De locatie van de documenten in de opslagcontainer. Omdat alle documenten zich in de hoofdmap van de container bevinden, moet dit de naam van het document zijn.	`doc1.txt`
gegevensset	`{DATASET}`	De testset waarnaar dit document gaat wanneer het wordt gesplitst vóór de training. Zie Hoe u een model traint voor meer informatie over het splitsen van gegevens. Mogelijke waarden voor dit veld zijn `Train` en `Test`.	`Train`

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U gebruikt deze URL om de status van de importtaak op te halen.

Mogelijke foutscenario's voor deze aanvraag:

De geselecteerde resource beschikt niet over de juiste machtigingen voor het opslagaccount.
De storageInputContainerName opgegeven bestaat niet.
Ongeldige taalcode wordt gebruikt of als het taalcodetype geen tekenreeks is.
multilingual waarde is een tekenreeks en geen booleaanse waarde.

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.

Gebruik de volgende GET-aanvraag om de status van het importeren van uw project op te halen. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

Aanvraag-URL

{ENDPOINT}/language/authoring/analyze-text/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 van uw project. Deze waarde is hoofdlettergevoelig.	`myProject`
`{JOB-ID}`	De id voor het zoeken naar de trainingsstatus van uw model. Deze waarde bevindt zich in 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. Meer informatie over andere beschikbare API-versies	`2022-05-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.

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.

Dien een POST-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om een trainingstaak te verzenden. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-text/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 van uw project. Deze waarde is hoofdlettergevoelig.	`myProject`
`{API-VERSION}`	De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Meer informatie over andere beschikbare API-versies	`2022-05-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 de volgende JSON in de hoofdtekst van uw aanvraag. Het model krijgt het model zodra de {MODEL-NAME} training is voltooid. Alleen succesvolle trainingstaken produceren modellen.

{
	"modelLabel": "{MODEL-NAME}",
	"trainingConfigVersion": "{CONFIG-VERSION}",
	"evaluationOptions": {
		"kind": "percentage",
		"trainingSplitPercentage": 80,
		"testingSplitPercentage": 20
	}
}

Sleutel	Tijdelijke aanduiding	Weergegeven als	Opmerking
modelLabel	`{MODEL-NAME}`	De modelnaam die aan uw model wordt toegewezen zodra deze is getraind.	`myModel`
trainingConfigVersion	`{CONFIG-VERSION}`	Dit is de modelversie die wordt gebruikt om het model te trainen.	`2022-05-01`
evaluationOptions		Optie voor het splitsen van uw gegevens in trainings- en testsets.	`{}`
soort	`percentage`	Splitsmethoden. Mogelijke waarden zijn `percentage` en `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 de taak correct is verzonden. Pak de location waarde uit in de antwoordheaders. Deze wordt als volgt opgemaakt:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U kunt deze URL gebruiken om de trainingsstatus 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.

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-text/projects/{PROJECT-NAME}/train/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 van uw project. Deze waarde is hoofdlettergevoelig.	`myProject`
`{JOB-ID}`	De id voor het zoeken naar de trainingsstatus van uw model. Deze waarde bevindt zich in 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`

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.

{
  "result": {
    "modelLabel": "{MODEL-NAME}",
    "trainingConfigVersion": "{CONFIG-VERSION}",
    "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": "{JOB-ID}",
  "createdDateTime": "2022-04-18T15:44:44Z",
  "lastUpdatedDateTime": "2022-04-18T15:45:48Z",
  "expirationDateTime": "2022-04-25T15:44:44Z",
  "status": "running"
}

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.

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.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?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 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. Meer informatie over andere beschikbare API-versies	`2022-05-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 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	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`

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

{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.

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.

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.

{ENDPOINT}/language/authoring/analyze-text/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 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. Meer informatie over andere beschikbare API-versies	`2022-05-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'. U moet een 200 code ophalen om het succes van de aanvraag aan te geven.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Wijzigingen in het aanroepen van de runtime

In uw systeem controleert u in de stap waarin u de voorspellings-API voor runtime aanroept 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 {SECONDARY-ENDPOINT} en{SECONDARY-RESOURCE-KEY}, als u de bovenstaande stappen hebt gevolgd en {DEPLOYMENT-NAME} {PROJECT-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. Vervang de waarden van de tijdelijke aanduiding hieronder door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-text/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. De waarde waarnaar hier wordt verwezen, is voor de nieuwste versie die is uitgebracht. Meer informatie over andere beschikbare API-versies	`2022-05-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 de reactie

    {
        "createdDateTime": "2021-10-19T23:24:41.572Z",
        "lastModifiedDateTime": "2021-10-19T23:24:41.572Z",
        "lastTrainedDateTime": "2021-10-19T23:24:41.572Z",
        "lastDeployedDateTime": "2021-10-19T23:24:41.572Z",
        "projectKind": "customMultiLabelClassification",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 200 antwoord dat aangeeft dat de aanvraag is geslaagd en de hoofdtekst van het JSON-antwoord met de projectgegevens.

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.

Delen via

Een back-up maken van uw aangepaste modellen voor tekstclassificatie en deze herstellen

Vereisten

Eindpunt van uw resourcesleutels ophalen

Uw primaire projectassets exporteren

Exporttaak verzenden

Aanvraag-URL

Kopteksten

Hoofdtekst

Status van exporttaak ophalen

Aanvraag-URL

Kopteksten

Hoofdtekst van de reactie

Exportresultaten ophalen

Kopteksten

Importeren in een nieuw project

Importtaak verzenden

Kopteksten

Hoofdtekst

Status van importtaak ophalen

Aanvraag-URL

Kopteksten

Uw model trainen

Trainingstaak verzenden

Kopteksten

Aanvraagtekst

Trainingsstatus ophalen

Aanvraag-URL

Kopteksten

Hoofdtekst van antwoord

Uw model implementeren

Implementatietaak verzenden

Kopteksten

Aanvraagtekst

De implementatiestatus ophalen

Kopteksten

Hoofdtekst van antwoord

Wijzigingen in het aanroepen van de runtime

Controleren of uw projecten niet zijn gesynchroniseerd

Projectdetails ophalen

Kopteksten

Hoofdtekst van de reactie

Volgende stappen

Feedback

Aanvullende resources