Mencadangkan dan memulihkan model pemahaman bahasa percakapan Anda

Saat Anda membuat sumber daya Bahasa di portal Azure, Anda menentukan wilayah sebagai tempat untuk membuatnya. Sejak saat itu, sumber daya Anda dan semua operasi yang terkait dengannya terjadi di wilayah server Azure yang ditentukan. Jarang terjadi, tetapi bukan tidak mungkin, mengalami masalah jaringan yang melanda seluruh wilayah. Jika solusi Anda harus selalu tersedia, maka Anda harus merancangnya untuk memiliki failover ke wilayah lain. Ini memerlukan dua sumber daya Bahasa Azure di wilayah yang berbeda dan kemampuan untuk menyinkronkan model CLU Anda di seluruh wilayah.

Jika aplikasi atau bisnis Anda bergantung pada penggunaan model CLU, sebaiknya buat replika proyek Anda ke wilayah lain yang didukung. Sehingga jika pemadaman layanan regional terjadi, Anda kemudian dapat mengakses model Anda di wilayah failover lain tempat replika proyek Anda.

Membuat replika proyek berarti Anda mengekspor metadata dan aset proyek Anda kemudian mengimpornya ke dalam proyek baru. Ini hanya membuat salinan pengaturan proyek, niat, entitas, dan ucapan Anda. Anda masih harus melatih dan menyebarkan model agar tersedia untuk digunakan dengan API runtime.

Pada artikel ini, Anda akan mempelajari cara menggunakan API ekspor dan impor untuk membuat replika proyek Anda dari satu sumber daya ke sumber daya lain yang ada di berbagai wilayah geografis yang didukung, panduan untuk menjaga proyek Anda tetap sinkron, dan perubahan yang diperlukan untuk penggunaan runtime Anda.

Prasyarat

  • Dua sumber daya Bahasa Azure di wilayah Azure yang berbeda, masing-masing di wilayah yang berbeda.

Mendapatkan titik akhir kunci sumber daya Anda

Gunakan langkah-langkah berikut untuk mendapatkan kunci dan titik akhir sumber daya primer dan sekunder Anda. Ini akan digunakan dalam langkah-langkah berikut.

Buka halaman citraan umum sumber daya Anda di portal Microsoft Azure. Dari menu sebelah kiri, pilih Kunci dan Titik Akhir. Anda akan menggunakan titik akhir dan kunci untuk permintaan API

A screenshot showing the key and endpoint page in the Azure portal.

Tip

Catat kunci dan titik akhir untuk sumber daya primer dan sekunder. Gunakan nilai-nilai ini untuk mengganti tempat penampung berikut: {PRIMARY-ENDPOINT},{PRIMARY-RESOURCE-KEY}, {SECONDARY-ENDPOINT}, dan {SECONDARY-RESOURCE-KEY}. Perhatikan juga nama proyek Anda, nama model Anda, dan nama penyebaran Anda. Gunakan nilai-nilai ini untuk mengganti tempat penampung berikut: {PROJECT-NAME},{MODEL-NAME}, dan {DEPLOYMENT-NAME}.

Mengekspor aset proyek utama Anda

Mulailah dengan mengekspor aset proyek dari proyek di sumber daya utama Anda.

Mengirim pekerjaan ekspor

