Language Understanding (LUIS) için SDK, REST ve CLI geliştirici kaynakları
Ö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-intents kullanı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ölyeler
- GitHub: (Atölye) Konuşma yapay zekası : LUIS kullanarak NLU
Sürekli tümleştirme araçları
- GitHub: (Önizleme) DevOps uygulamalarını kullanarak LUIS uygulaması geliştirme
- GitHub: NLU. DevOps - NLU hizmetleri için sürekli tümleştirmeyi ve dağıtımı destekleyen 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