Cara membuat proyek analisis sentimen kustom

Gunakan artikel ini untuk mempelajari cara menyiapkan persyaratan untuk memulai dengan Analisis sentimen kustom dan membuat proyek.

Prasyarat

Sebelum mulai menggunakan Analisis sentimen kustom, Anda memerlukan:

• Langganan Azure - Buat langganan gratis.

Membuat sumber daya Bahasa

Sebelum mulai menggunakan Analisis sentimen kustom, Anda memerlukan sumber daya Bahasa Azure. Disarankan untuk membuat sumber daya Bahasa Anda dan menyambungkan akun penyimpanan ke sumber daya tersebut di portal Azure. Membuat sumber daya di portal Azure memungkinkan Anda membuat akun penyimpanan Azure secara bersamaan, dengan semua izin yang diperlukan telah dikonfigurasi sebelumnya. Anda juga dapat membaca lebih lanjut dalam artikel untuk mempelajari cara menggunakan sumber daya yang sudah ada sebelumnya, dan mengonfigurasinya agar berfungsi dengan Analisis sentimen kustom.

Anda juga memerlukan akun penyimpanan Azure tempat Anda akan mengunggah .txt dokumen 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.

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 layanan ini dari fitur kustom. Pilih Lanjutkan untuk membuat sumber daya Anda di bagian bawah layar.

   

3. Buat sumber daya Bahasa dengan detail berikut.

   Nama	Deskripsi
   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	Wilayah sumber daya Bahasa Anda. Misalnya, "US Barat 2".
   Nama	Nama sumber daya Anda.
   Tingkat harga	Tingkat harga untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat Gratis (F0) untuk mencoba layanan.

   Catatan

   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.

4. Di bagian layanan ini, pilih akun penyimpanan yang sudah ada atau pilih Akun penyimpanan baru. Nilai ini untuk membantu Anda memulai, dan belum tentu menjadi nilai akun penyimpanan yang ingin Anda gunakan di lingkungan produksi. Untuk menghindari latensi selama membangun proyek Anda yang terhubung 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 dicentang. Lalu, pilih Tinjau + buat di bagian bawah halaman, kemudian pilih Buat.

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
Tingkatan harga	Tingkat harga sumber daya Bahasa Anda.

Penting

• Pastikan Anda mengaktifkan Identitas Terkelola saat membuat sumber daya Bahasa.
• Membaca dan mengonfirmasi pemberitahuan AI yang Bertanggung jawab

Untuk menggunakan layanan ini, Anda harus membuat akun penyimpanan Azure jika Anda belum memilikinya.

Membuat sumber daya Bahasa baru menggunakan 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 di mana sumber daya Anda dihosting.
sku	Tingkat harga sumber daya Anda.
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 Anda tidak dapat dikembalikan, tidak dapat diputuskan nanti.
• Anda hanya dapat menghubungkan sumber daya bahasa Anda ke satu akun penyimpanan.

Menggunakan sumber daya Bahasa yang sudah ada sebelumnya

Persyaratan	Deskripsi
Wilayah	Jika belum memiliki sumber daya, Anda harus membuat sumber daya baru di wilayah yang didukung.
Tingkat harga	tingkat harga untuk sumber daya Anda.
Identitas terkelola	Pastikan pengaturan identitas terkelola sumber daya diaktifkan. Jika tidak, baca bagian selanjutnya.

Untuk menggunakan layanan ini, 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 kustom untuk sumber daya Anda

Pastikan untuk mengaktifkan fitur kustom layanan ini 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 kustom layanan ini
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 mengatur peran yang diperlukan untuk sumber daya Bahasa dan akun penyimpanan 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 analisis sentimen kustom

Setelah kontainer sumber daya dan penyimpanan Anda dikonfigurasi, buat proyek Analisis sentimen kustom 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 Language Studio. Sebuah jendela akan muncul yang memungkinkan Anda memilih langganan dan sumber daya Language. Pilih sumber daya Bahasa yang Anda buat pada langkah di atas.

2. Pilih fitur yang ingin Anda gunakan di Language Studio.

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

   

4. Masukkan informasi proyek, termasuk nama, deskripsi, dan bahasa pemrogram file dalam proyek Anda. Jika Anda menggunakan contoh himpunan data, pilih Bahasa Inggris. Anda tidak 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 kumpulan data Anda berisi dokumen dari bahasa yang berbeda atau jika Anda mengharapkan teks dari bahasa yang berbeda selama waktu proses, pilih opsi aktifkan kumpulan data multibahasa saat Anda memasukkan informasi dasar untuk proyek Anda. Opsi ini dapat diaktifkan nanti dari halaman Pengaturan project.

5. Setelah Anda memilih Buat proyek baru, jendela akan muncul untuk memungkinkan Anda menyambungkan akun penyimpanan Anda. Jika Anda telah menghubungkan akun penyimpanan, Anda akan melihat akun penyimpanan tersambung. Jika tidak, pilih akun penyimpanan Anda dari menu dropdown yang muncul dan pilih Sambungkan akun penyimpanan; 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

   • Anda hanya perlu melakukan 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, Anda tidak dapat memutuskannya nanti.
   • Anda hanya dapat menghubungkan sumber daya Bahasa Anda ke satu akun penyimpanan.

6. Pilih penampung tempat Anda mengunggah kumpulan data Anda.