Ganti tempat penampung dalam permintaan berikut dengan Anda {PRIMARY-ENDPOINT} dan {PRIMARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Buat permintaan POST menggunakan URL, header, dan isi JSON berikut untuk mengekspor proyek Anda.

URL Permintaan

Gunakan URL berikut saat membuat permintaan API Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. EmailApp
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda.

Setelah mengirim permintaan API, Anda akan menerima respons 202 yang menunjukkan keberhasilan. Di header respons, ekstrak nilai operation-location. Nilai ini akan diformat seperti ini:

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

JOB-ID digunakan untuk mengidentifikasi permintaan Anda, karena operasi ini tidak asinkron. Gunakan URL ini untuk mendapatkan JSON proyek yang diekspor, menggunakan metode autentikasi yang sama.

Mendapatkan status pekerjaan ekspor

Ganti tempat penampung dalam permintaan berikut dengan Anda {PRIMARY-ENDPOINT} dan {PRIMARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Gunakan permintaan GET berikut untuk mengkueri status pekerjaan ekspor Anda. Anda dapat menggunakan URL yang Anda terima dari langkah sebelumnya, atau mengganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. myProject
{JOB-ID} ID untuk menemukan status pekerjaan ekspor Anda. Ini ada dalam nilai header location yang Anda terima di langkah sebelumnya. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Deskripsi Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda. {YOUR-PRIMARY-RESOURCE-KEY}

Isi Respons

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

Gunakan url dari kunci resultUrl dalam isi untuk melihat aset yang diekspor dari pekerjaan ini.

Mendapatkan hasil ekspor

Kirimkan permintaan GET menggunakan {RESULT-URL} yang Anda terima dari langkah sebelumnya untuk melihat hasil pekerjaan ekspor.

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Deskripsi Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda. {PRIMARY-RESOURCE-KEY}

Salin isi respons karena Anda akan menggunakannya sebagai isi untuk pekerjaan impor berikutnya.

Mengimpor ke proyek baru

Sekarang lanjutkan dan impor aset proyek yang diekspor di proyek baru Anda di wilayah sekunder sehingga Anda dapat membuat replikanya.

Mengirim pekerjaan impor

Ganti tempat penampung dalam permintaan berikut dengan Anda {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Kirim permintaan POST menggunakan URL, header, dan isi JSON berikut untuk mengimpor proyek Anda.

URL Permintaan

Gunakan URL berikut saat membuat permintaan API Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. myProject
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda.

Isi

Gunakan sampel JSON berikut sebagai badan Anda.

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

Kunci Tempat penampung Nilai Contoh
versi-api {API-VERSION} Versi API yang Anda panggil. Versi yang digunakan di sini harus berupa versi model API yang sama di URL. Lihat artikel versi model untuk mempelajari selengkapnya. 2022-05-01
projectName {PROJECT-NAME} Nama proyek Anda. Nilai ini peka huruf besar/kecil. EmailApp
language {LANGUAGE-CODE} String yang menentukan kode bahasa untuk ungkapan yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multibahasa, pilih kode bahasa dari sebagian besar ungkapan. en-us
multilingual true Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam himpunan data Anda. Saat model Anda disebarkan, Anda dapat mengkueri model dalam setiap bahasa yang didukung. Ini termasuk bahasa yang tidak disertakan dalam dokumen pelatihan Anda. true
dataset {DATASET} Lihat cara melatih model untuk informasi tentang pemisahan data Anda antara set pengujian dan pelatihan. Nilai yang mungkin untuk bidang ini adalah Train dan Test. Train

Mendapatkan status pekerjaan impor

Ganti tempat penampung dalam permintaan berikut dengan Anda {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Gunakan permintaan GET berikut untuk mengkueri status pekerjaan impor Anda. Anda dapat menggunakan URL yang Anda terima dari langkah sebelumnya, atau mengganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. myProject
{JOB-ID} ID untuk menemukan status pekerjaan ekspor Anda. Ini ada dalam nilai header location yang Anda terima di langkah sebelumnya. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Deskripsi Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda. {YOUR-PRIMARY-RESOURCE-KEY}

Isi Respons

Setelah mengirim permintaan, Anda akan mendapatkan respons berikut. Pertahankan polling titik akhir ini sampai parameter status berubah menjadi "berhasil".

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

Latih model Anda

Setelah mengimpor proyek, Anda hanya menyalin aset dan metadata proyek. Anda masih perlu melatih model, yang akan dikenai penggunaan di akun Anda.

Mengirim pekerjaan pelatihan

Ganti tempat penampung dalam permintaan berikut dengan Anda {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Buat permintaan POST menggunakan URL, header, dan isi JSON berikut untuk mengirimkan tugas pelatihan.

URL Permintaan

Gunakan URL berikut saat membuat permintaan API Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:train?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. EmailApp
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda.

Isi permintaan

Gunakan objek berikut dalam permintaan Anda. Model ini akan diberi nama MyModel setelah pelatihan selesai.

{
  "modelLabel": "{MODEL-NAME}",
  "trainingMode": "{TRAINING-MODE}",
  "trainingConfigVersion": "{CONFIG-VERSION}",
  "evaluationOptions": {
    "kind": "percentage",
    "testingSplitPercentage": 20,
    "trainingSplitPercentage": 80
  }
}
Kunci Tempat penampung Nilai Contoh
modelLabel {MODEL-NAME} Nama model anda. Model1
trainingConfigVersion {CONFIG-VERSION} Versi model konfigurasi pelatihan. Secara default, versi model terbaru digunakan. 2022-05-01
trainingMode {TRAINING-MODE} Mode pelatihan yang akan digunakan untuk pelatihan. Mode yang didukung adalah Pelatihan standar, pelatihan yang lebih cepat, tetapi hanya tersedia untuk Bahasa Inggris dan Pelatihan tingkat lanjut yang didukung untuk bahasa lain dan proyek multibahasa, tetapi memerlukan waktu pelatihan yang lebih lama. Pelajari selengkapnya tentang mode pelatihan. standard
kind percentage Memisahkan metode. Kemungkinan Nilainya adalah percentage atau manual. Lihat cara melatih model untuk informasi lebih lanjut. percentage
trainingSplitPercentage 80 Persentase data anda yang ditandai untuk disertakan dalam set pelatihan. Nilai yang disarankan adalah 80. 80
testingSplitPercentage 20 Persentase data anda yang ditandai untuk disertakan dalam set pengujian. Nilai yang disarankan adalah 20. 20

Catatan

trainingSplitPercentage dan testingSplitPercentage hanya diperlukan jika Kind disetel ke percentage dan jumlah kedua persentase harus sama dengan 100.

Setelah mengirim permintaan API, Anda akan menerima respons 202 yang menunjukkan keberhasilan. Di header respons, ekstrak nilai operation-location. Nilai ini akan diformat seperti ini:

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

Anda dapat menggunakan URL ini untuk mendapatkan status pekerjaan pelatihan.

Dapatkan Status Pelatihan

Ganti tempat penampung dalam permintaan berikut dengan Anda {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Gunakan permintaan GET berikut untuk mendapatkan status kemajuan pelatihan model Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

URL Permintaan

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{YOUR-ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. EmailApp
{JOB-ID} ID untuk menemukan status pelatihan model Anda. Ini ada di nilai header location yang Anda terima saat mengirimkan pekerjaan pelatihan Anda. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi terbaru yang dirilis. Pelajari selengkapnya tentang versi API lain yang tersedia 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda.

Isi Respons

Setelah mengirim permintaan, Anda akan mendapatkan respons berikut. Pertahankan polling titik akhir ini sampai parameter status berubah menjadi "berhasil".

{
  "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"
}
Kunci Nilai Contoh
modelLabel Nama model Model1
trainingConfigVersion Versi konfigurasi pelatihan. Secara default, versi terbaru digunakan. 2022-05-01
trainingMode Mode pelatihan yang Anda pilih. standard
startDateTime Waktu pelatihan dimulai 2022-04-14T10:23:04.2598544Z
status Status pekerjaan pelatihan running
estimatedEndDateTime Perkiraan waktu untuk menyelesaikan pekerjaan pelatihan 2022-04-14T10:29:38.2598544Z
jobId ID pekerjaan pelatihan Anda xxxxx-xxxx-xxxx-xxxx-xxxxxxxxx
createdDateTime Tanggal dan waktu pembuatan pekerjaan pelatihan 2022-04-14T10:22:42Z
lastUpdatedDateTime Tanggal dan waktu pekerjaan pelatihan yang terakhir diperbarui 2022-04-14T10:23:45Z
expirationDateTime Tanggal dan waktu kedaluwarsa pekerjaan pelatihan 2022-04-14T10:22:42Z

sebarkan model anda

Ini adalah langkah di mana Anda membuat model terlatih agar tersedia untuk penggunaan melalui API prediksi runtime.

Tip

Gunakan nama penyebaran yang sama dengan proyek utama Anda agar pemeliharaan menjadi lebih mudah dan perubahan minimal pada sistem Anda untuk menangani pengalihan lalu lintas Anda.

Mengirimkan pekerjaan penyebaran

Ganti tempat penampung dalam permintaan berikut dengan Anda {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Buat permintaan PUT menggunakan URL, header, dan isi JSON berikut untuk mulai menyebarkan model pemahaman bahasa percakapan.

URL Permintaan

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. myProject
{DEPLOYMENT-NAME} Nama penyebaran Anda. Nilai ini peka huruf besar/kecil. staging
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda.

Isi Permintaan

{
  "trainedModelLabel": "{MODEL-NAME}",
}
Kunci Tempat penampung Nilai Contoh
trainedModelLabel {MODEL-NAME} Nama model yang akan ditetapkan ke penyebaran Anda. Anda hanya dapat menetapkan model yang berhasil dilatih. Nilai ini peka huruf besar/kecil. myModel

Setelah mengirim permintaan API, Anda akan menerima respons 202 yang menunjukkan keberhasilan. Di header respons, ekstrak nilai operation-location. Nilai ini akan diformat seperti ini:

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

Anda dapat menggunakan URL ini untuk mendapatkan status pekerjaan penyebaran.

Dapatkan status penyebaran

Ganti tempat penampung dalam permintaan berikut dengan Anda {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY} yang Anda peroleh di langkah pertama.

Gunakan permintaan GET berikut untuk mendapatkan status dari pekerjaan penyebaran Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

URL Permintaan

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. myProject
{DEPLOYMENT-NAME} Nama penyebaran Anda. Nilai ini peka huruf besar/kecil. staging
{JOB-ID} ID untuk menemukan status pelatihan model Anda. Ini ada di nilai header location yang Anda terima dari API sebagai respons terhadap permintaan penyebaran model Anda. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda.

Isi Respons

Setelah mengirim permintaan, Anda akan mendapatkan respons berikut. Pertahankan polling titik akhir ini sampai parameter status berubah menjadi "berhasil".

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

Perubahan dalam memanggil runtime

Di dalam sistem Anda, pada langkah saat Anda memanggil API runtime, periksa kode respons yang ditampilkan dari API tugas pengiriman. Jika Anda mengamati kegagalan yang konsisten dalam pengiriman permintaan, ini dapat mengindikasikan pemadaman di wilayah utama Anda. Kegagalan sekali tidak berarti pemadaman, ini mungkin hanya masalah sementara. Coba kirimkan lagi pekerjaan melalui sumber daya sekunder yang telah Anda buat. Untuk permintaan kedua, gunakan kunci {YOUR-SECONDARY-ENDPOINT} dan sekunder, jika Anda telah mengikuti langkah-langkah di atas, {PROJECT-NAME} dan {DEPLOYMENT-NAME} akan sama sehingga tidak ada perubahan yang diperlukan pada isi permintaan.

Jika kembali menggunakan sumber daya sekunder, Anda akan merasakan sedikit peningkatan latensi karena perbedaan di wilayah tempat model Anda disebarkan.

Memeriksa jika proyek Anda tidak sinkron

Menjaga sinkronisasi kedua proyek adalah bagian penting dari proses. Anda harus sering memeriksa apakah ada pembaruan yang dibuat untuk proyek utama sehingga Anda memindahkannya ke proyek sekunder. Dengan cara ini, jika wilayah utama gagal dan Anda berpindah ke wilayah sekunder, Anda bisa mengharapkan performa model serupa karena sudah berisi pembaruan terbaru. Mengatur frekuensi pemeriksaan apakah proyek Anda sinkron adalah pilihan penting, sebaiknya Anda melakukan pemeriksaan ini setiap hari untuk menjamin sinkronisasi data dalam model sekunder Anda.

Mendapatkan detail proyek

Gunakan url berikut untuk mendapatkan detail proyek Anda, salah satu kunci yang dikembalikan dalam isi menunjukkan tanggal terakhir proyek yang dimodifikasi. Ulangi langkah berikut dua kali, satu untuk proyek utama Anda dan satu lagi untuk proyek sekunder Anda dan bandingkan tanda waktu yang dikembalikan untuk keduanya untuk memeriksa apakah mereka tidak sinkron.

Gunakan permintaan GET berikut untuk mendapatkan detail proyek Anda. Anda dapat menggunakan URL yang Anda terima dari langkah sebelumnya, atau mengganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}
Tempat penampung Nilai Contoh
{ENDPOINT} Titik akhir untuk mengautentikasi permintaan API Anda. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil. myProject
{API-VERSION} Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi model terbaru yang dirilis. 2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Kunci Deskripsi Nilai
Ocp-Apim-Subscription-Key Kunci sumber daya Anda. Digunakan untuk mengautentikasi permintaan API Anda. {YOUR-PRIMARY-RESOURCE-KEY}

Isi Respons

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

Ulangi langkah yang sama untuk proyek yang dibuat replikanya menggunakan {SECONDARY-ENDPOINT} dan {SECONDARY-RESOURCE-KEY}. Bandingkan lastModifiedDateTime yang ditampilkan dari kedua proyek tersebut. Jika proyek utama Anda diubah lebih cepat daripada proyek sekunder, Anda perlu mengulangi langkah-langkah mengekspor, mengimpor, pelatihan, dan menyebarkan model Anda.

Langkah berikutnya

Pada artikel ini, Anda telah mempelajari cara menggunakan API ekspor dan impor untuk membuat replika proyek Anda ke sumber daya Bahasa sekunder di wilayah lain. Selanjutnya, jelajahi dokumen referensi API untuk melihat apa lagi yang dapat Anda lakukan dengan API penulisan.