Cara menggunakan fitur Layanan Bahasa secara asinkron

  • Artikel

Layanan Bahasa memungkinkan Anda mengirim permintaan API secara asinkron, menggunakan REST API atau pustaka klien. Anda juga dapat menyertakan beberapa fitur layanan Bahasa yang berbeda dalam permintaan Anda, yang akan dilakukan pada data Anda secara bersamaan.

Saat ini, fitur-fitur berikut tersedia untuk digunakan secara asinkron:

  • Penautan entitas
  • Ringkasan dokumen
  • Ringkasan percakapan
  • Ekstraksi frasa kunci
  • Deteksi bahasa
  • Named Entity Recognition (NER)
  • Deteksi konten pelanggan
  • Analisis sentimen dan penggalian opini
  • Analitik Teks untuk kesehatan
  • Informasi Pengidentifikasi Pribadi (PII)

Saat mengirim permintaan asinkron, Anda akan dikenai biaya berdasarkan jumlah data teks yang Anda sertakan dalam permintaan, untuk setiap penggunaan fitur. Misalnya, jika Anda mengirim data teks untuk analisis sentimen dan NER, penagihan akan dihitung sebagai mengirim dua data teks, dan Anda akan dikenai biaya untuk keduanya sesuai dengan tingkat harga Anda.

Mengirimkan pekerjaan asinkron menggunakan REST API

Guna mengirimkan pekerjaan asinkron, tinjau dokumentasi referensi untuk badan JSON yang akan Anda kirimkan dalam permintaan Anda.

  1. Tambahkan dokumen Anda ke objek analysisInput.
  2. Di objek tasks, sertakan operasi yang ingin Anda lakukan pada data Anda. Misalnya, jika ingin menjalankan analisis sentimen, Anda akan menyertakan objek SentimentAnalysisLROTask.
  3. Anda dapat secara opsional:
    1. Memilih versi model tertentu yang digunakan pada data Anda.
    2. Sertakan fitur layanan Bahasa tambahan dalam tasks objek , yang akan dilakukan pada data Anda secara bersamaan.

Setelah Anda membuat isi JSON untuk permintaan Anda, tambahkan kunci Anda ke header Ocp-Apim-Subscription-Key. Kemudian kirim permintaan API Anda ke titik akhir pembuatan pekerjaan. Contohnya:

POST https://your-endpoint.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-05-01

Panggilan yang berhasil akan menampilkan kode respons 202. operation-location dalam header respons akan menjadi URL yang akan Anda gunakan untuk mengambil hasil API. Nilainya akan terlihat mirip dengan URL berikut:

GET {Endpoint}/language/analyze-text/jobs/12345678-1234-1234-1234-12345678?api-version=2022-05-01

Untuk mendapatkan status dan mengambil hasil permintaan, kirim permintaan GET ke URL yang Anda terima di header operation-location dari respons API sebelumnya. Ingatlah untuk menyertakan kunci Anda ke dalam Ocp-Apim-Subscription-Key. Respons akan mencakup hasil panggilan API Anda.

Mengirim permintaan API asinkron menggunakan pustaka klien

Pertama, pastikan Anda menginstal pustaka klien untuk bahasa pilihan Anda. Untuk langkah-langkah penginstalan pustaka klien, lihat artikel mulai cepat untuk fitur yang ingin Anda gunakan.

Setelah itu, gunakan objek klien untuk mengirim panggilan asinkron ke API. Metode panggilan untuk digunakan akan bervariasi bergantung pada bahasa Anda. Gunakan sampel dan dokumentasi referensi yang tersedia untuk membantu Anda memulai.

Ketersediaan hasil

Saat menggunakan fitur ini secara asinkron, hasil API tersedia selama 24 jam sejak permintaan diolah, dan ditunjukkan dalam respons. Setelah jangka waktu ini, hasilnya akan dihapus menyeluruh dan tidak lagi tersedia untuk diambil.

Deteksi bahasa otomatis

Mulai dari REST API versi 2022-07-01-preview, Anda dapat meminta deteksi bahasa otomatis pada dokumen Anda. Dengan mengatur parameter language ke auto, kode bahasa teks yang terdeteksi akan dikembalikan sebagai nilai bahasa dalam respons. Deteksi bahasa ini tidak akan dikenakan biaya tambahan untuk sumber daya Bahasa Anda.

Batas data

Catatan

  • Jika Anda perlu menganalisis dokumen yang lebih besar dari batas yang diizinkan, Anda dapat memecah teks menjadi potongan teks yang lebih kecil sebelum mengirimnya ke API.
  • Dokumen adalah string karakter teks tunggal.

Anda dapat mengirim hingga 125.000 karakter di semua dokumen yang tersimpan dalam permintaan asinkron, seperti yang diukur oleh StringInfo.LengthInTextElements. Batas karakter ini lebih tinggi dari batas permintaan sinkron, agar memiliki throughput yang lebih tinggi.

Jika dokumen melebihi batas, API akan menolak seluruh permintaan dan menampilkan kesalahan 400 bad request jika ada dokumen di dalamnya yang melebihi ukuran maksimum.

Lihat juga