Sumber daya pengembang SDK, REST, dan CLI untuk Pemahaman Bahasa (LUIS)

  • Artikel

Penting

LUIS akan dihentikan pada 1 Oktober 2025 dan mulai 1 April 2023 Anda tidak akan dapat membuat sumber daya LUIS baru. Sebaiknya migrasikan aplikasi LUIS Anda ke pemahaman bahasa percakapan untuk mendapatkan manfaat dari dukungan produk berkelanjutan dan kemampuan multibahasa.

SDK, REST API, CLI, membantu mengembangkan aplikasi Pemahaman Bahasa (LUIS) dalam bahasa pemrograman Anda. Kelola sumber daya Azure dan prediksi LUIS Anda.

Manajemen sumber daya Azure

Gunakan lapisan manajemen layanan Azure AI untuk membuat, mengedit, mencantumkan, dan menghapus sumber daya layanan Pemahaman Bahasa atau Azure AI.

Temukan dokumentasi referensi berdasarkan alat ini:

Permintaan penulisan dan prediksi Pemahaman Bahasa

Layanan Pemahaman Bahasa diakses dari sumber daya Azure yang perlu Anda buat. Ada dua sumber daya:

  • Gunakan sumber daya penulisan untuk pelatihan guna membuat, mengedit, melatih, dan menerbitkan.
  • Gunakan prediksi runtime untuk mengirim teks pengguna dan menerima prediksi.

Gunakan kode sampel layanan Azure AI untuk mempelajari dan menggunakan tugas yang paling umum.

Spesifikasi REST

Spesifikasi REST LUIS, beserta dengan semua spesifikasi REST Azure, tersedia untuk umum di GitHub.

REST API

API titik akhir penulisan dan prediksi tersedia dari REST API:

Jenis Versi
Penulisan V2
pratinjau V3
Prediksi V2
V3

Titik Akhir REST

LUIS saat ini memiliki 2 jenis titik akhir:

  • penulisan di titik akhir pelatihan
  • buat kueri prediksi pada titik akhir runtime.
Tujuan URL
Penulisan V2 pada titik akhir pelatihan https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Penulisan V3 pada titik akhir pelatihan https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Prediksi V2 - semua prediksi pada titik akhir runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
Prediksi V3 - prediksi versi pada titik akhir runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
Prediksi V3 - prediksi slot pada titik akhir runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

Tabel berikut menjelaskan parameter, dilambangkan dengan kurung kurawal {}, pada tabel sebelumnya.

Parameter Tujuan
your-resource-name Nama sumber daya Azure
q atau query teks ucapan yang dikirim dari aplikasi klien seperti bot obrolan
version Nama versi 10 karakter
slot production atau staging

parameter string kueri REST

Parameter string kueri API V3 meliputi:

Parameter kueri Nama portal LUIS Jenis Versi Default Tujuan
log Simpan log Boolean V2 & V3 salah Simpan kueri dalam file log. Nilai defaultnya adalah false.
query - string Hanya V3 Tidak ada default - diperlukan dalam permintaan GET Di V2, ucapan yang akan diprediksi ada dalam parameter q.

Di V3, fungsionalitas diteruskan dalam parameter query.
show-all-intents Sertakan skor untuk semua tujuan Boolean Hanya V3 salah Kembalikan semua maksud dengan skor yang sesuai di objek prediction.intents. Niat dikembalikan sebagai objek dalam objek intents induk. Ini memungkinkan akses terprogram tanpa perlu menemukan maksud dalam array: prediction.intents.give. Di V2, ini dikembalikan dalam array.
verbose Sertakan detail entitas lainnya Boolean V2 & V3 salah Dalam V2, ketika diatur ke true, semua tujuan yang diprediksi dikembalikan. Jika Anda membutuhkan semua tujuan yang diprediksi, gunakan param V3 show-all-intents dari .

Dalam V3, parameter ini hanya menyediakan rincian metadata entitas prediksi entitas.
timezoneOffset - string V2 - Zona waktu diterapkan ke entitas datetimeV2.
datetimeReference - string V3 - Zona waktu diterapkan ke entitas datetimeV2. Mengganti timezoneOffset dari V2.

Skema aplikasi

Skema aplikasi diimpor dan diekspor dalam format .json atau .lu.

SDK berbasis bahasa

Bahasa Dokumentasi rujukan Paket Mulai cepat
C# Penulisan
Prediksi		 Penulisan NuGet
Prediksi NuGet		 Penulisan
Prediksi kueri
Go Penulisan dan prediksi SDK
Java Penulisan dan prediksi Penulisan Maven
Prediksi Maven
JavaScript Penulisan
prediksi		 Penulisan NPM
Prediksi NPM		 Penulisan
prediksi
Python Penulisan dan prediksi Pip Penulisan
prediksi

Kontainer

Pemahaman Bahasa (LUIS) menyediakan kontainer untuk memberikan versi lokal dan versi yang memuat aplikasi Anda.

Format ekspor dan impor

Pemahaman Bahasa memberikan kemampuan untuk mengelola aplikasi Anda dan modelnya dalam format JSON, format .LU (LUDown), dan paket terkompresi untuk kontainer Pemahaman Bahasa.

Mengimpor dan mengekspor format ini dapat dilakukan dari API dan dari portal LUIS. Portal menyediakan impor dan ekspor sebagai bagian dari daftar Aplikasi dan daftar Versi.

Lokakarya

Alat integrasi berkelanjutan

Alat Kerangka Kerja Bot

Kerangka kerja bot tersedia sebagai SDK dalam berbagai bahasa dan sebagai layanan menggunakan Azure AI Bot Service.

Kerangka kerja bot menyediakan beberapa alat untuk membantu Pemahaman Bahasa, termasuk:

  • Emulator Bot Framework - aplikasi desktop yang memungkinkan pengembang bot menguji dan menelusuri kesalahan bot yang dibuat menggunakan SDK Bot Framework
  • Bot Framework Composer - alat pengembangan terintegrasi untuk pengembang dan tim multidisiplin guna membangun bot dan pengalaman percakapan dengan Microsoft Bot Framework
  • Sampel Kerangka Kerja Bot - dalam #C, JavaScript, TypeScript, dan Python

Langkah berikutnya