Özel metin sınıflandırma modellerinizi yedekleme ve kurtarma

Makale
12/19/2023

Dil kaynağı oluşturduğunuzda, kaynağın oluşturulacağı bölgeyi belirtirsiniz. Bundan sonra kaynağınız ve kaynağınızla ilgili tüm işlemler belirtilen Azure sunucu bölgesinde gerçekleşir. Bölgenin tamamına isabet eden bir ağ sorunuyla karşılaşmak nadirdir ancak imkansız değildir. Çözümünüzün her zaman kullanılabilir olması gerekiyorsa, bunu başka bir bölgeye yük devretmek üzere tasarlamanız gerekir. Bunun için farklı bölgelerdeki iki Azure AI Dili kaynağı ve bölgeler arasında özel modelleri eşitleme olanağı gerekir.

Uygulamanız veya işletmeniz özel bir metin sınıflandırma modelinin kullanımına bağlıysa, projenizin bir çoğaltmasını desteklenen başka bir bölgede oluşturmanızı öneririz. Böylece bölgesel bir kesinti oluşursa, modelinize projenizi çoğalttığınız diğer yük devretme bölgesinden erişebilirsiniz.

Projeyi çoğaltmak, proje meta verilerinizi ve varlıklarınızı dışarı aktarıp bunları yeni bir projeye aktardığınız anlamına gelir. Bu işlem yalnızca proje ayarlarınızın ve etiketli verilerinizin bir kopyasını oluşturur. Tahmin API'leriyle kullanılabilir olacak modelleri eğitip dağıtmanız gerekir.

Bu makalede, projenizi bir kaynaktan desteklenen farklı coğrafi bölgelerde var olan başka bir kaynağa çoğaltmak için dışarı ve içeri aktarma API'lerini kullanmayı, projelerinizi eşitlenmiş durumda tutma yönergelerini ve çalışma zamanı tüketiminize gereken değişiklikleri öğreneceksiniz.

Önkoşullar

Farklı Azure bölgelerindeki iki Azure Yapay Zeka Dili kaynağı. Bir Dil kaynağı oluşturun ve bunları bir Azure depolama hesabına bağlayın. Her iki Dil kaynağınızı da aynı depolama hesabına bağlamanız önerilir, ancak bu durum projenizi içeri aktarırken ve modeli eğitirken biraz daha yüksek gecikme süresine neden olabilir.

Kaynak anahtarlarınızın uç noktasını alma

Birincil ve ikincil kaynaklarınızın anahtarlarını ve uç noktasını almak için aşağıdaki adımları kullanın. Bunlar aşağıdaki adımlarda kullanılacaktır.

Azure portal kaynağınıza genel bakış sayfasına gidin
Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız

İpucu

Hem birincil hem de ikincil kaynaklar için anahtarları ve uç noktaları not edin. Aşağıdaki yer tutucuları değiştirmek için bu değerleri kullanın: {PRIMARY-ENDPOINT}, {PRIMARY-RESOURCE-KEY}ve {SECONDARY-ENDPOINT}{SECONDARY-RESOURCE-KEY}. Ayrıca proje adınızı, model adınızı ve dağıtım adınızı da not alın. Aşağıdaki yer tutucuları değiştirmek için bu değerleri kullanın: {PROJECT-NAME}, {MODEL-NAME} ve {DEPLOYMENT-NAME}.

Birincil proje varlıklarınızı dışarı aktarma

İlk olarak, birincil kaynağınızdaki projeden proje varlıklarını dışarı aktarın.

Dışarı aktarma işini gönder

Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {PRIMARY-RESOURCE-KEY} ile {PRIMARY-ENDPOINT} değiştirin.

Projenizi dışarı aktarmak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği oluşturun.

İstek URL’si

API isteğinizi oluştururken aşağıdaki URL'yi kullanın. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`MyProject`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son model sürümüdür .	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Gövde

