Cara membuat proyek klasifikasi teks kustom

Gunakan artikel ini untuk mempelajari cara menyiapkan persyaratan untuk mulai menggunakan klasifikasi teks kustom dan membuat proyek.

Prasyarat

Sebelum mulai menggunakan klasifikasi teks kustom, Anda akan memerlukan:

• Langganan Azure - Buat langganan gratis.

Membuat sumber daya Bahasa

Sebelum mulai menggunakan klasifikasi teks kustom, Anda memerlukan sumber daya Bahasa Azure AI. Disarankan untuk membuat sumber daya Bahasa dan menyambungkan akun penyimpanan ke dalamnya di portal Azure. Membuat sumber daya di portal Microsoft Azure memungkinkan Anda membuat akun penyimpanan Azure pada saat yang sama, dengan semua izin yang diperlukan telah dikonfigurasi sebelumnya. Anda juga dapat membaca lebih lanjut di artikel untuk mempelajari cara menggunakan sumber daya yang sudah ada sebelumnya, dan mengonfigurasinya untuk bekerja dengan klasifikasi teks kustom.

Anda juga akan memerlukan akun penyimpanan Azure tempat Anda akan mengunggah dokumen .txt yang akan digunakan untuk melatih model untuk mengklasifikasikan teks.

Catatan

• Anda harus memiliki peran pemilik yang ditetapkan pada grup sumber daya untuk membuat sumber daya Bahasa.
• Jika akan menyambungkan akun penyimpanan yang sudah ada, Anda harus memiliki peran pemilik yang ditetapkan.

Membuat sumber daya Bahasa dan menyambungkan akun penyimpanan

Catatan

Anda tidak boleh memindahkan akun penyimpanan ke grup sumber daya atau langganan yang berbeda setelah ditautkan dengan sumber daya Bahasa.

Portal Azure

Buat sumber daya baru menggunakan portal Microsoft Azure

1. Buka portal Azure untuk membuat sumber daya Bahasa Azure AI baru.

2. Di jendela yang muncul, pilih Klasifikasi teks kustom & pengenalan entitas bernama kustom dari fitur kustom. Pilih Lanjutkan untuk membuat sumber daya Anda di bagian bawah layar.

   

3. Buat sumber daya Bahasa dengan detail berikut.

   Nama	Nilai yang diperlukan
   Langganan	Langganan Azure Anda.
   Grup sumber daya	Grup sumber daya yang akan berisi sumber daya Anda. Anda dapat menggunakan ruang kerja yang sudah ada atau membuat baru.
   Wilayah	Salah satu wilayah yang didukung. Misalnya, "US Barat 2".
   Nama	Nama sumber daya Anda.
   Tingkatan harga	Salah satu tingkat harga yang didukung. Anda dapat menggunakan tingkat Gratis (F0) untuk mencoba layanan.

   Jika Anda mendapatkan pesan yang mengatakan "akun masuk Anda bukan pemilik grup sumber daya akun penyimpanan yang dipilih", akun Anda harus memiliki peran pemilik yang ditetapkan pada grup sumber daya sebelum Anda dapat membuat sumber daya Bahasa. Hubungi pemilik langganan Azure Anda untuk bantuan.

   Anda dapat menentukan pemilik langganan Azure dengan mencari grup sumber daya Anda dan mengikuti tautan ke langganan terkait. lalu:

   1. Pilih tab Access Control (IAM)
   2. Pilih Penetapan peran
   3. Filter menurut Peran:Pemilik.

4. Di bagian Klasifikasi teks kustom & pengenalan entitas bernama kustom, pilih akun penyimpanan yang sudah ada atau pilih Akun penyimpanan baru. Perhatikan bahwa nilai ini untuk membantu Anda memulai, dan belum tentu nilai akun penyimpanan yang ingin Anda gunakan di lingkungan produksi. Untuk menghindari latensi selama membangun proyek Anda, sambungkan ke akun penyimpanan di wilayah yang sama dengan sumber daya Bahasa Anda.

   Nilai akun penyimpanan	Nilai yang direkomendasikan
   Nama akun penyimpanan	Nama apa pun
   Jenis akun penyimpanan	LRS Standar