7. Jika Anda telah memberi label data pastikan data mengikuti format yang didukung dan pilih Ya, file saya sudah diberi label dan saya telah memformat file label JSON dan memilih file label dari menu drop-down. Pilih Selanjutnya. Jika Anda menggunakan himpunan data dari Mulai Cepat, Anda tidak perlu meninjau pemformatan file label JSON.

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

REST API

Untuk mulai membuat model analisis sentimen kustom, Anda perlu 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.

URL Permintaan

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}

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 terbaru yang dirilis. Lihat Siklus hidup model untuk mempelajari selengkapnya tentang versi API lain yang tersedia.	2023-04-15-preview

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 JSON berikut dalam permintaan Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

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

Kunci	Tempat penampung	Nilai	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 multibahasa, pilih kode bahasa dari sebagian besar dokumen.	en-us
projectKind	CustomTextSentiment	Jenis proyek Anda.	CustomTextSentiment
multilingual	true	Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam himpunan data Anda dan saat model Anda disebarkan, Anda dapat mengkueri model dalam bahasa apa pun yang didukung (belum tentu yang disertakan dalam dokumen pelatihan Anda).	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 analisis sentimen kustom

Studio Bahasa

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

2. Pilih fitur yang ingin Anda gunakan.

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

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

5. 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 kumpulan data Anda berisi dokumen dari bahasa yang berbeda atau jika Anda mengharapkan teks dari bahasa yang berbeda selama waktu proses, pilih opsi aktifkan kumpulan data multibahasa saat Anda memasukkan informasi dasar untuk proyek Anda. Opsi ini dapat diaktifkan nanti dari halaman Pengaturan project.

6. Pilih penampung tempat Anda mengunggah kumpulan data Anda.

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

8. Pilih Selanjutnya.

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

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}

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 terbaru yang dirilis. Pelajari selengkapnya tentang versi API lain yang tersedia	2023-04-15-preview

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 JSON berikut dalam permintaan Anda. Ganti nilai tempat penampung di bawah ini dengan nilai Anda sendiri.

{
  "projectFileVersion": "2023-04-15-preview",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "CustomTextSentiment",
    "storageInputContainerName": "text-sentiment",
    "projectName": "TestSentiment",
    "multilingual": false,
    "description": "This is a Custom sentiment analysis project.",
    "language": "en-us"
  },
  "assets": {
    "projectKind": "CustomTextSentiment",
    "documents": [
      {
        "location": "documents/document_1.txt",
        "language": "en-us",
        "sentimentSpans": [
            {
                "category": "negative",
                "offset": 0,
                "length": 28
            }
        ]
      },
      {
          "location": "documents/document_2.txt",
          "language": "en-us",
          "sentimentSpans": [
              {
                  "category": "negative",
                  "offset": 0,
                  "length": 24
              }
          ]
      },
      {
          "location": "documents/document_3.txt",
          "language": "en-us",
          "sentimentSpans": [
              {
                  "category": "neutral",
                  "offset": 0,
                  "length": 18
              }
          ]
      }
    ]
  }
}

Kunci	Tempat penampung	Nilai	Contoh
versi-api	{API-VERSION}	Versi API yang Anda panggil. Versi yang digunakan di sini harus versi API yang sama di URL. Pelajari selengkapnya tentang versi API lain yang tersedia	2023-04-15-preview
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
projectKind	CustomTextSentiment	Jenis proyek Anda.	CustomTextSentiment
bahasa	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multibahasa, pilih kode bahasa dari sebagian besar dokumen. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multibahasa.	en-us
multilingual	true	Nilai boolean yang memungkinkan Anda memiliki dokumen dalam beberapa bahasa dalam himpunan data Anda dan saat model Anda disebarkan, Anda dapat mengkueri model dalam bahasa yang didukung yang belum tentu disertakan dalam dokumen pelatihan Anda. Lihat dukungan bahasa untuk mempelajari selengkapnya tentang dukungan multibahasa.	true
storageInputContainerName	{CONTAINER-NAME}	Nama kontainer penyimpanan Azure tempat Anda mengunggah dokumen.	myContainer
dokumen	[]	Array yang berisi semua dokumen dalam proyek Anda dan kelas apa yang diberi label untuk dokumen ini.	[]
lokasi	{DOCUMENT-NAME}	Lokasi dokumen dalam kontainer penyimpanan. Karena semua dokumen berada di akar kontainer, ini harus menjadi nama dokumen.	doc1.txt
sentimentSpans	{sentimentSpans}	Sentimen dokumen (positif, netral, negatif), posisi di mana sentimen dimulai, dan panjangnya.	[]

Setelah Anda 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:

• 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 analisis sentimen 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}

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.	2023-04-15-preview

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.

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

Nilai	tempat penampung	Deskripsi	Contoh
projectKind	CustomTextSentiment	Jenis proyek Anda.	CustomTextSentiment
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.	true
language	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen yang digunakan dalam proyek Anda. Jika proyek Anda adalah proyek multibahasa, pilih kode bahasa dari sebagian besar dokumen.	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 fitur yang Anda gunakan 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}

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 terbaru yang dirilis. Pelajari selengkapnya tentang versi API lain yang tersedia	2023-04-15-preview

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 yang 202 menunjukkan keberhasilan, yang berarti proyek Anda telah dihapus. Hasil call yang sukses dengan header Operation-Location yang digunakan untuk memeriksa status pekerjaan.

Langkah berikutnya

• Gambaran umum analisis sentimen