Bermigrasi ke versi terbaru Azure Cognitive Service untuk Bahasa

  • Artikel
  • 3 menit untuk membaca

Tip

Baru saja memulai dengan Azure Cognitive Service untuk Bahasa? Lihat artikel gambaran umum untuk detail tentang layanan, fitur yang tersedia, dan tautan ke mulai cepat untuk mengetahui informasi mengenai versi API saat ini.

Jika aplikasi Anda menggunakan Text Analytics API versi lama (sebelum v5.1.0), atau pustaka klien (sebelum v5.1.0 yang stabil), artikel ini akan membantu Anda meningkatkan aplikasi agar dapat menggunakan fitur Azure Cognitive Service untuk bahasa versi terbaru.

Titik akhir Bahasa Terpadu (REST API)

Bagian ini berlaku untuk aplikasi yang menggunakan format titik akhir /text/analytics/... yang lebih lawas untuk panggilan REST API. Contohnya:

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

Jika aplikasi Anda menggunakan format titik akhir versi di atasnya, titik akhir REST API untuk fitur layanan Bahasa berikut telah berubah:

Layanan Bahasa kini menyediakan titik akhir terpadu untuk mengirim permintaan REST API ke fitur-fitur ini. Jika aplikasi Anda menggunakan REST API, perbarui titik akhir permintaan untuk menggunakan titik akhir saat ini:

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

Selain itu, format isi permintaan JSON telah berubah. Anda harus memperbarui struktur permintaan yang dikirim aplikasi Anda ke API, misalnya isi JSON pengenalan entitas berikut:

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

Gunakan mulai cepat yang ditautkan di atas untuk melihat contoh panggilan REST API saat ini untuk fitur yang Anda gunakan, dan output API terkait.

Pustaka klien

Untuk menggunakan versi terbaru pustaka klien, Anda harus mengunduh paket perangkat lunak terbaru di namespace Azure.AI.TextAnalytics. Lihat artikel mulai cepat yang ditautkan di atas misalnya kode dan petunjuk penggunaan pustaka klien dalam bahasa pilihan Anda.

Perubahan fungsionalitas versi 2.1

Jika Anda memigrasikan aplikasi dari API v2.1, ada beberapa perubahan pada fungsionalitas fitur yang harus Anda ketahui.

Analisis Sentimen v2.1

Analisis Sentimen dalam versi 2.1 menampilkan skor sentimen antara 0 dan 1 untuk setiap dokumen yang dikirim ke API, dengan skor yang mendekati 1 yang menunjukkan sentimen yang lebih positif. Versi terkini dari fitur ini menampilkan label sentimen (seperti "positif" atau "negatif") untuk kedua kalimat dan dokumen secara keseluruhan, dan skor kepercayaan yang terkait.

NER, PII, dan penautan entitas v2.1

Dalam versi 2.1, Text Analytics API menggunakan satu titik akhir untuk Pengenalan Entitas Bernama (NER) dan penautan entitas. Versi terkini dari fitur ini menyediakan deteksi entitas yang diperluas, dan memiliki titik akhir terpisah untuk permintaan NER dan penautan entitas. Selain itu, Anda dapat menggunakan fitur lain yang ditawarkan dalam layanan Bahasa yang memungkinkan Anda mendeteksi informasi pribadi (PII) dan kesehatan (PHI).

Anda juga perlu memperbarui aplikasi untuk menggunakan kategori entitas yang dikembalikan dalam respons API.

Kategori entitas versi 2.1

Tabel berikut mencantumkan kategori entitas yang dikembalikan untuk NER v2.1.

Kategori Deskripsi
Orang Nama orang.
Lokasi Landmark, struktur, fitur geografis, atau entitas geopolitik alami atau buatan manusia
Organisasi Perusahaan, grup politik, band musik, klub olahraga, badan pemerintah, dan organisasi publik. Kebangsaan dan agama tidak termasuk dalam jenis entitas ini.
NomorTelepon Nomor telepon (hanya nomor telepon AS dan Eropa).
Email Alamat email.
URL URL ke situs web.
IP Alamat IP jaringan.
DateTime Tanggal dan waktu dalam sehari.
Tanggal Tanggal kalender.
Waktu Waktu hari
DateRange Rentang tanggal.
TimeRange Rentang waktu.
Durasi Durasi.
Set Set, waktu berulang.
Kuantitas Angka dan jumlah numerik.
Telepon Angka.
Persentase Persentase.
Ordinal Angka ordinal.
Usia Usia.
Mata uang Mata uang.
Dimensi Dimensi dan pengukuran.
Suhu Suhu.

Deteksi bahasa v2.1

Output fitur deteksi bahasa telah berubah dalam versi saat ini. Respon JSON akan berisi ConfidenceScore sebaliknya score. Versi saat ini juga hanya menampilkan satu bahasa untuk setiap dokumen.

Ekstraksi frasa kunci v2.1

Fungsionalitas fitur ekstraksi frasa kunci saat ini tidak berubah di luar format titik akhir dan permintaan.

Lihat juga