Mengkueri model kustom Anda

Setelah penyebaran berhasil ditambahkan, Anda dapat mengkueri penyebaran untuk mengekstrak entitas dari teks Anda berdasarkan model yang ditetapkan untuk penyebaran. Anda dapat mengkueri penyebaran secara terprogram menggunakan API Prediksi atau melalui pustaka klien (Azure SDK).

Menguji model yang disebarkan

Anda dapat menggunakan Studio Bahasa untuk mengirimkan tugas pengenalan entitas kustom dan memvisualisasikan hasilnya.

Untuk menguji model disebarkan dari dalam Language Studio:

1. Pilih Menguji penyebaran dari menu sebelah kiri.

2. Pilih penyebaran yang ingin Anda uji. Anda hanya dapat menguji model yang ditetapkan untuk penyebaran.

3. Untuk proyek multi-bahasa, dari menu dropdown bahasa, pilih bahasa teks yang sedang Anda uji.

4. Pilih penyebaran yang ingin Anda kueri/uji dari menu dropdown.

5. Anda dapat memasukkan teks yang ingin dikirimkan ke permintaan atau unggah file .txt yang akan digunakan.

6. Pilih Jalankan pengujian dari menu atas.

7. Di tab Hasil, Anda dapat melihat entitas yang diekstraksi dari teks dan jenisnya. Anda juga dapat melihat respons JSON pada tab JSON.

Mengirim permintaan pengenalan entitas ke model Anda

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, di bawah pivot Kirim , salin URL dan isi permintaan sampel. Ganti nilai tempat penampung seperti YOUR_DOCUMENT_HERE dan YOUR_DOCUMENT_LANGUAGE_HERE dengan teks dan bahasa aktual yang ingin Anda proses.

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

4. Di header respons yang Anda terima, ekstrak {JOB-ID} dari operation-location, yang memiliki format: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Kembali ke Studio Bahasa; pilih pivot Ambil dari jendela yang sama dengan permintaan contoh yang Anda dapatkan sebelumnya dan salin permintaan sampel ke editor teks.

6. Tambahkan ID pekerjaan Anda setelah /jobs/ ke URL, menggunakan ID yang Anda ekstrak dari langkah sebelumnya.

7. Kirimkan permintaan cURL GET di terminal atau perintah Anda.

REST API

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

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

2. Dari menu sebelah kiri, pilih Kunci dan Titik Akhir. Anda akan menggunakan titik akhir dan kunci untuk permintaan API

   

Kirimkan tugas NER kustom

Gunakan permintaan POST ini untuk memulai tugas klasifikasi teks.

{ENDPOINT}/language/analyze-text/jobs?api-version={API-VERSION}

Placeholder	Nilai	Contoh
{ENDPOINT}	Titik akhir untuk mengautentikasi permintaan API Anda.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{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

Tombol	Nilai
Ocp-Apim-Subscription-Key	Kunci Anda yang menyediakan akses menuju API ini.

Isi

{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomEntityRecognition",
      "taskName": "Entity Recognition",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Kunci	Placeholder	Nilai	Contoh
displayName	{JOB-NAME}	Nama pekerjaan Anda.	MyJobName
documents	[{},{}]	Daftar dokumen untuk menjalankan tugas.	[{},{}]
id	{DOC-ID}	ID atau nama dokumen.	doc1
language	{LANGUAGE-CODE}	String yang menentukan kode bahasa untuk dokumen. Jika kunci ini tidak ditentukan, layanan akan menggunakan bahasa default proyek yang dipilih saat pembuatan proyek. Lihat dukungan bahasa untuk daftar kode bahasa yang didukung.	en-us
text	{DOC-TEXT}	Tugas dokumen untuk menjalankan tugas.	Lorem ipsum dolor sit amet
tasks		Daftar tugas yang ingin kami jalankan.	[]
taskName	CustomEntityRecognition	Nama tugas	CustomEntityRecognition
parameters		Daftar parameter untuk diteruskan ke tugas.
project-name	{PROJECT-NAME}	Nama untuk proyek Anda. Nilai ini peka huruf besar/kecil.	myProject
deployment-name	{DEPLOYMENT-NAME}	Nama penyebaran Anda. Nilai ini peka huruf besar/kecil.	prod

Respons

Anda akan menerima respons 202 yang menunjukkan bahwa tugas Anda telah berhasil dikirimkan. Di header respons, ekstrak operation-location. operation-location diformat sebagai berikut:

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}

Anda dapat menggunakan URL ini untuk mengkueri status penyelesaian tugas dan mendapatkan hasil saat tugas selesai.

Mendapatkan hasil tugas

Gunakan permintaan GET berikut untuk mengkueri status/hasil tugas pengenalan entitas kustom.

{ENDPOINT}/language/analyze-text/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
{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

Tombol	Nilai
Ocp-Apim-Subscription-Key	Kunci Anda yang menyediakan akses menuju API ini.

Isi Respons

Respons akan menjadi dokumen JSON dengan parameter berikut

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxx-xxxxx-xxxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "EntityRecognitionLROResults",
        "taskName": "Recognize Entities",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "entities": [
                {
                  "category": "Event",
                  "confidenceScore": 0.61,
                  "length": 4,
                  "offset": 18,
                  "text": "trip"
                },
                {
                  "category": "Location",
                  "confidenceScore": 0.82,
                  "length": 7,
                  "offset": 26,
                  "subcategory": "GPE",
                  "text": "Seattle"
                },
                {
                  "category": "DateTime",
                  "confidenceScore": 0.8,
                  "length": 9,
                  "offset": 34,
                  "subcategory": "DateRange",
                  "text": "last week"
                }
              ],
              "id": "1",
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Pustaka klien (Azure SDK)

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

Dapatkan kunci dan titik akhir Anda

Selanjutnya Anda akan memerlukan kunci dan titik akhir dari sumber daya untuk menghubungkan aplikasi Anda ke API. Anda akan menempelkan kunci dan titik akhir Anda ke dalam kode di mulai cepat nanti.

1. Setelah sumber daya Bahasa berhasil disebarkan, klik tombol Buka Sumber Daya di bawah Langkah Berikutnya.

   

2. Pada layar untuk sumber daya Anda, pilih Kunci dan titik akhir di menu navigasi kiri. Anda akan menggunakan salah satu kunci dan titik akhir Anda dalam langkah-langkah di bawah ini.

   

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

   Bahasa	Versi paket
   .NET	5.2.0-beta.3
   Java	5.2.0-beta.3
   JavaScript	6.0.0-beta.1
   Python	5.2.0b4

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

   • C#
   • Java
   • JavaScript
   • Python

5. Lihat dokumentasi referensi berikut untuk informasi lebih lanjut tentang klien, dan tampilkan objek:

   • C#
   • Java
   • JavaScript
   • Python

Langkah berikutnya

• Tanya jawab umum