tüm varlıkları dışarı aktarmak istediğinizi belirterek istek gövdesinde aşağıdaki JSON'ı kullanın.

{
  "assetsToExport": ["*"]
}

API isteğinizi gönderdikten sonra işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın operation-location . Şu şekilde biçimlendirilir:

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

{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. Dışarı aktarma işinin durumunu almak için bu URL'yi kullanacaksınız.

Dışarı aktarma işi durumunu alma

Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {PRIMARY-RESOURCE-KEY} ile {PRIMARY-ENDPOINT} değiştirin.

Proje varlıklarınızı dışarı aktarma durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.

İstek URL’si

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

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{JOB-ID}`	Modelinizin eğitim durumunu bulma kimliği. Bu, `location` önceki adımda aldığınız üst bilgi değerindedir.	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüm içindir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Yanıt gövdesi

{
  "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"
    }
  ]
}

Bu işten dışarı aktarılan varlıkları görüntülemek için gövdedeki anahtarın URL'sini resultUrl kullanın.

Dışarı aktarma sonuçlarını alma

Dışarı aktarma işinin{RESULT-URL} sonuçlarını görüntülemek için önceki adımda aldığınız get isteğini gönderin.

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Yanıt gövdesini bir sonraki içeri aktarma işinin gövdesi olarak kullanacağınız şekilde kopyalayın.

Yeni projeye aktarma

Şimdi devam edin ve ikincil bölgedeki yeni projenizde dışarı aktarılan proje varlıklarını içeri aktararak çoğaltabilirsiniz.

İçeri aktarma işini gönderme

Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.

Etiket dosyanızı içeri aktarmak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin. Etiketler dosyanızın kabul edilen biçime uygun olduğundan emin olun.

Aynı ada sahip bir proje zaten varsa, o projenin verileri değiştirilir.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Gövde

İsteğinizde aşağıdaki JSON'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

Çok etiketli sınıflandırma
Tek etiketli sınıflandırma

{
  "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"
          }
        ]
      }
    ]
  }
}

Anahtar	Yer tutucu	Değer	Örnek
api-sürümü	`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada kullanılan sürüm URL'de aynı API sürümü olmalıdır. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`
projectName	`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
projectKind	`customMultiLabelClassification`	Proje türünüz.	`customMultiLabelClassification`
language	`{LANGUAGE-CODE}`	Projenizde kullanılan belgeler için dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	`en-us`
Çok dilli	`true`	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	`true`
storageInputContainerName	`{CONTAINER-NAME}`	Belgelerinizi karşıya yüklediğiniz Azure depolama kapsayıcınızın adı.	`myContainer`
Sınıf	[]	Projede sahip olduğunuz tüm sınıfları içeren dizi. Bunlar, belgelerinizi sınıflandırmak istediğiniz sınıflardır.	[]
belgelerde	[]	Projenizdeki tüm belgeleri ve bu belge için hangi sınıfların etiketlendiğini içeren dizi.	[]
location	`{DOCUMENT-NAME}`	Belgelerin depolama kapsayıcısı içindeki konumu. Tüm belgeler kapsayıcının kökünde olduğundan, belge adı bu olmalıdır.	`doc1.txt`
Dataset	`{DATASET}`	Eğitimden önce bölündüğünde bu belgenin gideceği test kümesi. Veri bölme hakkında daha fazla bilgi için bkz. Modeli eğitme . Bu alanın olası değerleri ve `Test`şeklindedir`Train`.	`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"
                }
            }
        ]
    }
}

