Sebarkan model dan ekstrak entitas dari teks menggunakan API runtime

Setelah Anda puas dengan performa model Anda, model tersebut siap untuk disebarkan dan digunakan untuk mengenali entitas dalam teks. Menyebarkan model membuatnya tersedia untuk digunakan melalui API prediksi.

Prasyarat

• Proyek yang berhasil dibuat dengan akun penyimpanan Azure yang dikonfigurasi.
• Data teks yang telah diunggah ke akun penyimpanan Anda.
• Data berlabel dan berhasil model terlatih
• Tinjau detail evaluasi model untuk menentukan performa model Anda.

Lihat siklus hidup pengembangan proyek untuk informasi selengkapnya.

Menyebarkan model

Setelah meninjau performa model dan memutuskannya dapat digunakan di lingkungan Anda, Anda perlu menetapkannya ke penyebaran. Menetapkan model ke penyebaran membuatnya tersedia untuk digunakan melalui API prediksi. Disarankan untuk membuat penyebaran bernama produksi tempat Anda menetapkan model terbaik yang telah Anda bangun sejauh ini dan menggunakannya dalam sistem Anda. Anda dapat membuat penyebaran lain yang disebut penahapan yang dapat Anda tetapkan model yang saat ini sedang Anda kerjakan untuk dapat mengujinya. Anda dapat memiliki maksimal 10 penyebaran dalam proyek Anda.

Studio Bahasa

Untuk menyebarkan model Anda dari dalam Language Studio:

1. Pilih Menyebarkan model dari menu sebelah kiri.

2. Pilih Tambahkan penyebaran untuk memulai pekerjaan penyebaran baru.

   

3. Pilih Buat penyebaran baru untuk membuat penyebaran baru dan tetapkan model terlatih dari menu drop-down di bawah ini. Anda juga dapat Menimpa penyebaran yang ada dengan memilih opsi ini dan memilih model terlatih yang ingin Anda tetapkan dari menu drop-down di bawah ini.

   Catatan

   Menimpa penyebaran yang ada tidak memerlukan perubahan pada panggilan API prediksi Anda tetapi hasil yang Anda dapatkan akan didasarkan pada model yang baru ditetapkan.

   

4. Pilih Sebarkan untuk memulai pekerjaan penyebaran.

5. Setelah penyebaran berhasil, tanggal kedaluwarsa akan muncul di sampingnya. Kedaluwarsa penyebaran adalah ketika model yang Anda sebarkan tidak akan tersedia untuk digunakan untuk prediksi, yang biasanya terjadi dua belas bulan setelah konfigurasi pelatihan kedaluwarsa.

REST API

Mengirimkan pekerjaan penyebaran

Kirim permintaan PUT menggunakan URL, header, dan isi JSON berikut untuk mengirimkan tugas penyebaran. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

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

Placeholder	Nilai	Contoh
{ENDPOINT}	Titik akhir untuk mengautentikasi permintaan API Anda.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nama 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 terbaru yang dirilis. Lihat Siklus hidup model untuk mempelajari selengkapnya tentang versi API lain yang tersedia.	2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

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

Isi permintaan

Gunakan JSON berikut dalam isi permintaan Anda. Gunakan nama model yang akan Anda tetapkan ke penyebaran.

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

Tombol	Placeholder	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 bahwa pekerjaan telah dikirimkan dengan benar. Di header respons, ekstrak nilai operation-location. Nilai ini akan diformat seperti ini:

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

{JOB-ID} digunakan untuk mengidentifikasi permintaan Anda, karena operasi ini tidak asinkron. Anda dapat menggunakan URL ini untuk mendapatkan status penyebaran.

Dapatkan status pekerjaan penyebaran

Gunakan permintaan GET berikut untuk menanyakan status tugas penyebaran. 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-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

Placeholder	Nilai	Contoh
{ENDPOINT}	Titik akhir untuk mengautentikasi permintaan API Anda.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nama 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 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 terbaru yang dirilis. Lihat Siklus hidup model untuk mempelajari selengkapnya tentang versi API lain yang tersedia.	2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Tombol	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". Anda harus mendapatkan 200 kode untuk menunjukkan keberhasilan permintaan.

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

