Konuşma dilini anlama modellerinizi yedekleme ve kurtarma
Azure portalında bir 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 için tasarlamanız gerekir. Bunun için farklı bölgelerdeki iki Azure AI Dili kaynağı ve CLU modellerinizi bölgeler arasında eşitleme olanağı gerekir.
Uygulamanız veya işletmeniz CLU 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 yalnızca proje ayarlarınızın, amaçlarınızın, varlıklarınızın ve konuşmalarınızın bir kopyasını oluşturur. Çalışma zamanı API'leriyle kullanılabilir olacak modelleri eğitip dağıtmanız gerekir.
Bu makalede, projenizi desteklenen farklı coğrafi bölgelerdeki bir kaynaktan 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üketiminizde gereken değişiklikleri öğreneceksiniz.
Ön koşullar
- Her biri farklı bir bölgede olmak üzere farklı Azure bölgelerindeki iki Azure Yapay Zeka Dili kaynağı.
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ında kaynağa genel bakış sayfanıza gidin. Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız
Bahşiş
Hem birincil hem de ikincil kaynaklar için anahtarları ve uç noktaları not edin. Şu 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 proje varlıklarını birincil kaynağınızdaki projeden dışarı aktarın.
Dışarı aktarma işini gönder
Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız 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ğerlerini kendi değerlerinizle değiştirin.
{ENDPOINT}/language/authoring/analyze-conversations/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. | EmailApp |
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-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. |
API isteğinizi gönderdikten sonra başarılı olduğunu 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-conversations/projects/{PROJECT-NAME}/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. Aynı kimlik doğrulama yöntemini kullanarak dışarı aktarılan proje JSON'unu almak için bu URL'yi kullanın.
Dışarı aktarma işi durumunu alma
Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {PRIMARY-RESOURCE-KEY} ile {PRIMARY-ENDPOINT} değiştirin.
Dışarı aktarma işinizin 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-conversations/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} |
Dışarı aktarma işi durumunuzu 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ü. | 2023-04-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Tuş | Tanım | Değer |
|---|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. | {YOUR-PRIMARY-RESOURCE-KEY} |
Yanıt gövdesi
{
"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"
}
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.
| Tuş | Tanım | Değer |
|---|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. | {PRIMARY-RESOURCE-KEY} |
Sonraki içeri aktarma işi için gövde olarak kullanacağınız için yanıt gövdesini kopyalayın.
Yeni projeye içeri aktarma
Şimdi 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 aldığınız ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.
Projenizi içeri aktarmak için aşağıdaki URL'yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin.
İstek URL'si
API isteğinizi oluştururken aşağıdaki URL'yi kullanın. Yer tutucu değerlerini kendi değerlerinizle değiştirin.
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/: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 ve içeri aktardığınız JSON dosyasındaki proje adıyla eşleşmelidir. | EmailAppDemo |
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-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
Gönderdiğiniz JSON gövdesi aşağıdaki örneğe benzer. JSON nesnesi hakkında daha fazla ayrıntı için başvuru belgelerine bakın.
{
"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": []
}
]
}
}
| Tuş | Yer tutucu | Değer | Örnek |
|---|---|---|---|
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-01 |
|
projectName |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | EmailAppDemo |
language |
{LANGUAGE-CODE} |
Projenizde kullanılan konuşmaların dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, konuşmaların çoğunluğunun dil kodunu seçin. | en-us |
multilingual |
true |
Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeri. Modeliniz dağıtıldığında, modeli eğitim belgelerinize dahil olmayan diller de dahil olmak üzere desteklenen herhangi bir dilde sorgulayabilirsiniz. | true |
dataset |
{DATASET} |
Verilerinizi test ve eğitim kümesi arasında bölme hakkında bilgi için modeli eğitme bölümüne bakın. Bu alanın olası değerleri ve TestşeklindedirTrain. |
Train |
Başarılı bir istek üzerine API yanıtı, içeri aktarma işinin durumunu denetlemek için kullanabileceğiniz URL'ye sahip bir üst bilgi içerir operation-location . Şu şekilde biçimlendirilir:
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
İç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.
Başarılı bir proje içeri aktarma isteği gönderdiğinizde, içeri aktarma işinin durumunu denetlemeye yönelik tam istek URL'si (uç noktanız, proje adınız ve iş kimliğiniz dahil) yanıtın operation-location üst bilgisinde yer alır.
İçeri aktarma işinizin durumunu sorgulamak için aşağıdaki GET isteğini kullanın. Önceki adımda aldığınız URL'yi kullanabilir veya yer tutucu değerlerini kendi değerlerinizle değiştirebilirsiniz.
{ENDPOINT}/language/authoring/analyze-conversations/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} |
İçeri aktarma işi durumunuzu bulma kimliği. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Tuş | Tanım | Değer |
|---|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. | {YOUR-PRIMARY-RESOURCE-KEY} |
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.
{
"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"
}
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'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. Yer tutucu değerlerini kendi değerlerinizle değiştirin.
{ENDPOINT}/language/authoring/analyze-conversations/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. | EmailApp |
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-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. |
Request body
İsteğinizde aşağıdaki nesneyi kullanın. Model, eğitim tamamlandıktan sonra parametre için kullandığınız değerden modelLabel sonra adlandırılır.
{
"modelLabel": "{MODEL-NAME}",
"trainingMode": "{TRAINING-MODE}",
"trainingConfigVersion": "{CONFIG-VERSION}",
"evaluationOptions": {
"kind": "percentage",
"testingSplitPercentage": 20,
"trainingSplitPercentage": 80
}
}
| Tuş | Yer tutucu | Değer | Örnek |
|---|---|---|---|
modelLabel |
{MODEL-NAME} |
Model adınız. | Model1 |
trainingConfigVersion |
{CONFIG-VERSION} |
Eğitim yapılandırma modeli sürümü. Varsayılan olarak en son model sürümü kullanılır. | 2022-05-01 |
trainingMode |
{TRAINING-MODE} |
Eğitim için kullanılacak eğitim modu. Desteklenen modlar Standart eğitimdir, daha hızlı eğitimdir, ancak yalnızca diğer diller ve çok dilli projeler için desteklenen İngilizce ve Gelişmiş eğitimler için kullanılabilir, ancak daha uzun eğitim süreleri içerir. Eğitim modları hakkında daha fazla bilgi edinin. | standard |
kind |
percentage |
Bölünmüş yöntemler. Olası Değerler veya manualşeklindedirpercentage. Daha fazla bilgi için bkz . modeli eğitmek. |
percentage |
trainingSplitPercentage |
80 |
Eğitim kümesine eklenecek etiketli verilerinizin yüzdesi. Önerilen değer: 80. |
80 |
testingSplitPercentage |
20 |
Test kümesine eklenecek etiketli verilerinizin yüzdesi. Önerilen değer: 20. |
20 |
Dekont
trainingSplitPercentage ve testingSplitPercentage yalnızca olarak ayarlandıysa Kindpercentage gereklidir ve her iki yüzdenin toplamı 100'e eşit olmalıdır.
API isteğinizi gönderdikten sonra başarılı olduğunu 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-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
Eğitim işi 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.
Başarılı bir eğitim isteği gönderdiğinizde, işin durumunu denetlemeye yönelik tam istek URL'si (uç noktanız, proje adınız ve iş kimliğiniz dahil) yanıtın operation-location üst bilgisinde yer alır.
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-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{YOUR-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. | EmailApp |
{JOB-ID} |
Modelinizin eğitim durumunu bulma kimliği. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-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.
{
"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"
}
| Anahtar | Değer | Örnek |
|---|---|---|
modelLabel |
Model adı | Model1 |
trainingConfigVersion |
Eğitim yapılandırma sürümü. Varsayılan olarak en son sürüm kullanılır. | 2022-05-01 |
trainingMode |
Seçtiğiniz eğitim modu. | standard |
startDateTime |
Eğitimin başladığı zaman | 2022-04-14T10:23:04.2598544Z |
status |
Eğitim işinin durumu | running |
estimatedEndDateTime |
Eğitim işinin bitmek üzere tahmini süresi | 2022-04-14T10:29:38.2598544Z |
jobId |
Eğitim işi kimliğiniz | xxxxx-xxxx-xxxx-xxxx-xxxxxxxxx |
createdDateTime |
Eğitim işi oluşturma tarihi ve saati | 2022-04-14T10:22:42Z |
lastUpdatedDateTime |
Eğitim işi son güncelleştirme tarihi ve saati | 2022-04-14T10:23:45Z |
expirationDateTime |
Eğitim işi son kullanma tarihi ve saati | 2022-04-14T10:22:42Z |
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.
Bahşiş
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.
Konuşma dilini anlama modeli dağıtmaya başlamak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PUT isteği oluşturun.
İstek URL'si
{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-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 |
{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ü. | 2023-04-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
{
"trainedModelLabel": "{MODEL-NAME}",
}
| Tuş | 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 |
API isteğinizi gönderdikten sonra başarılı olduğunu 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-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
Dağıtım işi 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.
Başarılı bir dağıtım isteği gönderdiğinizde, işin durumunu denetlemeye yönelik tam istek URL'si (uç noktanız, proje adınız ve iş kimliğiniz dahil) yanıtın operation-location üst bilgisinde yer alır.
Dağıtım işinizin durumunu almak için aşağıdaki GET isteğini kullanın. Yer tutucu değerlerini kendi değerlerinizle değiştirin.
İstek URL'si
{ENDPOINT}/language/authoring/analyze-conversations/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. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. | 2023-04-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.
{
"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ı 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 ikincil anahtarınızı {YOUR-SECONDARY-ENDPOINT} kullanın. Yukarıdaki {PROJECT-NAME} adımları izlediyseniz ve {DEPLOYMENT-NAME} istek gövdesinde değişiklik yapılması gerekmesi için aynı olacaktır.
İkincil kaynağınızı kullanmaya geri dönerseniz 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ştirme tarihini gösterir. Aşağıdaki adımı biri birincil projeniz, diğeri 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 eşitlenmemiş olup olmadığını denetleyin.
Proje ayrıntılarınızı almak 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-conversations/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ü. | 2023-04-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Tuş | Tanım | Değer |
|---|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. | {YOUR-PRIMARY-RESOURCE-KEY} |
Yanıt gövdesi
{
"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}"
}
ve {SECONDARY-RESOURCE-KEY}kullanarak {SECONDARY-ENDPOINT} çoğaltılan projeniz için aynı adımları yineleyin. Her iki projeden döndürülenleri 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 dil kaynağına çoğaltmak için dışarı ve içeri aktarma API'lerini kullanmayı öğrendiniz. Ardından API başvuru belgelerini inceleyerek API yazmayla ilgili başka neler yapabileceğinizi görün.