Anahtar	Yer tutucu	Değer	Örnek
api-sürümü	`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada kullanılan sürüm URL'de aynı API sürümü olmalıdır.	`2022-05-01`
projectName	`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
projectKind	`customSingleLabelClassification`	Proje türünüz.	`customSingleLabelClassification`
language	`{LANGUAGE-CODE}`	Projenizde kullanılan belgeler için dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. Desteklenen dil kodları hakkında daha fazla bilgi edinmek için bkz. dil desteği.	`en-us`
Çok dilli	`true`	Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında daha fazla bilgi edinmek için bkz. dil desteği.	`true`
storageInputContainerName	`{CONTAINER-NAME}`	Belgelerinizi karşıya yüklediğiniz Azure depolama kapsayıcınızın adı.	`myContainer`
Sınıf	[]	Projede sahip olduğunuz tüm sınıfları içeren dizi. Bunlar, belgelerinizi sınıflandırmak istediğiniz sınıflardır.	[]
belgelerde	[]	Projenizdeki tüm belgeleri ve bu belgenin hangi sınıfa ait olduğunu içeren dizi.	[]
location	`{DOCUMENT-NAME}`	Belgelerin depolama kapsayıcısı içindeki konumu. Tüm belgeler kapsayıcının kökünde olduğundan, belge adı bu olmalıdır.	`doc1.txt`
Dataset	`{DATASET}`	Eğitimden önce bölündüğünde bu belgenin gideceği test kümesi. Veri bölme hakkında daha fazla bilgi edinmek için bkz. Modeli eğitme . Bu alanın olası değerleri ve `Test`şeklindedir`Train`.	`Train`

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

