Cara membuat proyek CLU

Gunakan artikel ini untuk mempelajari cara menyiapkan persyaratan ini dan membuat proyek.

Prasyarat

Sebelum Anda mulai menggunakan CLU, Anda akan membutuhkan beberapa hal:

• Langganan Azure - Buat langganan gratis.
• Sumber daya Bahasa Azure AI

Membuat sumber daya Bahasa

Sebelum mulai menggunakan CLU, Anda memerlukan sumber daya Bahasa Azure AI.

Catatan

• Anda harus memiliki peran pemilik yang ditetapkan pada grup sumber daya untuk membuat sumber daya Bahasa.

Buat sumber daya baru menggunakan portal Microsoft Azure

1. Masuk ke portal Azure untuk membuat sumber daya Bahasa Azure AI baru.

2. Pilih Buat sumber daya baru

3. Pada jendela yang muncul, cari Layanan bahasa

4. Pilih Buat

5. Buat sumber daya Bahasa dengan detail berikut.

   Detail instans	Nilai yang diperlukan
   Wilayah	Salah satu wilayah yang didukung untuk sumber daya Bahasa Anda.
   Nama	Nama yang diperlukan untuk sumber daya Bahasa Anda
   Tingkatan harga	Salah satu tingkat harga yang didukung untuk sumber daya Bahasa Anda.

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	Langganan Azure Anda
Grup sumber daya Azure	Grup sumber daya Azure Anda
Nama sumber daya Azure	Nama sumber daya Bahasa Anda
Lokasi	Wilayah yang didukung untuk sumber daya Bahasa Anda.
Tingkatan harga	Tingkat harga yang didukung 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

Masuk ke Language Studio

1. Buka Language Studio dan masuk dengan akun Azure Anda.

2. Di jendela Pilih sumber daya bahasa yang muncul, temukan langganan Azure Anda, dan pilih sumber daya Bahasa Anda. Jika Anda tidak memiliki sumber daya, Anda bisa membuatnya.

   Detail instans	Nilai yang diperlukan
   Langganan Azure	Langganan Azure Anda.
   Grup sumber daya Azure	Nama grup sumber daya Azure Anda.
   Nama sumber daya Azure	Nama sumber daya Azure Anda.
   Lokasi	Salah satu wilayah yang didukung untuk sumber daya Bahasa Anda. Misalnya, "US Barat 2".
   Tingkatan harga	Salah satu tingkat harga yang valid untuk sumber daya Bahasa Anda. Anda dapat menggunakan tingkat Gratis (F0) untuk mencoba layanan.

   

Membuat proyek percakapan

Setelah Anda membuat sumber daya Bahasa, buat proyek Pemahaman Bahasa Percakapan.

Studio Bahasa

1. Di Studio Bahasa, temukan bagian bernama Pahami pertanyaan dan bahasa percakapan dan pilih Pemahaman bahasa percakapan.
   

2. Ini akan membawa Anda ke halaman Proyek pemahaman bahasa percakapan. Pilih Buat proyek baru.

   

Untuk membuat proyek baru, Anda perlu memberikan detail berikut:

Nilai	Deskripsi
Nama	Nama untuk proyek Anda. Setelah dibuat, itu tidak dapat diubah
Deskripsi	Deskripsi proyek opsional.
Bahasa utama ucapan	Bahasa utama proyek Anda. Data pelatihan Anda terutama harus dalam bahasa ini.
Mengaktifkan multi-bahasa	Apakah Anda ingin mengaktifkan proyek Anda untuk mendukung beberapa bahasa sekaligus.

Setelah selesai, pilih Berikutnya dan tinjau detailnya. Pilih buat untuk menyelesaikan proses. Anda sekarang akan melihat layar Bangun Skema di proyek Anda.

REST API

Buat permintaan PATCH menggunakan URL, header, serta isi JSON berikut ini untuk membuat proyek baru.

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-conversations/projects/{PROJECT-NAME}?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.	2023-04-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.
Content-Type	'application/merge-patch+json'

Isi

Gunakan sampel JSON berikut sebagai badan Anda.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

Tombol	Placeholder	Nilai	Contoh
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	EmailApp
language	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk ucapan 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 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 multibahasa.	true

Impor proyek

Studio Bahasa

Anda dapat mengekspor proyek Pemahaman Bahasa Percakapan sebagai file JSON kapan saja dengan membuka halaman proyek percakapan, memilih proyek, dan dari menu atas mengeklik Ekspor.

Proyek ini dapat dilaporkan kembali sebagai proyek baru. Jika Anda mengimpor proyek dengan nama yang sama persis, proyek tersebut menggantikan data proyek dengan data proyek yang baru diimpor.

Jika Anda memiliki aplikasi LUIS yang ada, Anda dapat mengimpor aplikasi LUIS JSON ke LUIS Percakapan secara langsung, dan itu akan membuat proyek Percakapan dengan semua bagian yang saat ini tersedia: Niat, ML entitas, dan ucapan. Lihat artikel migrasi LUIS untuk informasi selengkapnya.

Untuk mengimpor proyek, pilih tombol panah di samping Buat proyek baru dan pilih Impor, lalu pilih file JSON LUIS atau Luis Lusa Bahasa Percakapan.

REST API

Anda dapat mengimpor CLU JSON ke dalam layanan

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

Minta URL

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?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, dan harus cocok dengan nama proyek dalam file JSON yang Anda impor.	EmailAppDemo
{API-VERSION}	Versi API yang Anda panggil.	2023-04-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

Isi JSON yang Anda kirim mirip dengan contoh berikut. Lihat dokumentasi referensi untuk detail selengkapnya tentang objek JSON.

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

Tombol	Placeholder	Nilai	Contoh
{API-VERSION}	Versi API yang Anda panggil.	2023-04-01
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	EmailAppDemo
language	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk ucapan 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 bahasa apa pun yang didukung 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

Setelah permintaan berhasil, respons API akan berisi operation-location header dengan URL yang dapat Anda gunakan untuk memeriksa status pekerjaan impor. Ini diformat seperti ini:

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

Mengekspor proyek

Studio Bahasa

Anda dapat mengekspor proyek LUIS Percakapan sebagai file JSON kapan saja dengan membuka halaman proyek percakapan, memilih proyek, dan menekan Ekspor.

REST API

Anda dapat mengekspor proyek Pemahaman Bahasa Percakapan sebagai file JSON kapan saja.

Buat permintaan POST menggunakan URL, header, dan isi JSON berikut untuk mengekspor 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-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&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.	EmailApp
{API-VERSION}	Versi API yang Anda panggil.	2023-04-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. 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 detail proyek CLU

Studio Bahasa

1. Buka halaman pengaturan proyek di Studio Bahasa.

2. Anda dapat melihat detail proyek.

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

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

   

REST API

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

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?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.	2023-04-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-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}"
}

Setelah mengirim permintaan API, Anda akan menerima respons yang 200 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 Proyek dari menu navigasi kiri, pilih proyek yang ingin Anda hapus, lalu pilih Hapus dari menu atas.

REST API

Jika Anda tidak memerlukan proyek lagi, Anda dapat menghapus proyek menggunakan API.

Buat permintaan HAPUS menggunakan URL, header, dan isi JSON berikut untuk menghapus proyek pemahaman bahasa percakapan.

Minta URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?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.	2023-04-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.

Langkah berikutnya

Membangun skema