5. Pastikan Pemberitahuan AI yang Bertanggung Jawab diperiksa. Pilih Tinjau + buat di bagian bawah halaman.

Studio Bahasa

Membuat sumber daya Bahasa baru dari Studio Bahasa

Jika ini pertama kalinya Anda masuk, Anda akan melihat jendela di Studio Bahasa yang akan memungkinkan Anda memilih sumber daya Bahasa yang ada atau membuat yang baru. Anda juga dapat membuat sumber daya dengan mengklik ikon pengaturan di sudut kanan atas, memilih Sumber Daya, lalu mengklik Buat sumber daya baru.

Buat sumber daya Bahasa dengan detail berikut.

Detail instans	Nilai yang diperlukan
Langganan Azure	Pilih langganan Azure Anda
Grup sumber daya Azure	Grup sumber daya Azure Anda
Nama sumber daya Azure	Nama sumber daya Azure Anda
Lokasi	Wilayah tempat sumber daya Bahasa Anda.
Tingkatan harga	Tingkat harga untuk sumber daya Bahasa Anda.

Penting

• Pastikan untuk mengaktifkan Identitas Terkelola saat Anda membuat sumber daya Bahasa.
• Membaca dan Mengonfirmasikan pemberitahuan AI yang Bertanggung Jawab

Untuk menggunakan klasifikasi teks kustom, Anda harus menyambungkan sumber daya anda ke akun penyimpanan. Jika belum memilikinya, Anda dapat membuat akun penyimpanan Azure. Gunakan langkah-langkah berikut untuk membuat proyek pertama Anda dan menyambungkan akun penyimpanan Anda.

1. Masuk ke Studio Bahasa. Sebuah jendela akan muncul yang memungkinkan Anda memilih langganan dan sumber daya Language. Pilih sumber daya Bahasa Anda.

2. Di bagian Klasifikasi teks di Studio Bahasa, pilih Klasifikasi teks kustom.

   

3. Pilih Buat proyek baru dari menu atas di halaman proyek Anda. Membuat proyek akan memungkinkan Anda melabeli data, melatih, mengevaluasi, meningkatkan, dan menyebarkan model Anda.

   

4. Setelah Anda mengeklik, Buat proyek baru, layar akan muncul untuk memungkinkan Anda menghubungkan akun penyimpanan Anda. Jika Anda sudah menyambungkan akun penyimpanan, Anda akan melihat akun penyimpanan tersambung. Jika tidak, pilih akun penyimpanan Anda dari menu dropdown yang muncul dan pilih akun penyimpanan Koneksi; ini akan mengatur peran yang diperlukan untuk akun penyimpanan Anda. Langkah ini mungkin akan mengembalikan kesalahan jika Anda tidak ditetapkan sebagai pemilik di akun penyimpanan.

   Catatan

   • Cukup lakukan langkah ini sekali untuk setiap sumber daya baru yang Anda gunakan.
   • Proses ini tidak dapat diubah, jika Anda menghubungkan akun penyimpanan ke sumber daya Bahasa, Anda tidak dapat memutuskannya nanti.
   • Anda hanya dapat menghubungkan sumber daya Bahasa Anda ke satu akun penyimpanan.

   

5. Pilih jenis proyek. Anda dapat membuat proyek Klasifikasi multi-label yang setiap dokumennya dapat disertakan dalam satu atau beberapa kelas atau proyek Klasifikasi label tunggal yang setiap dokumennya hanya dapat disertakan dalam satu kelas. Jenis yang dipilih tidak dapat diubah nanti. Pelajari selengkapnya jenis proyek

   

