Language Understanding (LUIS) 用の SDK、REST、CLI 開発者向けリソース

  • [アーティクル]

重要

LUIS は 2025 年 10 月 1 日に廃止され、2023 年 4 月 1 日から新しい LUIS リソースを作成できなくなります。 継続的な製品サポートと多言語機能のベネフィットを得るために、LUIS アプリケーションを会話言語理解に移行することをお勧めします。

SDK、REST API、CLI は、ご使用のプログラミング言語で Language Understanding (LUIS) アプリを開発する際に役立ちます。 Azure リソースと LUIS 予測を管理します。

Azure Resource Management

Azure AI サービス管理レイヤーを使用して、Language Understanding または Azure AI サービス リソースの作成、編集、一覧表示、削除を行います。

ツールに基づくリファレンス ドキュメントを検索します。

Language Understanding の作成と予測要求

Language Understanding サービスには、作成する必要がある Azure リソースからアクセスします。 次の 2 つのリソースがあります。

  • トレーニング用の作成リソースを使用して、作成、編集、トレーニング、公開を行います。
  • ランタイム用の予測を使用すると、ユーザーのテキストを送信し、予測を受け取ることができます。

最も一般的なタスクについて学習し、使用するには、Azure AI サービスのサンプル コードを使用します。

REST の仕様

LUIS REST 仕様は、すべての Azure REST 仕様と共に GitHub で一般提供されています。

REST API

作成と予測の両方のエンドポイント API は、REST API から入手できます。

Type Version
Authoring V2
プレビュー V3
予測 V2
V3

REST エンドポイント

現在、LUIS には次の 2 種類のエンドポイントがあります。

  • トレーニング エンドポイントでの作成
  • ランタイム エンドポイントでのクエリ予測。
目的 URL
トレーニング エンドポイントでの V2 作成 https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
トレーニング エンドポイントでの V3 作成 https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
V2 予測 - ランタイム エンドポイントでのすべての予測 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 予測 - ランタイム エンドポイントでのバージョン予測 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 予測 - ランタイム エンドポイントでのスロット予測 https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

次の表は、前の表で中かっこ {} で囲まれているパラメーターの説明です。

パラメーター 目的
your-resource-name Azure リソース名
q または query チャット ボットなどのクライアント アプリケーションから送信される発話テキスト
version 10 文字のバージョン名
slot production または staging

REST クエリ文字列パラメーター

V3 API クエリ文字列パラメーターには、以下が含まれます。

Query parameter (クエリ パラメーター) LUIS ポータル名 Type Version Default 目的
log ログの保存 boolean V2 および V3 false ログ ファイルにクエリを格納します。 既定値は false です。
query - string V3 のみ 既定値なし - GET 要求では必須 V2 では、予測される発話は q パラメーター内にあります。

V3 では、この機能は query パラメーターで渡されます。
show-all-intents すべての意図のスコアを含める boolean V3 のみ false すべての意図と対応するスコアを prediction.intents オブジェクトに返します。 意図は、親の intents オブジェクト内のオブジェクトとして返されます。 これにより、配列 prediction.intents.give 内で意図を探す必要はなく、プログラムによるアクセスが可能になります。 V2 では、これらは配列で返されていました。
verbose さらなるエンティティの詳細を含める boolean V2 および V3 false V2 では、true に設定した場合、予測されたすべての意図が返されていました。 予測されたすべての意図が必要な場合は、V3 の show-all-intents パラメーターを使用します。

V3 では、このパラメーターではエンティティ予測のエンティティ メタデータの詳細のみが提供されます。
timezoneOffset - string V2 - datetimeV2 エンティティに適用されるタイムゾーン。
datetimeReference - string V3 - datetimeV2 エンティティに適用されるタイムゾーン。 V2 の timezoneOffset を置き換えます。

アプリ スキーマ

アプリ スキーマは、.json または .lu 形式でインポートおよびエクスポートされます。

言語ベースの SDK

Language リファレンス ドキュメント Package クイックスタート
C# オーサリング
予測		 NuGet の作成
NuGet の予測		 作成
クエリ予測
Go 作成と予測 SDK
Java 作成と予測 Maven の作成
Maven の予測
JavaScript 作成
予測		 NPM の作成
NPM の予測		 作成
予測
Python 作成と予測 Pip 作成
予測

Containers

Language Understanding (LUIS) には、アプリのオンプレミス バージョンと包含バージョンを提供するためのコンテナーが用意されています。

エクスポートとインポートの形式

Language Understanding には、アプリケーションとそのモデルを JSON 形式、.LU (LUDown) 形式、および Language Understanding コンテナー用の圧縮パッケージで管理する機能が用意されています。

これらの形式のインポートとエクスポートは、API と LUIS ポータルから利用できます。 ポータルでは、アプリの一覧とバージョンの一覧の一部としてインポートとエクスポートが提供されています。

ワークショップ

継続的インテグレーション ツール

Bot Framework ツール

Bot Framework は、さまざまな言語の SDK として、および Azure ＡＩ Bot Service を使用するサービスとして利用できます。

Bot Framework には、次のような Language Understanding に役立ついくつかのツールが用意されています。

  • Bot Framework Emulator - ボット開発者が Bot Framework SDK を使用して構築されたボットをテストおよびデバッグできるデスクトップ アプリケーションです
  • Bot Framework Composer - 開発者およびさまざまな分野から成るチームが Microsoft Bot Framework を使用してボットや会話エクスペリエンスを作成できるようにするのための統合開発ツールです
  • Bot Framework サンプル - #C、JavaScript、TypeScript、Python

次のステップ