Language Understanding için SDK, REST ve CLı geliştirici kaynakları (LUSıS)

SDK 'Lar, REST API 'Leri, CLı, programlama dilinizde Language Understanding (LUıS) uygulamaları geliştirmenize yardımcı olur. Azure kaynaklarınızı ve LUSıS tahminlerinizi yönetin.

Azure Kaynak Yönetimi

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

Araca göre 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:

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

V3 tahmin uç noktasıhakkında bilgi edinin.

En yaygın görevleri öğrenmek ve kullanmak için bilişsel Hizmetler örnek kodunu kullanın.

REST belirtimleri

LUSıS Rest belirtimleri, tüm Azure Rest belirtimleriylebirlikte GitHub 'da herkese açık bir şekilde sunulmaktadır.

REST API'leri

REST API 'lerden hem yazma hem de tahmin uç nokta API 'LERI kullanılabilir:

Tür Sürüm
Yazma V2
izleme v3
Tahmin V2
Yüklemesinde

REST uç noktaları

LUIN Şu anda 2 uç nokta türü vardır:

  • Eğitim uç noktasında yazma
  • çalışma zamanı uç noktasında sorgu Tahmini .
Amaç URL
Eğitim uç noktasında v2 yazma https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Eğitim uç noktasında v3 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 tahmin-çalışma zamanı uç noktasındaki sürümler 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ı ile belirtilen parametreler açıklanmaktadır {} .

Parametre Amaç
your-resource-name Azure Kaynak adı
q veya query sohbet bot gibi istemci uygulamasından gönderilen söylenişi metni
version 10 karakter sürümü adı
slot production veya staging

REST sorgu dizesi parametreleri

V3 API sorgu dizesi parametreleri şunları içerir:

Sorgu parametresi LUSıS portalı adı Tür Sürüm Varsayılan Amaç
log Günlükleri Kaydet boolean V2 & V3 yanlış Sorguyu günlük dosyasında sakla. Varsayılan değer false 'dur.
query - string Yalnızca v3 Varsayılan değer yok-GET isteğinde gerekli V2 'de, tahmin edilecek olan söylenişi q parametresi.

V3 'de, işlev query parametreye geçirilir.
show-all-intents Tüm amaçlar için puanları dahil et boolean Yalnızca v3 yanlış Tahmin. amaçlar nesnesindeki karşılık gelen puanı içeren tüm hedefleri döndürün. Amaçlar bir üst nesnede nesneler olarak döndürülür intents . Bu, bir dizide amacı bulmaya gerek kalmadan programlı erişime izin verir: prediction.intents.give . V2 'de, bunlar bir dizide döndürülür.
verbose Daha fazla varlık ayrıntısı ekleyin boolean V2 & V3 yanlış V2 sürümünde, true olarak ayarlandığında, tüm tahmin edilen amaçlar döndürülür. Tahmin edilen tüm amaçlar için ihtiyaç duyuyorsanız, v3 param ' ı kullanın show-all-intents .

V3 'de, bu parametre yalnızca varlık tahmini varlık meta veri ayrıntılarını sağlar.
timezoneOffset - string V2 - DatetimeV2 varlıklara uygulanan saat dilimi.
datetimeReference - string Yüklemesinde - DatetimeV2 varlıklara uygulanan saat dilimi . timezoneOffsetV2 'den değiştirilir.

Uygulama şeması

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

Dil tabanlı SDK 'lar

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

Kapsayıcılar

Language Understanding (LUSıS), uygulamanızın şirket içi ve içerilen sürümlerini sağlamak için bir kapsayıcı sağlar.

Dışarı ve içeri aktarma biçimleri

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

Bu biçimlerin içeri ve dışarı aktarılması API 'lerden ve LUıS portalından kullanılabilir. Portal, uygulamalar listesi ve sürümler listesinin bir parçası olarak içeri ve dışarı aktarma sağlar.

Atölyeler

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

Bot Framework araçları

Bot Framework, Azure bot hizmetikullanılarak çeşitli dillerde ve hizmet olarak bir SDK olarak kullanılabilir.

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

  • Bot Framework öykünücüsü -bot geliştiricilerinin, bot Framework SDK kullanılarak oluşturulan botları test etmesine ve hata ayıklamasına izin veren bir masaüstü uygulaması
  • Bot Framework besteci -geliştiriciler ve çok disiplinli takımlar Için Microsoft bot Framework ile botları ve konuşma deneyimleri oluşturmaya yönelik tümleşik bir geliştirme aracı
  • Bot Framework örnekleri -#C, JavaScript, TypeScript ve Python

Sonraki adımlar