6. Masukkan informasi proyek, termasuk nama, deskripsi, dan bahasa pemrogram file dalam dokumen di proyek Anda. Jika Anda menggunakan contoh himpunan data, pilih Bahasa Inggris. Anda tidak akan dapat mengubah nama proyek Anda nanti. Pilih Selanjutnya.

   Tip

   Himpunan data Anda tidak harus sepenuhnya dalam bahasa pemrogram yang sama. Anda dapat memiliki beberapa dokumen, masing-masing dengan bahasa yang didukung berbeda. Jika himpunan data Anda berisi dokumen dari bahasa yang berbeda atau jika Anda mengharapkan teks dari bahasa yang berbeda selama waktu proses, pilih opsi aktifkan himpunan data multi-bahasa saat Anda memasukkan informasi dasar untuk proyek Anda. Opsi ini dapat diaktifkan nanti dari halaman Pengaturan proyek.

7. Pilih kontainer tempat Anda mengunggah himpunan data Anda.

   Catatan

   Jika Anda telah memberi label data Anda pastikan data mengikuti format yang didukung dan pilih Ya, dokumen saya sudah diberi label dan saya telah memformat file label JSON dan memilih file label dari menu drop-down di bawah ini.

   Jika Anda menggunakan salah satu contoh himpunan data, gunakan file yang disertakan webOfScience_labelsFile atau movieLabels json. Kemudian pilih Berikutnya.

8. Tinjau data yang Anda masukkan dan pilih Buat Project.

Menggunakan Azure PowerShell

Anda dapat membuat sumber daya baru dan akun penyimpanan menggunakan templat CLI berikut dan file parameter, yang di-host pada GitHub.

Mengedit nilai berikut dalam file parameter:

Nama Parameter	Deskripsi nilai
name	Nama sumber Bahasa Anda
location	Wilayah tempat sumber daya Anda di-hosting. Lihat dukungan wilayah untuk informasi selengkapnya.
sku	Tingkat harga sumber daya Anda. Lihat batas layanan untuk informasi selengkapnya.
storageResourceName	Nama akun penyimpanan Anda
storageLocation	Wilayah di mana akun penyimpanan Anda dihosting.
storageSkuType	SKU akun penyimpanan Anda.
storageResourceGroupName	Grup sumber daya akun penyimpanan Anda

Gunakan perintah PowerShell berikut untuk menyebarkan templat Azure Resource Manager (ARM) dengan file yang Anda edit.

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName ExampleResourceGroup `
  -TemplateFile <path-to-arm-template> `
  -TemplateParameterFile <path-to-parameters-file>

Lihat dokumentasi templat ARM untuk informasi tentang menyebarkan templat dan file parameter.

Catatan

• Proses menyambungkan akun penyimpanan ke sumber daya Bahasa tidak dapat dibatalkan, tidak dapat diputuskan nanti.
• Anda hanya dapat menyambungkan sumber daya bahasa ke satu akun penyimpanan.

Menggunakan sumber daya Bahasa yang sudah ada sebelumnya

Persyaratan	Deskripsi
Wilayah	Pastikan sumber daya Anda yang sudah ada tersedia di salah satu wilayah yang didukung. Jika belum memiliki sumber daya, Anda harus membuat sumber daya baru di wilayah yang didukung.
Tingkatan harga	Tingkat harga untuk sumber daya Anda.
Identitas Terkelola	Pastikan pengaturan identitas terkelola sumber daya diaktifkan. Jika tidak, baca bagian selanjutnya.

Untuk menggunakan klasifikasi kustom, Anda harus membuat akun penyimpanan Azure jika Anda belum memilikinya.

Mengaktifkan manajemen identitas untuk sumber daya Anda

Portal Azure

Sumber daya Bahasa harus memiliki manajemen identitas, untuk mengaktifkannya gunakan portal Azure:

1. Buka sumber daya Bahasa
2. Dari menu sebelah kiri, di bawah bagian Manajemen Sumber Daya, pilih Identitas
3. Dari tab Sistem yang ditetapkan, pastikan untuk mengatur Status ke Aktif

Studio Bahasa

Sumber daya Bahasa Anda harus memiliki manajemen identitas, untuk mengaktifkannya menggunakan Studio Bahasa:

1. Pilih ikon pengaturan di sudut kanan atas layar
2. Pilih Sumber daya
3. Pilih kotak centang Identitas Terkelola untuk sumber daya Bahasa Azure AI Anda.

Mengaktifkan fitur klasifikasi teks kustom