{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. İçeri aktarma işi durumunu almak için bu URL'yi kullanacaksınız.

Bu istek için olası hata senaryoları:

Seçilen kaynağın depolama hesabı için uygun izinleri yok.
Belirtilen storageInputContainerName yok.
Geçersiz dil kodu kullanılır veya dil kodu türü dize değilse.
multilingual değeri boole değeri değil bir dizedir.

İçeri aktarma işi durumunu alma

Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.

Projenizi içeri aktarmanızın durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

İstek URL’si

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

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{JOB-ID}`	Modelinizin eğitim durumunu bulma kimliği. Bu değer, önceki adımda aldığınız üst bilgi değerindedir `location` .	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Modelinizi eğitme

Projenizi içeri aktardıktan sonra yalnızca projenin varlıklarını, meta verilerini ve varlıklarını kopyalamış olursunuz. Modelinizi eğitmeye devam etmeniz gerekir ve bu da hesabınızda kullanıma neden olur.

Eğitim işi gönderme

Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.

Bir eğitim işi göndermek için aşağıdaki URL, üst bilgiler ve JSON gövdesini kullanarak bir POST isteği gönderin. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

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

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

İstek gövdesi

İstek gövdesinde aşağıdaki JSON'yi kullanın. Eğitim tamamlandıktan sonra modele {MODEL-NAME} verilir. Yalnızca başarılı eğitim işleri model üretecektir.

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

Anahtar	Yer tutucu	Değer	Örnek
modelLabel	`{MODEL-NAME}`	Başarıyla eğitildikten sonra modelinize atanacak model adı.	`myModel`
trainingConfigVersion	`{CONFIG-VERSION}`	Bu, modeli eğitmek için kullanılacak model sürümüdür .	`2022-05-01`
evaluationOptions		Verilerinizi eğitim ve test kümelerine bölme seçeneği.	`{}`
Tür	`percentage`	Bölme yöntemleri. Olası değerler: `percentage` veya `manual`. Daha fazla bilgi için bkz. Modeli eğitma .	`percentage`
trainingSplitPercentage	`80`	Etiketli verilerinizin eğitim kümesine dahil edilecek yüzdesi. Önerilen değer şeklindedir `80`.	`80`
testingSplitPercentage	`20`	Test kümesine eklenecek etiketli verilerinizin yüzdesi. Önerilen değer şeklindedir `20`.	`20`

Not

trainingSplitPercentage ve testingSplitPercentage yalnızca olarak ayarlanırsa Kindpercentage gereklidir ve her iki yüzdenin toplamı da 100'e eşit olmalıdır.

API isteğinizi gönderdikten sonra işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın location . Şu şekilde biçimlendirilir:

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

Bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için {JOB-ID} kullanılıyor. Eğitim durumunu almak için bu URL'yi kullanabilirsiniz.

Eğitim Durumunu Alma

Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.

Modelinizin eğitim ilerleme durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

İstek URL’si

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

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{JOB-ID}`	Modelinizin eğitim durumunu bulma kimliği. Bu değer, önceki adımda aldığınız üst bilgi değerindedir `location` .	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. model yaşam döngüsü .	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Yanıt Gövdesi

İsteği gönderdikten sonra aşağıdaki yanıtı alırsınız.

{
  "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"
}

Modelinizi dağıtma

Bu, eğitilen modelinizi çalışma zamanı tahmin API'si aracılığıyla kullanılabilir form tüketimine hazır hale getirme adımıdır.

İpucu

Trafiğinizi yeniden yönlendirmeyi işlemek için sisteminizde daha kolay bakım ve en az değişiklik yapmak için birincil projenizle aynı dağıtım adını kullanın.

Dağıtım işini gönderme

Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.

Bir dağıtım işi göndermek için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PUT isteği gönderin. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{DEPLOYMENT-NAME}`	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	`staging`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

İstek gövdesi

İsteğinizin gövdesinde aşağıdaki JSON'yi kullanın. Dağıtıma atamak için modelin adını kullanın.

{
  "trainedModelLabel": "{MODEL-NAME}"
}

Anahtar	Yer tutucu	Değer	Örnek
trainedModelLabel	`{MODEL-NAME}`	Dağıtımınıza atanacak model adı. Yalnızca başarıyla eğitilmiş modeller atayabilirsiniz. Bu değer büyük/küçük harfe duyarlıdır.	`myModel`

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

Bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için {JOB-ID} kullanılıyor. Dağıtım durumunu almak için bu URL'yi kullanabilirsiniz.

Dağıtım durumunu alma

Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.

Dağıtım işinin durumunu sorgulamak için aşağıdaki GET isteğini kullanın. Önceki adımda aldığınız URL'yi kullanabilir veya aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirebilirsiniz.

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

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{DEPLOYMENT-NAME}`	Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır.	`staging`
`{JOB-ID}`	Modelinizin eğitim durumunu bulma kimliği. Bu, önceki adımda aldığınız üst bilgi değerindedir `location` .	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Yanıt Gövdesi

İsteği gönderdikten sonra aşağıdaki yanıtı alırsınız. Durum parametresi "başarılı" olarak değişene kadar bu uç noktayı yoklamayı sürdürebilirsiniz. İsteğin başarısını belirten bir 200 kod almalısınız.

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

Çalışma zamanını çağırmadaki değişiklikler

Sisteminizde, çalışma zamanı tahmin API'sini çağırdığınız adımda, gönderme görevi API'sinden döndürülen yanıt kodunu denetleyin. İsteği gönderirken tutarlı bir hata gözlemlerseniz, bu birincil bölgenizde bir kesinti olduğunu gösterebilir. Bir kez başarısız olmak kesinti anlamına gelmez, geçici bir sorun olabilir. oluşturduğunuz ikincil kaynak aracılığıyla işi göndermeyi yeniden deneyin. İkinci istek için ve komutunu kullanın {SECONDARY-ENDPOINT}{SECONDARY-RESOURCE-KEY}. Yukarıdaki {PROJECT-NAME} adımları izlediyseniz ve {DEPLOYMENT-NAME} aynı olması durumunda istek gövdesinde değişiklik yapılması gerekmez.

İkincil kaynağınızı kullanmaya geri dönmeniz durumunda, modelinizin dağıtıldığı bölgelerdeki fark nedeniyle gecikme süresinde küçük bir artış gözlemlersiniz.

Projelerinizin eşitlenmemiş olup olmadığını denetleyin

Her iki projenin de güncelliğini korumak sürecin önemli bir parçasıdır. Birincil projenizde güncelleştirme yapılıp yapılmadığını sık sık denetlemeniz gerekir, böylece bunları ikincil projenize taşıyabilirsiniz. Bu şekilde birincil bölgeniz başarısız olursa ve ikincil bölgeye geçerseniz, zaten en son güncelleştirmeleri içerdiğinden benzer model performansı bekleyebilirsiniz. Projelerinizin eşitlenip eşitlenmediğini denetleme sıklığını ayarlamak önemli bir seçimdir. İkincil modelinizdeki verilerin güncelliğini garanti etmek için bu denetimi günlük olarak yapmanızı öneririz.

Proje ayrıntılarını alma

Proje ayrıntılarınızı almak için aşağıdaki URL'yi kullanın. Gövdede döndürülen anahtarlardan biri projenin son değiştirilme tarihini gösterir. Aşağıdaki adımı biri birincil projeniz, diğeri de ikincil projeniz için olmak üzere iki kez yineleyin ve her ikisi için de döndürülen zaman damgasını karşılaştırarak bunların eşitlenmemiş olup olmadığını denetleyin.

Proje ayrıntılarınızı almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.

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

Yer tutucu	Değer	Örnek
`{ENDPOINT}`	API isteğinizin kimliğini doğrulamak için uç nokta.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır.	`myProject`
`{API-VERSION}`	Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin	`2022-05-01`

Üst Bilgiler

İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.

Anahtar	Değer
`Ocp-Apim-Subscription-Key`	Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır.

Yanıt gövdesi

    {
        "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}"
    }

API isteğinizi gönderdikten sonra, proje ayrıntılarınızla birlikte başarıyı ve JSON yanıt gövdesini belirten bir 200 yanıt alırsınız.

ve {SECONDARY-RESOURCE-KEY}kullanarak {SECONDARY-ENDPOINT} çoğaltılan projeniz için aynı adımları yineleyin. Her iki projeden döndürüleni lastModifiedDateTime karşılaştırın. Birincil projeniz ikincil projenizden daha önce değiştirildiyse, modelinizi dışarı aktarma, içeri aktarma, eğitma ve dağıtma adımlarını tekrarlamanız gerekir.

Sonraki adımlar

Bu makalede, projenizi başka bir bölgedeki ikincil bir Dil kaynağına çoğaltmak için dışarı ve içeri aktarma API'lerini kullanmayı öğrendiniz. Ardından, API'leri yazma ile başka neler yapabileceğinizi görmek için API başvuru belgelerini inceleyin.

Aracılığıyla paylaş

Özel metin sınıflandırma modellerinizi yedekleme ve kurtarma

Önkoşullar

Kaynak anahtarlarınızın uç noktasını alma

Birincil proje varlıklarınızı dışarı aktarma

Dışarı aktarma işini gönder

İstek URL’si

Üst Bilgiler

Gövde

Dışarı aktarma işi durumunu alma

İstek URL’si

Üst Bilgiler

Yanıt gövdesi

Dışarı aktarma sonuçlarını alma

Üst Bilgiler

Yeni projeye aktarma

İçeri aktarma işini gönderme

Üst Bilgiler

Gövde

İçeri aktarma işi durumunu alma

İstek URL’si

Üst Bilgiler

Modelinizi eğitme

Eğitim işi gönderme

Üst Bilgiler

İstek gövdesi

Eğitim Durumunu Alma

İstek URL’si

Üst Bilgiler

Yanıt Gövdesi

Modelinizi dağıtma

Dağıtım işini gönderme

Üst Bilgiler

İstek gövdesi

Dağıtım durumunu alma

Üst Bilgiler

Yanıt Gövdesi

Çalışma zamanını çağırmadaki değişiklikler

Projelerinizin eşitlenmemiş olup olmadığını denetleyin

Proje ayrıntılarını alma

Üst Bilgiler

Yanıt gövdesi

Sonraki adımlar

Geri Bildirim

Geri Bildirim

Ek kaynaklar