Menukar penyebaran

Setelah Anda selesai menguji model yang ditetapkan ke satu penyebaran dan Anda ingin menetapkan model ini ke penyebaran lain, Anda dapat menukar kedua penyebaran ini. Penukaran penyebaran melibatkan pengambilan model yang ditetapkan ke penyebaran pertama, dan menetapkannya ke penyebaran kedua. Kemudian mengambil model yang ditetapkan ke penyebaran kedua, dan menetapkannya ke penyebaran pertama. Anda dapat menggunakan proses ini untuk menukar penyebaran produksi dan penahapan saat Anda ingin mengambil model yang ditetapkan untuk penahapan dan menetapkannya ke produksi.

Studio Bahasa

Untuk menukar penyebaran dari dalam Language Studio:

1. Di halaman Menyebarkan model, pilih dua penyebaran yang ingin Anda tukar dan pilih Tukar penyebaran dari menu atas.

2. Dari jendela yang muncul, pilih nama penyebaran yang ingin Anda tukar.

REST API

Buat permintaan POST menggunakan URL, header, dan isi JSON berikut untuk memulai tugas penyebaran swap.

Minta URL

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

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

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

Isi Permintaan

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

Tombol	Placeholder	Nilai	Contoh
firstDeploymentName	{FIRST-DEPLOYMENT-NAME}	Nama untuk penyebaran pertama Anda. Nilai ini peka huruf besar/kecil.	production
secondDeploymentName	{SECOND-DEPLOYMENT-NAME}	Nama untuk penyebaran kedua Anda. Nilai ini peka huruf besar/kecil.	staging

Setelah mengirim permintaan API, Anda akan menerima respons 202 yang menunjukkan keberhasilan.

Menghapus penyebaran

Studio Bahasa

Untuk menghapus penyebaran dari Language Studio, buka halaman Menyebarkan model. Pilih penyebaran yang ingin Anda hapus dan pilih Hapus penyebaran dari menu atas.

REST API

Buat permintaan DELETE menggunakan URL, header, dan isi JSON berikut untuk menghapus penyebaran.

Minta URL

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

Placeholder	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 untuk nama penyebaran Anda. Nilai ini peka huruf besar/kecil.	prod
{API-VERSION}	Versi API yang Anda panggil. Nilai yang dirujuk di sini adalah untuk versi terbaru yang dirilis. Lihat Siklus hidup model untuk mempelajari selengkapnya tentang versi API lain yang tersedia.	2022-05-01

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

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

Setelah Anda mengirim permintaan API, Anda akan menerima respons 202 yang menunjukkan keberhasilan, yang berarti penyebaran Anda telah dihapus. Hasil call yang sukses dengan header Operation-Location yang digunakan untuk memeriksa status pekerjaan.

Menetapkan sumber daya penyebaran

Anda dapat menyebarkan proyek ke beberapa wilayah dengan menetapkan sumber daya Bahasa yang berbeda yang ada di berbagai wilayah.

Studio Bahasa

Untuk menetapkan sumber daya penyebaran di wilayah lain di Language Studio:

1. Pastikan Anda telah menetapkan diri Anda sebagai Pemilik Bahasa Cognitive Services ke sumber daya yang Anda gunakan untuk membuat proyek.
2. Buka halaman Menyebarkan model di Language Studio.
3. Pilih tab Wilayah .
4. Pilih Tambahkan sumber daya penyebaran.
5. Pilih Sumber daya Bahasa di wilayah lain.

Anda sekarang siap untuk menyebarkan proyek Anda ke wilayah tempat Anda menetapkan sumber daya.

REST API

Menetapkan sumber daya penyebaran secara terprogram memerlukan autentikasi Microsoft Entra. ID Microsoft Entra digunakan untuk mengonfirmasi bahwa Anda memiliki akses ke sumber daya yang Anda minati untuk ditetapkan ke proyek Anda untuk penyebaran multi-wilayah. Untuk menggunakan autentikasi Microsoft Entra secara terprogram saat melakukan panggilan REST API, pelajari lebih lanjut dari dokumentasi layanan Azure AI.