Pastikan untuk mengaktifkan fitur Klasifikasi teks kustom/Pengenalan Entitas Bernama Kustom dari portal Azure.

1. Buka sumber daya Bahasa Anda di portal Azure
2. Dari menu sisi kiri, di bawah bagian Manajemen Sumber Daya, pilih Fitur
3. Aktifkan fitur Klasifikasi teks kustom/Pengenalan Entitas Bernama Kustom
4. Sambungkan akun penyimpanan
5. Pilih Terapkan

Penting

• Pastikan sumber daya Bahasa Anda memiliki peran kontributor data blob penyimpanan yang ditetapkan pada akun penyimpanan yang Anda sambungkan.

Mengatur peran untuk sumber daya Bahasa Azure AI dan akun penyimpanan Anda

Gunakan langkah-langkah berikut dalam menetapkan peran yang diperlukan untuk akun penyimpanan dan sumber daya Bahasa Anda.

Peran untuk sumber daya Bahasa Azure AI Anda

1. Buka akun penyimpanan atau sumber daya bahasa Anda di portal Azure.

2. Pilih Access Control (IAM) di menu panel navigasi kiri.

3. Pilih Tambahkan untuk Menambahkan Penetapan Peran, dan pilih peran yang sesuai untuk akun Anda.

   Anda harus memiliki peran pemilik atau kontributor yang ditetapkan pada sumber daya Bahasa.

4. Dalam Tetapkan akses ke, pilih Pengguna, grup, atau perwakilan layanan

5. Pilih opsi Pilih anggota

6. Pilih nama pengguna Anda. Anda dapat mencari nama pengguna di bidang Pilih. Ulangi proses ini untuk semua peran.

7. Ulangi langkah-langkah ini untuk semua akun pengguna yang memerlukan akses ke sumber daya ini.

Peran untuk akun penyimpanan Anda

1. Buka akun penyimpanan di portal Microsoft Azure.
2. Pilih Access Control (IAM) di menu panel navigasi kiri.
3. Pilih Tambahkan untuk Menambahkan Penetapan Peran, dan pilih peran Kontributor data blob penyimpanan di akun penyimpanan.
4. Dalam Tetapkan akses ke, pilih Identitas terkelola.
5. Pilih opsi Pilih anggota
6. Pilih langganan Anda, dan Bahasa sebagai identitas terkelola. Anda dapat mencari nama pengguna di bidang Pilih.

Penting

Jika Anda memiliki jaringan virtual atau titik akhir privat, pastikan untuk memilih Izinkan layanan Azure pada daftar layanan tepercaya untuk mengakses akun penyimpanan ini di portal Azure.

Mengaktifkan CORS untuk akun penyimpanan Anda

Pastikan untuk mengizinkan metode (GET, PUT, DELETE) saat mengaktifkan Berbagi Sumber Daya Lintas Asal (CORS). Tetapkan bidang asal yang diizinkan ke https://language.cognitive.azure.com. Izinkan semua header dengan menambahkan * ke nilai header yang diizinkan, dan tetapkan usia maksimum ke 500.

Membuat proyek klasifikasi kustom

Setelah sumber daya serta kontainer penyimpanan Anda dikonfigurasi, buat proyek klasifikasi teks baru. Proyek adalah area kerja untuk membangun model AI kustom berdasarkan data Anda. Proyek Anda hanya dapat diakses oleh Anda dan orang lain yang memiliki akses kontributor ke sumber daya Azure yang digunakan. Jika data telah diberi label, Anda dapat mengimpornya untuk memulai.

Studio Bahasa

1. Masuk ke Studio Bahasa. Sebuah jendela akan muncul yang memungkinkan Anda memilih langganan dan sumber daya Language. Pilih sumber daya Bahasa Anda.

2. Di bagian Klasifikasi teks di Studio Bahasa, pilih Klasifikasi teks kustom.

   

3. Pilih Buat proyek baru dari menu atas di halaman proyek Anda. Membuat proyek akan memungkinkan Anda melabeli data, melatih, mengevaluasi, meningkatkan, dan menyebarkan model Anda.

   

