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

  • Článek
  • 3 min ke čtení

Sady SDK, rozhraní REST API a CLI vám pomůžou vyvíjet aplikace Language Understanding (LUIS) ve vašem programovacím jazyce. Spravujte své prostředky Azure a LUIS předpovědi.

Správa prostředků Azure

Pomocí vrstvy správy Azure Cognitive Services můžete vytvořit, upravit, vypsat a odstranit prostředek Language Understanding nebo služby pro rozpoznávání.

Vyhledejte referenční dokumentaci na základě nástroje:

Language Understanding žádosti o vytváření a předpovědi

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

  • K vytváření, úpravám, školení a publikování můžete použít prostředek pro vytváření obsahu .
  • K odeslání textu uživatele a získání předpovědi použijte předpověď pro modul runtime.

Přečtěte si o koncovém bodu předpovědi V3.

Pomocí Cognitive Services ukázkový kód se naučíte a používat nejběžnější úlohy.

Specifikace REST

Specifikace Luis RESTspolu se všemi specifikacemi Azure RESTjsou veřejně dostupné na GitHubu.

Rozhraní REST API

Rozhraní API pro vytváření obsahu a předpovědi jsou dostupná z rozhraní REST API:

Typ Verze
Vytváření obsahu 2
Preview verze 3
Předpověď 2
Technologie

Koncové body REST

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

  • vytváření obsahu pro školicí koncový bod
  • předpověď dotazů na koncový bod modulu runtime.
Účel URL
Vytváření kódu v2 na školicím bodu https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Vytváření obsahu V3 na školicím bodu https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Předpověď 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]
Předpověď předpovědi verze V3 na koncový bod za běhu 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ěď předpovědi V3 – předpověď slotu na koncový bod za běhu 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 popisuje parametry, které jsou označeny složenými závorkami {} v předchozí tabulce.

Parametr Účel
your-resource-name Název prostředku Azure
q nebo query utterance text odeslaný z klientské aplikace, jako je třeba robota chatu
version 10 název verze znaku
slot production nebo staging

Parametry řetězce dotazu REST

Parametry řetězce dotazu rozhraní V3 API zahrnují:

Parametr dotazu Název portálu LUIS Typ Verze Výchozí Účel
log Uložit protokoly boolean V2 & V3 false (nepravda) Dotaz na uložení v souboru protokolu. Výchozí hodnota je false.
query - řetězec Jenom V3 Žádná výchozí hodnota – v žádosti GET se vyžaduje. V v2 je utterance, který má být předpovězen, v q parametru.

V v3 je funkce předána do query parametru.
show-all-intents Zahrnout skóre pro všechny záměry boolean Jenom V3 false (nepravda) Vrátí všechny záměry s odpovídajícím skóre v objektu předpověď. záměrs . Záměry jsou vráceny jako objekty v nadřazeném intents objektu. To umožňuje programový přístup bez nutnosti najít záměr v poli: prediction.intents.give . V v2 byly vráceny v poli.
verbose Zahrnout další podrobnosti o entitách boolean V2 & V3 false (nepravda) V v2 při nastavení na hodnotu true byly vráceny všechny předpovězené záměry. Pokud potřebujete všechny předpovídané záměry, použijte parametr V3 show-all-intents .

V v3 tento parametr poskytuje pouze podrobnosti o metadatech entit pro předpovědi entit.
timezoneOffset - řetězec V2 - Časové pásmo bylo použito pro datetimeV2 entity.
datetimeReference - řetězec Technologie - Časové pásmo bylo použito pro datetimeV2 entity. Nahrazuje timezoneOffset z v2.

Aplikační schéma

Schéma aplikace je importováno a exportováno ve .json .lu formátu nebo.

Sady SDK založené na jazyce

Jazyk Referenční dokumentace Balíček Rychlé starty
C# Vytváření obsahu
Předpovědi		 Vytváření balíčků NuGet
Předpověď NuGet		 Vytváření obsahu
Prediktivní dotazování
Go Vytváření a předpověď SADĚ
Java Vytváření a předpověď Vytváření Maven
Předpověď Maven
JavaScript Vytváření obsahu
Předpovědi		 Vytváření NPM
Předpověď NPM		 Vytváření obsahu
Předpovědi
Python Vytváření a předpověď Pip Vytváření obsahu
Předpovědi

Kontejnery

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

Formáty exportu a importu

Language Understanding poskytuje možnost spravovat svou aplikaci a její modely ve formátu JSON, ve .LU formátuLUDown(formát) a komprimovaném balíčku pro kontejner Language Understanding.

Import a export těchto formátů je dostupný z rozhraní API a z portálu LUIS. Portál poskytuje import a export jako součást seznamu a verzí seznamu aplikací.

Semináře

Nástroje pro kontinuální integraci

Nástroje pro robot Framework

Rozhraní bot Framework je dostupné jako sada SDK v různých jazycích a jako služba pomocí Azure bot Service.

Robot Framework nabízí několik nástrojů , které vám pomůžou s Language Understanding, včetně:

  • Emulátor rozhraní robot – desktopová aplikace umožňující vývojářům robotům testovat a ladit roboty sestavené pomocí sady robot Framework SDK
  • Robot Framework robot – integrovaný vývojový nástroj pro vývojáře a týmy pro více týmů k sestavování roboty a konverzací v prostředí Microsoft bot Framework
  • Ukázky rozhraní bot – v #C, JavaScriptu, TypeScriptu a Pythonu

Další kroky