Menetapkan sumber daya

Kirim permintaan POST menggunakan URL, header, dan isi JSON berikut untuk menetapkan sumber daya penyebaran.

Minta URL

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

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

Placeholder	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.	2022-10-01-preview

Header

Gunakan autentikasi Microsoft Entra untuk mengautentikasi API ini.

Isi

Gunakan sampel JSON berikut sebagai badan Anda.

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

Tombol	Placeholder	Nilai	Contoh
azureResourceId	{AZURE-RESOURCE-ID}	Jalur ID sumber daya lengkap yang ingin Anda tetapkan. Ditemukan di portal Azure di bawah tab Properti untuk sumber daya, di bidang ID Sumber Daya.	/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource
customDomain	{CUSTOM-DOMAIN}	Subdomain kustom sumber daya yang ingin Anda tetapkan. Ditemukan di portal Azure di bawah tab Kunci dan Titik Akhir untuk sumber daya, sebagai bidang Titik Akhir di URLhttps://<your-custom-subdomain>.cognitiveservices.azure.com/	contosoresource
region	{REGION-CODE}	Kode wilayah yang menentukan wilayah sumber daya yang ingin Anda tetapkan. Ditemukan di portal Azure di bawah tab Kunci dan Titik Akhir untuk sumber daya, di bidang Lokasi/Wilayah.	eastus

Dapatkan status tetapkan sumber daya

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

Minta URL

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

Placeholder	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 pekerjaan untuk mendapatkan status penyebaran tugas Anda. Ini ada di nilai header yang operation-location Anda terima dari API sebagai respons terhadap permintaan sumber daya penyebaran yang ditetapkan.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Versi API yang Anda panggil.	2022-10-01-preview

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

Tombol	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. Terus polling titik akhir ini hingga status parameter berubah menjadi succeeded.

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

Membatalkan penetapan sumber daya penyebaran

Saat membatalkan penetapan atau menghapus sumber daya penyebaran dari proyek, Anda juga akan menghapus semua penyebaran yang telah disebarkan ke wilayah sumber daya tersebut.

Studio Bahasa

Untuk menghapus penetapan atau menghapus sumber daya penyebaran di wilayah lain menggunakan Language Studio:

1. Buka tab Wilayah di halaman Sebarkan model .
2. Pilih sumber daya yang ingin Anda batalkan penandatanganannya.
3. Pilih tombol Hapus penugasan .
4. Di jendela yang muncul, ketik nama sumber daya yang ingin Anda hapus.

REST API

Batalkan penjatuhan sumber daya

Kirim permintaan POST menggunakan URL, header, dan isi JSON berikut untuk menghapus penetapan atau menghapus sumber daya penyebaran dari proyek Anda.

Minta URL

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

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

Placeholder	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.	2022-10-01-preview

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

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

Isi

Gunakan sampel JSON berikut sebagai badan Anda.

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

Tombol	Placeholder	Nilai	Contoh
assignedResourceIds	{AZURE-RESOURCE-ID}	Jalur ID sumber daya lengkap yang ingin Anda batalkan penjagaannya. Ditemukan di portal Azure di bawah tab Properti untuk sumber daya sebagai bidang ID Sumber Daya.	/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource

Mendapatkan status sumber daya batal ditetapkan

Gunakan permintaan GET berikut untuk mendapatkan status tugas sumber daya penyebaran anda yang tidak ditetapkan. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

Minta URL

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

Placeholder	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 pekerjaan untuk mendapatkan status penyebaran tugas Anda. Ini adalah nilai header yang operation-location Anda terima dari API sebagai respons terhadap permintaan sumber daya penyebaran yang tidak ditetapkan.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Versi API yang Anda panggil.	2022-10-01-preview

Header

Gunakan header berikut untuk mengautentikasi permintaan Anda.

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

Langkah berikutnya

Setelah Anda memiliki penyebaran, Anda dapat menggunakannya untuk mengekstrak entitas dari teks.