4. Setelah Anda mengeklik, Buat proyek baru, layar akan muncul untuk memungkinkan Anda menghubungkan akun penyimpanan Anda. Jika Anda sudah menyambungkan akun penyimpanan, Anda akan melihat akun penyimpanan tersambung. Jika tidak, pilih akun penyimpanan Anda dari menu dropdown yang muncul dan pilih akun penyimpanan Koneksi; ini akan mengatur peran yang diperlukan untuk akun penyimpanan Anda. Langkah ini mungkin akan mengembalikan kesalahan jika Anda tidak ditetapkan sebagai pemilik di akun penyimpanan.

   Catatan

   • Cukup lakukan langkah ini sekali untuk setiap sumber daya baru yang Anda gunakan.
   • Proses ini tidak dapat diubah, jika Anda menghubungkan akun penyimpanan ke sumber daya Bahasa, Anda tidak dapat memutuskannya nanti.
   • Anda hanya dapat menghubungkan sumber daya Bahasa Anda ke satu akun penyimpanan.

   

5. Pilih jenis proyek. Anda dapat membuat proyek Klasifikasi multi-label yang setiap dokumennya dapat disertakan dalam satu atau beberapa kelas atau proyek Klasifikasi label tunggal yang setiap dokumennya hanya dapat disertakan dalam satu kelas. Jenis yang dipilih tidak dapat diubah nanti. Pelajari selengkapnya jenis proyek

   

6. Masukkan informasi proyek, termasuk nama, deskripsi, dan bahasa pemrogram file dalam dokumen di proyek Anda. Jika Anda menggunakan contoh himpunan data, pilih Bahasa Inggris. Anda tidak akan dapat mengubah nama proyek Anda nanti. Pilih Selanjutnya.

   Tip

   Himpunan data Anda tidak harus sepenuhnya dalam bahasa pemrogram yang sama. Anda dapat memiliki beberapa dokumen, masing-masing dengan bahasa yang didukung berbeda. Jika himpunan data Anda berisi dokumen dari bahasa yang berbeda atau jika Anda mengharapkan teks dari bahasa yang berbeda selama waktu proses, pilih opsi aktifkan himpunan data multi-bahasa saat Anda memasukkan informasi dasar untuk proyek Anda. Opsi ini dapat diaktifkan nanti dari halaman Pengaturan proyek.

7. Pilih kontainer tempat Anda mengunggah himpunan data Anda.

   Catatan

   Jika Anda telah memberi label data Anda pastikan data mengikuti format yang didukung dan pilih Ya, dokumen saya sudah diberi label dan saya telah memformat file label JSON dan memilih file label dari menu drop-down di bawah ini.

   Jika Anda menggunakan salah satu contoh himpunan data, gunakan file yang disertakan webOfScience_labelsFile atau movieLabels json. Kemudian pilih Berikutnya.

8. Tinjau data yang Anda masukkan dan pilih Buat Project.

REST API

Untuk mulai membuat model klasifikasi kustom, Anda harus membuat proyek. Membuat proyek akan memungkinkan Anda melabeli data, melatih, mengevaluasi, meningkatkan, dan menyebarkan model Anda.

Catatan

Nama proyek peka huruf besar/kecil untuk semua operasi.

Buat permintaan POST menggunakan URL, header, serta badan JSON berikut ini untuk membuat proyek Anda.

Minta URL

Gunakan URL berikut ini untuk membuat proyek. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

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

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

Gunakan JSON berikut dalam permintaan Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

