Language Understanding (LUIS) için SDK, REST ve CLI geliştirici kaynakları

  • Makale

Önemli

LUIS 1 Ekim 2025'te kullanımdan kaldırılacak ve 1 Nisan 2023'den itibaren yeni LUIS kaynakları oluşturamayacaksınız. Devam eden ürün desteği ve çok dilli özelliklerden yararlanmak için LUIS uygulamalarınızıkonuşma dili anlayışına geçirmenizi öneririz.

SDK'lar, REST API'ler, CLI, programlama dilinizde Language Understanding (LUIS) uygulamaları geliştirmenize yardımcı olur. Azure kaynaklarınızı ve LUIS tahminlerinizi yönetin.

Azure kaynak yönetimi

Language Understanding veya Azure AI hizmetleri kaynağını oluşturmak, düzenlemek, listelemek ve silmek için Azure AI hizmetleri yönetim katmanını kullanın.

Aracı temel alan başvuru belgelerini bulun:

Language Understanding yazma ve tahmin istekleri

Language Understanding hizmetine oluşturmanız gereken bir Azure kaynağından erişilir. İki kaynak vardır:

  • Eğitim için yazma kaynağını kullanarak oluşturma, düzenleme, eğitma ve yayımlama.
  • Kullanıcının metnini göndermek ve tahmin almak için çalışma zamanı tahminini kullanın.

En yaygın görevleri öğrenmek ve kullanmak için Azure AI hizmetleri örnek kodunu kullanın.

REST belirtimleri

LUIS REST belirtimleri ve tüm Azure REST belirtimleri GitHub'da genel kullanıma sunulmuştur.

REST API'leri

REST API'lerinden hem yazma hem de tahmin uç noktası API'leri kullanılabilir:

Tür Sürüm
Yazma V2
önizleme V3
Tahmin V2
V3

REST Uç Noktaları

LUIS'in şu anda 2 tür uç noktası vardır:

  • eğitim uç noktasında yazma
  • çalışma zamanı uç noktasında sorgu tahmini .
Purpose URL
V2 Eğitim uç noktasında yazma https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
V3 Eğitim uç noktasında yazma https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
V2 Tahmini - çalışma zamanı uç noktasındaki tüm tahminler 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]
V3 Tahmini - çalışma zamanı uç noktasında sürüm tahmini https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
V3 Tahmini - çalışma zamanı uç noktasında yuva tahmini https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

Aşağıdaki tabloda, önceki tabloda küme ayraçlarıyla {}belirtilen parametreler açıklanmaktadır.

Parametre Purpose
your-resource-name Azure kaynak adı
q veya query sohbet botu gibi istemci uygulamasından gönderilen konuşma metni
version 10 karakterlik sürüm adı
slot production veya staging

REST sorgu dizesi parametreleri

V3 API sorgu dizesi parametreleri şunlardır:

Sorgu parametresi LUIS portalı adı Tür Sürüm Varsayılan Purpose
log Günlükleri kaydetme boolean V2 ve V3 yanlış Sorguyu günlük dosyasında depolayın. Varsayılan değer yanlış'tır.
query - Dize Yalnızca V3 Varsayılan yok - GET isteğinde gereklidir V2'de tahmin edilecek ifade parametresindedir q .

V3'te işlev parametresinde query geçirilir.
show-all-intents Tüm amaçlar için puanları dahil et boolean Yalnızca V3 yanlış Prediction.intents nesnesinde karşılık gelen puana sahip tüm amaçları döndürür. Amaçlar, bir üst intents nesnede nesne olarak döndürülür. Bu, bir dizideki amacı bulmaya gerek kalmadan programlı erişime izin verir: prediction.intents.give. V2'de bunlar bir dizide döndürüldü.
verbose Daha fazla varlık ayrıntısı ekle boolean V2 ve V3 yanlış V2'de true olarak ayarlandığında, tüm tahmin edilen amaçlar döndürülür. Tüm tahmin edilen amaçlara ihtiyacınız varsa, öğesinin V3 parametresini show-all-intentskullanın.

V3'te bu parametre yalnızca varlık tahmininin varlık meta veri ayrıntılarını sağlar.
timezoneOffset - Dize V2 - datetimeV2 varlıklarına uygulanan saat dilimi.
datetimeReference - Dize V3 - datetimeV2 varlıklarına uygulanan saat dilimi . timezoneOffset V2'den değiştirir.

Uygulama şeması

Uygulama şeması bir veya .lu biçiminde içeri ve dışarı aktarılır.json.

Dil tabanlı SDK'lar

Dil Başvuru belgeleri Paket Hızlı Başlangıçlar
C# Yazma
Tahmini		 NuGet yazma
NuGet tahmini		 Yazma
Sorgu tahmini
Go Yazma ve tahmin SDK
Java Yazma ve tahmin Maven yazma
Maven tahmini
JavaScript Yazma
Tahmin		 NPM yazma
NPM tahmini		 Yazma
Tahmin
Python Yazma ve tahmin Pip Yazma
Tahmin

Kapsayıcılar

Language Understanding (LUIS), uygulamanızın şirket içi ve kapsanan sürümlerini sağlayan bir kapsayıcı sağlar.

Biçimleri dışarı ve içeri aktarma

Language Understanding, uygulamanızı ve modellerini JSON biçiminde, .LU (LUDown) biçiminde ve Language Understanding kapsayıcısı için sıkıştırılmış bir pakette yönetme olanağı sağlar.

Bu biçimleri içeri ve dışarı aktarma, API'lerden ve LUIS portalından kullanılabilir. Portal, Uygulamalar listesinin ve Sürümler listesinin bir parçası olarak içeri ve dışarı aktarma sağlar.

Atölye

Sürekli tümleştirme araçları

Bot Framework araçları

Bot çerçevesi, Azure AI Bot Hizmeti kullanarak çeşitli dillerde sdk ve hizmet olarak kullanılabilir.

Bot çerçevesi, Language Understanding konusunda yardımcı olmak için aşağıdakiler dahil olmak üzere çeşitli araçlar sağlar:

  • Bot Framework öykünücüsü - Bot geliştiricilerinin Bot Framework SDK'sı kullanılarak oluşturulan botları test etmesine ve hatalarını ayıklamasına olanak tanıyan bir masaüstü uygulaması
  • Bot Framework Composer - Microsoft Bot Framework ile botlar ve konuşma deneyimleri oluşturmak için geliştiricilere ve çok disiplinli ekiplere yönelik tümleşik bir geliştirme aracı
  • Bot Framework Örnekleri - #C, JavaScript, TypeScript ve Python'da

Sonraki adımlar