Materiály pro vývojáře sady SDK, REST a CLI pro službu Language Understanding (LUIS)

  • Článek

Důležité

Služba LUIS bude vyřazena 1. října 2025 a od 1. dubna 2023 nebudete moct vytvářet nové prostředky LUIS. Doporučujeme migrovat aplikace LUIS do porozumění konverzačnímu jazyku, abyste mohli využívat další podporu produktů a vícejazyčné funkce.

Sady SDK, rozhraní REST API, rozhraní příkazového řádku vám pomůžou vyvíjet aplikace LUIS (Language Understanding) v programovacím jazyce. Správa prostředků Azure a předpovědí LUIS

Správa prostředků Azure

Pomocí vrstvy správy služeb Azure AI můžete vytvářet, upravovat, vypisovat a odstraňovat prostředky služeb Language Understanding nebo Azure AI.

Vyhledejte referenční dokumentaci založenou na nástroji:

Žádosti o vytváření a predikce služby Language Understanding

Služba Language Understanding je přístupná z prostředku Azure, který potřebujete vytvořit. Existují dva prostředky:

  • Zdroj pro vytváření obsahu slouží k trénování k vytváření, úpravám, trénování a publikování.
  • Pomocí předpovědi pro modul runtime odešlete text uživatele a obdržíte predikci.

Pomocí ukázkového kódu služeb Azure AI se naučíte a používáte nejběžnější úlohy.

Specifikace REST

Specifikace REST služby LUIS spolu se všemi specifikacemi Azure REST jsou veřejně dostupné na GitHubu.

Rozhraní REST API

Rozhraní API pro vytváření i predikce koncového bodu jsou k dispozici v rozhraních REST API:

Typ Verze
Vytváření obsahu V2
Preview V3
Predikce V2
V3

Koncové body REST

Služba LUIS má aktuálně 2 typy koncových bodů:

  • vytváření obsahu v koncovém bodu trénování
  • predikce dotazu na koncový bod modulu runtime.
Účel Adresa URL
Vytváření obsahu v2 v koncovém bodu trénování https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Vytváření obsahu v3 v koncovém bodu trénování https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Predikce V2 – všechny předpovědi v koncovém bodu modulu 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]
Predikce v3 – předpovědi verzí v koncovém bodu modulu 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]
Předpověď v3 – předpověď slotu v koncovém bodu modulu 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]

Následující tabulka vysvětluje parametry označené složenými závorkami {}v předchozí tabulce.

Parametr Účel
your-resource-name Název prostředku Azure
q nebo query text promluvy odeslaný z klientské aplikace, jako je chatovací robot
version Název verze 10 znaků
slot production nebo staging

Parametry řetězce dotazu REST

Parametry řetězce dotazu rozhraní API v3:

Parametr dotazu Název portálu LUIS Typ Verze Výchozí Účel
log Ukládání protokolů boolean V2 a V3 false (nepravda) Uložte dotaz do souboru protokolu. Výchozí hodnotou je false.
query - string Pouze V3 Žádné výchozí nastavení – v požadavku GET se nevyžaduje. V2 je promluva, která se má předpovědět, v parametru q .

Ve verzi 3 se funkce předá v parametru query .
show-all-intents Zahrnout skóre pro všechny záměry boolean Pouze V3 false (nepravda) Vrátí všechny záměry s odpovídajícím skóre v objektu prediction.intents . Záměry se vrátí jako objekty v nadřazeného intents objektu. To umožňuje programový přístup bez nutnosti najít záměr v poli: prediction.intents.give. V2 se tyto hodnoty vrátily v poli.
verbose Zahrnout další podrobnosti o entitách boolean V2 a V3 false (nepravda) Ve verzi 2, pokud je nastavena hodnota true, byly vráceny všechny předpokládané záměry. Pokud potřebujete všechny predikované záměry, použijte parametr V3 parametru show-all-intents.

Ve verzi 3 tento parametr poskytuje pouze podrobnosti metadat entity pro predikci entity.
timezoneOffset - string V2 - Časové pásmo použité u entit datetimeV2
datetimeReference - string V3 - Časové pásmo použité u entit datetimeV2 timezoneOffset Nahradí z V2.

Aplikační schéma

Schéma aplikace se naimportuje a exportuje do nebo .lu.json ve formátu.

Sady SDK založené na jazyce

Jazyk Referenční dokumentace Balíček Rychlé starty
C# Predikce vytváření
 Vytváření obsahu NuGet
Predikce NuGetu		 Vytváření obsahu
Predikce dotazů
Přejít Vytváření a predikce Sada SDK
Java Vytváření a predikce Vytváření obsahu Mavenu
Predikce Mavenu
JavaScript Vytváření obsahu
Predikce		 Vytváření obsahu NPM
Predikce NPM		 Vytváření obsahu
Predikce
Python Vytváření a predikce Pip Vytváření obsahu
Predikce

Kontejnery

Language Understanding (LUIS) poskytuje kontejner pro poskytování místních a obsažených verzí vaší aplikace.

Export a import formátů

Language Understanding poskytuje možnost spravovat aplikaci a její modely ve formátu JSON, .LUve formátu LUDown a komprimovaném balíčku pro kontejner Language Understanding.

Import a export těchto formátů je k dispozici v rozhraních API a na portálu LUIS. Portál poskytuje import a export jako součást seznamu aplikací a seznamu verzí.

Workshopy

Nástroje pro kontinuální integraci

Nástroje bot Framework

Bot Framework je k dispozici jako sada SDK v různých jazycích a jako služba s využitím služby Azure AI Bot Service.

Bot Framework poskytuje několik nástrojů , které vám pomůžou se službou Language Understanding, včetně následujících:

  • Bot Framework Emulator – desktopová aplikace, která vývojářům robotů umožňuje testovat a ladit roboty vytvořené pomocí sady SDK služby Bot Framework
  • Bot Framework Composer – integrovaný vývojářský nástroj pro vývojáře a multidiscipální týmy pro vytváření robotů a konverzačních prostředí pomocí microsoft Bot Frameworku
  • Ukázky služby Bot Framework – v #C, JavaScriptu, TypeScriptu a Pythonu

Další kroky