Klasifikasi multi-label

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "customMultiLabelClassification",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Tombol	Placeholder	Value	Contoh
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
bahasa	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multi-bahasa, pilih kode bahasa dari sebagian besar dokumen. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang kode bahasa yang didukung.	en-us
projectKind	customMultiLabelClassification	Jenis proyek Anda.	customMultiLabelClassification
multilingual	true	Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam kumpulan data Anda dan ketika model Anda disebarkan, Anda dapat membuat kueri model dalam bahasa apa pun yang didukung (tidak harus disertakan dalam dokumen pelatihan Anda. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multi-bahasa.	true
storageInputContainerName	{CONTAINER-NAME}	Nama kontainer penyimpanan Azure tempat Anda mengunggah dokumen.	myContainer

Klasifikasi Label Tunggal

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "customSingleLabelClassification",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Tombol	Placeholder	Value	Contoh
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
bahasa	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multi-bahasa, pilih kode bahasa dari sebagian besar dokumen. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang kode bahasa yang didukung.	en-us
projectKind	customSingleLabelClassification	Jenis proyek Anda.	customSingleLabelClassification
multilingual	true	Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam kumpulan data Anda dan ketika model Anda disebarkan, Anda dapat membuat kueri model dalam bahasa apa pun yang didukung (tidak harus disertakan dalam dokumen pelatihan Anda. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multi-bahasa.	true
storageInputContainerName	{CONTAINER-NAME}	Nama kontainer penyimpanan Azure tempat Anda mengunggah dokumen.	myContainer

Permintaan ini akan menghasilkan respons 201, yang berarti bahwa proyek telah dibuat.

Permintaan ini akan mengembalikan kesalahan jika:

• Sumber daya yang dipilih tidak memiliki izin yang sesuai untuk akun penyimpanan.

Mengimpor proyek klasifikasi teks kustom

Jika Anda telah memberi label data, Anda dapat menggunakannya dengan memulai layanan. Pastikan bahwa data berlabel Anda mengikuti format data yang diterima.

Studio Bahasa

1. Masuk ke Studio Bahasa. Sebuah jendela akan muncul yang memungkinkan Anda memilih langganan dan sumber daya Language. Pilih sumber daya Bahasa Anda.

2. Di bagian Klasifikasi teks di Studio Bahasa, pilih Klasifikasi teks kustom.

   

3. Pilih Buat proyek baru dari menu atas di halaman proyek Anda. Membuat proyek akan memungkinkan Anda melabeli data, melatih, mengevaluasi, meningkatkan, dan menyebarkan model Anda.

   

4. Setelah memilih Buat proyek baru, layar akan muncul untuk memungkinkan Anda menyambungkan akun penyimpanan Anda. Jika tidak dapat menemukan akun penyimpanan Anda, pastikan Anda membuat sumber daya menggunakan langkah-langkah yang disarankan. Jika sudah menyambungkan akun penyimpanan ke sumber daya Bahasa, Anda akan melihat akun penyimpanan Anda tersambung.

   Catatan

   • Cukup lakukan langkah ini sekali untuk setiap sumber daya baru yang Anda gunakan.
   • Proses ini tidak dapat diubah, jika Anda menghubungkan akun penyimpanan ke sumber daya Bahasa, Anda tidak dapat memutuskannya nanti.
   • Anda hanya dapat menghubungkan sumber daya Bahasa Anda ke satu akun penyimpanan.

   

5. Pilih jenis proyek. Anda dapat membuat proyek Klasifikasi multi-label yang setiap dokumennya dapat disertakan dalam satu atau beberapa kelas atau proyek Klasifikasi label tunggal yang setiap dokumennya hanya dapat disertakan dalam satu kelas. Jenis yang dipilih tidak dapat diubah nanti.

   

6. Masukkan informasi proyek, termasuk nama, deskripsi, dan bahasa pemrogram file dalam dokumen di proyek Anda. Anda tidak akan dapat mengubah nama proyek Anda nanti. Pilih Selanjutnya.

   Tip

   Himpunan data Anda tidak harus sepenuhnya dalam bahasa pemrogram yang sama. Anda dapat memiliki beberapa dokumen, masing-masing dengan bahasa yang didukung berbeda. Jika himpunan data Anda berisi dokumen dari bahasa yang berbeda atau jika Anda mengharapkan teks dari bahasa yang berbeda selama waktu proses, pilih opsi aktifkan himpunan data multi-bahasa saat Anda memasukkan informasi dasar untuk proyek Anda. Opsi ini dapat diaktifkan nanti dari halaman Pengaturan proyek.

7. Pilih kontainer tempat Anda mengunggah himpunan data Anda.

8. Pilih Ya, dokumen saya sudah diberi label dan saya telah memformat file label JSON dan memilih file label dari menu drop-down di bawah ini untuk mengimpor file label JSON Anda. Pastikan sudah mengikuti format yang didukung.

9. Pilih Selanjutnya.

10. Tinjau data yang Anda masukkan dan pilih Buat Project.

REST API

Kirim permintaan POST menggunakan URL, header, dan isi JSON berikut untuk mengimpor file label Anda. Pastikan file label Anda mengikuti format yang diterima.

Jika sebuah proyek dengan nama yang sama sudah ada, data proyek tersebut diganti.

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

Placeholder	Value	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 terbaru yang dirilis. Pelajari 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

Gunakan JSON berikut dalam permintaan Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

Klasifikasi multi-label

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

Tombol	Placeholder	Value	Contoh
versi-api	{API-VERSION}	Versi API yang Anda panggil. Versi yang digunakan di sini harus versi API yang sama dengan di URL. Pelajari selengkapnya tentang versi API lain yang tersedia	2022-05-01
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
projectKind	customMultiLabelClassification	Jenis proyek Anda.	customMultiLabelClassification
bahasa	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multi-bahasa, pilih kode bahasa dari sebagian besar dokumen. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multi-bahasa.	en-us
multilingual	true	Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam kumpulan data Anda dan ketika model Anda disebarkan, Anda dapat membuat kueri model dalam bahasa apa pun yang didukung (tidak harus disertakan dalam dokumen pelatihan Anda. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multi-bahasa.	true
storageInputContainerName	{CONTAINER-NAME}	Nama kontainer penyimpanan Azure tempat Anda mengunggah dokumen.	myContainer
kelas	[]	Array yang berisi semua kelas yang Anda miliki dalam proyek. Ini adalah kelas yang Anda inginkan untuk mengklasifikasikan dokumen Anda.	[]
Dokumen	[]	Array yang berisi semua dokumen dalam proyek Anda dan kelas yang diberi label untuk dokumen ini.	[]
lokasi	{DOCUMENT-NAME}	Lokasi dokumen dalam kontainer penyimpanan. Karena semua dokumen berada di akar kontainer, ini akan menjadi nama dokumen.	doc1.txt
himpunan data	{DATASET}	Set pengujian yang akan digunakan untuk dokumen ini saat dibagi sebelum pelatihan. Lihat Cara melatih model untuk informasi selengkapnya tentang pemisahan data. Nilai yang mungkin untuk bidang ini adalah Train dan Test.	Train

Klasifikasi Label Tunggal

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

Tombol	Placeholder	Value	Contoh
versi-api	{API-VERSION}	Versi API yang Anda panggil. Versi yang digunakan di sini harus versi API yang sama dengan di URL.	2022-05-01
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
projectKind	customSingleLabelClassification	Jenis proyek Anda.	customSingleLabelClassification
bahasa	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multi-bahasa, pilih kode bahasa dari sebagian besar dokumen. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang kode bahasa yang didukung.	en-us
multilingual	true	Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam kumpulan data Anda dan ketika model Anda disebarkan, Anda dapat membuat kueri model dalam bahasa apa pun yang didukung (tidak harus disertakan dalam dokumen pelatihan Anda. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multi-bahasa.	true
storageInputContainerName	{CONTAINER-NAME}	Nama kontainer penyimpanan Azure tempat Anda mengunggah dokumen.	myContainer
kelas	[]	Array yang berisi semua kelas yang Anda miliki dalam proyek. Ini adalah kelas yang Anda inginkan untuk mengklasifikasikan dokumen Anda.	[]
Dokumen	[]	Array yang berisi semua dokumen dalam proyek Anda dan kelas yang dimiliki dokumen ini.	[]
lokasi	{DOCUMENT-NAME}	Lokasi dokumen dalam kontainer penyimpanan. Karena semua dokumen berada di akar kontainer, ini akan menjadi nama dokumen.	doc1.txt
himpunan data	{DATASET}	Set pengujian yang akan digunakan untuk dokumen ini saat dibagi sebelum pelatihan. Lihat Cara melatih model untuk mempelajari selengkapnya tentang pemisahan data. Nilai yang mungkin untuk bidang ini adalah Train dan Test.	Train

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}/import/jobs/{JOB-ID}?api-version={API-VERSION}

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

Kemungkinan skenario kesalahan untuk permintaan ini:

• Sumber daya yang dipilih tidak memiliki izin yang sesuai untuk akun penyimpanan.
• storageInputContainerName yang ditentukan tidak ada.
• Kode bahasa tidak valid digunakan, atau jika jenis kode bahasa bukan string.
• Nilai multilingual adalah string dan bukan boolean.

Mendapatkan detail proyek

Studio Bahasa

1. Buka halaman pengaturan proyek di Language Studio.

2. Anda dapat melihat detail proyek.

3. Di halaman ini Anda dapat memperbarui deskripsi proyek dan mengaktifkan/menonaktifkan himpunan data Multi-bahasa dalam pengaturan proyek.

4. Anda juga dapat melihat akun penyimpanan dan kontainer yang tersambung ke sumber daya Bahasa Anda.

5. Anda juga dapat mengambil kunci primer sumber daya dari halaman ini.

   

REST API

Untuk mendapatkan detail proyek klasifikasi teks kustom, kirimkan permintaan GET menggunakan URL dan header berikut. Ganti nilai tempat penampung dengan nilai Anda sendiri.

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

Placeholder	Value	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 Respons

Setelah mengirim permintaan, Anda akan mendapatkan respons berikut.

{
  "createdDateTime": "2022-04-23T13:39:09.384Z",
  "lastModifiedDateTime": "2022-04-23T13:39:09.384Z",
  "lastTrainedDateTime": "2022-04-23T13:39:09.384Z",
  "lastDeployedDateTime": "2022-04-23T13:39:09.384Z",
  "projectKind": "customSingleLabelClassification",
  "storageInputContainerName": "{CONTAINER-NAME}",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "Project description",
  "language": "{LANGUAGE-CODE}"
}

Value	tempat penampung	Deskripsi	Contoh
projectKind	customSingleLabelClassification	Jenis proyek Anda.	Nilai ini dapat berupa customSingleLabelClassification atau customMultiLabelClassification.
storageInputContainerName	{CONTAINER-NAME}	Nama kontainer penyimpanan Azure tempat Anda mengunggah dokumen.	myContainer
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
multilingual		Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam himpunan data Anda. Saat model disebarkan, Anda dapat mengkueri model dalam bahasa yang didukung (belum tentu disertakan dalam dokumen pelatihan Anda. Untuk informasi selengkapnya tentang dukungan multi-bahasa, lihat dukungan bahasa.	true
language	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multi-bahasa, pilih kode bahasa dari sebagian besar dokumen. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang kode bahasa yang didukung.	en-us

Setelah Anda mengirim permintaan API, Anda akan menerima respons 200 yang menunjukkan keberhasilan dan isi respons JSON dengan detail proyek Anda.

Menghapus proyek

Studio Bahasa

Jika Anda tidak memerlukan proyek lagi, Anda dapat menghapus proyek menggunakan Language Studio. Pilih Klasifikasi teks kustom di bagian atas, lalu pilih proyek yang ingin Anda hapus. Pilih Hapus dari menu atas untuk menghapus proyek.

REST API

Saat tidak lagi membutuhkan proyek, Anda dapat menghapusnya dengan permintaan DELETE berikut. Ganti nilai tempat penampung dengan nilai Anda sendiri.

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

Placeholder	Value	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 terbaru yang dirilis. Pelajari 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 mengirim permintaan API, Anda akan menerima respons 202 yang menunjukkan keberhasilan, yang berarti proyek Anda telah dihapus. Hasil call yang sukses dengan header Operation-Location yang digunakan untuk memeriksa status pekerjaan.

Langkah berikutnya

• Anda harus memiliki gagasan tentang skema proyek yang akan digunakan untuk memberikan label pada data Anda.

• Setelah proyek dibuat, Anda dapat memulai memberi label pada data, yang akan menginformasikan model klasifikasi teks Anda cara menafsirkan teks, dan digunakan untuk pelatihan dan evaluasi.