Mengirim permintaan prediksi ke penyebaran

Setelah penyebaran berhasil ditambahkan, Anda dapat mengkueri penyebaran untuk mengetahui niat dan prediksi entitas dari ujaran Anda berdasarkan model yang ditentukan pada penyebaran. Anda dapat menanyakan penerapan secara terprogram melalui prediction API atau melalui pustaka klien (Azure SDK).

Menguji model yang disebarkan

Anda dapat menggunakan Studio Bahasa untuk mengirimkan ucapan, mendapatkan prediksi dan memvisualisasikan hasilnya.

Untuk menguji model disebarkan dari dalam Language Studio:

1. Pilih Menguji penyebaran dari menu sebelah kiri.

2. Untuk proyek multibahasa, dari menu dropdown Pilih bahasa teks , pilih bahasa ucapan yang sedang Anda uji.

3. Dari menu dropdown Nama penyebaran , pilih nama penyebaran yang sesuai dengan model yang ingin Anda uji. Anda hanya dapat menguji model yang ditetapkan untuk penyebaran.

4. Dalam kotak teks, masukkan ucapan untuk diuji. Misalnya, jika Anda membuat aplikasi untuk ucapan terkait email, Anda dapat memasukkan Hapus email ini.

5. Di bagian atas halaman, pilih Jalankan pengujian.

6. Setelah menjalankan pengujian, Anda akan melihat respons model dalam hasilnya. Anda dapat melihat hasilnya dalam tampilan kartu entitas atau melihatnya dalam format JSON.

---

Kirim permintaan pemahaman bahasa percakapan

Studio Bahasa

1. Setelah pekerjaan penyebaran berhasil diselesaikan, pilih penyebaran yang ingin Anda gunakan dan dari menu atas pilih Dapatkan URL prediksi.

   

2. Di jendela yang muncul, salin sampel URL dan isi permintaan ke baris perintah Anda.

3. Ganti <YOUR_QUERY_HERE> dengan teks sebenarnya yang ingin Anda kirim untuk mengekstrak niat dan entitas.

4. Kirimkan permintaan cURL POST di terminal atau perintah Anda. Anda akan menerima respons 202 dengan hasil API jika permintaan berhasil.

REST API

Pertama, Anda harus mendapatkan kunci sumber daya dan titik akhir:

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

Tanya model Anda

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

URL Permintaan

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

Tempat penampung	Nilai	Contoh
{ENDPOINT}	Titik akhir untuk mengautentikasi permintaan API Anda.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Versi API yang Anda panggil.	2023-04-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

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Kunci	Tempat penampung	Nilai	Contoh
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	Ucapan yang ingin Anda prediksi niat dan ekstrak entitasnya.	"Read Matt's email
projectName	{PROJECT-NAME}	Nama proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
deploymentName	{DEPLOYMENT-NAME}	Nama penyebaran Anda. Nilai ini peka huruf besar/kecil.	staging

Setelah Anda mengirim permintaan, Anda akan mendapatkan tanggapan berikut untuk prediksi

Isi Respons

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Kunci	Nilai Sampel	Deskripsi
query	"Baca email Matt"	teks yang Anda kirim untuk kueri.
topIntent	"Read"	Niat yang diprediksi dengan skor keyakinan tertinggi.
niat	[]	Daftar semua niat yang diprediksi untuk teks kueri masing-masing dengan skor keyakinan.
entities	[]	array yang berisi daftar entitas yang diekstrak dari teks kueri.

Respons API untuk proyek percakapan

Dalam proyek percakapan, Anda akan mendapatkan prediksi untuk niat dan entitas yang ada dalam proyek Anda.

• Niat dan entitas menyertakan skor keyakinan antara 0,0 hingga 1,0 yang terkait dengan seberapa yakin model dalam memprediksi elemen tertentu dalam proyek Anda.
• Niat skor tertinggi terkandung dalam parameternya sendiri.
• Hanya entitas yang diprediksi yang akan muncul dalam respons Anda.
• Entitas menunjukkan:
  • Teks entitas yang diekstraksi
  • Lokasi awalnya dilambangkan dengan nilai offset
  • Panjang teks entitas dilambangkan dengan nilai panjang.

Pustaka klien (Azure SDK)

Menggunakan pustaka klien (Azure SDK)

Anda juga dapat menggunakan pustaka klien yang disediakan oleh Azure SDK untuk mengirim permintaan ke model Anda.

Catatan

Pustaka klien untuk pemahaman bahasa percakapan hanya tersedia untuk:

• .NET
• Python

1. Buka halaman gambaran umum sumber daya Anda di portal Microsoft Azure

2. Dari menu sebelah kiri, pilih Kunci dan Titik Akhir. Gunakan titik akhir untuk permintaan API dan Anda akan memerlukan kunci untuk header Ocp-Apim-Subscription-Key.

   

3. Unduh dan pasang paket pustaka klien untuk bahasa pilihan Anda:

   Bahasa	Versi paket
   .NET	1.0.0
   Python	1.0.0

4. Setelah Anda pustaka klien terpasang, gunakan sampel berikut di GitHub untuk mulai panggilan API.

   • C#
   • Python

5. Lihat dokumentasi referensi untuk informasi selengkapnya:

   • C#
   • Python

Langkah berikutnya

• Ringkasan pemahaman bahasa percakapan