LUIS リソースを作成して管理する方法

重要

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

この記事では、LUIS で使用できる Azure リソースの種類と、それらを管理する方法について説明します。

作成リソース

作成リソースを使用すると、アプリケーションの作成、管理、トレーニング、テスト、発行を行いうことができます。 LUIS 作成リソースで利用できる価格レベルは 1 つです。無料 (F0) レベルで、次の機能が提供されます。

• 100 万件の作成トランザクション
• 1 か月あたり 1,000 件のテスト予測エンドポイント要求。

v3.0-preview LUIS Programmatic API を使用して、作成リソースを管理できます。

予測リソース

予測リソースを使用すると、作成リソースによって提供される要求が 1,000 件を超える場合は、予測エンドポイントに対してクエリを実行できます。 予測リソースで利用できる価格レベルは次の 2 つです。

• Free F0 予測リソース。これによって、毎月 10,000 件の予測エンドポイント要求が提供されます。
• Standard S0 予測リソース。これは有料のサービス レベルです。

v3.0-preview LUIS Endpoint API を使用して、予測リソースを管理できます。

Note

• マルチサービス リソースを使用して、複数の Azure AI サービスに使用できる 1 つのエンドポイントを取得することもできます。
• LUIS には、2 種類の F0 (Free レベル) リソースが用意されています。1 つはオーサリング トランザクション用で、もう 1 つは予測トランザクション用です。 予測トランザクション用の無料クォータが不足する場合は、毎月 1,000 件の予測トランザクションが提供されるオーサリング リソースではなく、毎月 10,000 件の無料トランザクションが提供される F0 予測リソースを使用していることを確認してください。
• 発行およびクエリを行うリージョン内で LUIS アプリを作成する必要があります。

LUIS リソースの作成

LUIS リソースを作成するには、LUIS ポータル、Azure portal、または Azure CLI を使用できます。 リソースを作成したら、それらをアプリに割り当てて使用できるようにする必要があります。

LUIS ポータル

LUIS ポータルを使用して LUIS 作成リソースを作成する

1. LUIS ポータルにサインインし、国/地域を選択して利用規約に同意します。 ポータルに [マイ アプリ] セクションが表示されている場合は、LUIS リソースが既に存在するため、次の手順は省略できます。

2. 表示された [Choose an authoring](作成の選択) ウィンドウで、Azure サブスクリプションと LUIS 作成リソースを見つけます。 リソースがない場合は、新しいものを作成できます。

   

   新しい作成リソースを作成するときは、次の情報を指定します。

   • [テナント名] : Azure サブスクリプションが関連付けられているテナント。
   • [Azure サブスクリプション名] : リソースに対して課金されるサブスクリプション。
   • [Azure リソース グループ名] : 選択または作成するカスタム リソース グループ名。 リソース グループを使用すると、アクセスと管理のために Azure リソースをグループ化できます。
   • [Azure リソース名] : 選択するカスタム名。作成および予測エンドポイント クエリの URL の一部として使用されます。
   • [Pricing tier](価格レベル) : 価格レベルによって、1 秒および 1 か月あたりの最大トランザクション数が決まります。

LUIS ポータルを使用して LUIS 予測リソースを作成する

1. アプリケーションの [管理] タブに移動します。

2. 左側のナビゲーションで、 [Azure リソース] を選択します。

3. [予測リソースを追加] ボタンを選択します。

   

   予測リソースが既にある場合は、それを追加します。 それ以外の場合は、 [Create a new prediction resource](新しい予測リソースの作成) を選択します。

   

LUIS ポータルなし

LUIS ポータルを使わずに LUIS リソースを作成する

Azure CLI を使用し、各リソースを個別に作成します。

ヒント

• 作成リソース kind は LUIS.Authoring
• 予測リソース kind は LUIS

1. Azure CLI にサインインします。

   az login
   

   このコマンドによりブラウザー開き、正しいアカウントを選択して、認証を行うことができます。

2. 種類が LUIS.Authoring で名前が my-luis-authoring-resource の LUIS オーサリング リソースを作成します。 それを、westus リージョンの my-resource-group という名前の "既存の" リソース グループに作成します。

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. 種類が LUIS で名前が my-luis-prediction-resource の LUIS 予測エンドポイント リソースを作成します。 それを、westus リージョンの my-resource-group という名前の "既存の" リソース グループに作成します。 Free レベルで提供されるものより高いスループットが必要であれば、F0 を S0 に変更します。 価格レベルとスループットに関する詳細を確認してください。

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

LUIS リソースを割り当てる

リソースを作成することは、必ずしも使用することを意味するわけではなく、アプリに割り当てる必要があります。 LUIS の 1 つのアプリまたはすべてのアプリに対して、オーサリング リソースを割り当てることができます。

LUIS ポータル

LUIS ポータルを使用してリソースを割り当てる

すべてのアプリに作成リソースを割り当てる

次の手順では、すべてのアプリに 1 つの作成リソースを割り当てます。

1. LUIS ポータルにサインインします。
2. 右上隅でユーザー アカウントを選択してから、 [設定] を選択します。
3. [ユーザー設定] ページで、 [Add authoring resource](オーサリング リソースの追加) を選択し、既存のオーサリング リソースを選択します。 [保存] を選択します。

特定のアプリにリソースを割り当てる

次の手順では、特定のアプリにリソースを割り当てます。

1. LUIS ポータルにサインインします。 [マイ アプリ] の一覧からアプリを選択します。

2. [管理]>[Azure リソース] に移動します。

   

3. [Prediction resource](予測リソース) タブまたは [Authoring resource](オーサリング リソース) タブで、 [Add prediction resource](予測リソースの追加) ボタンまたは [Add authoring resource](オーサリング リソースの追加) ボタンを選択します。

4. フォーム内のフィールドを使用して適切なリソースを探して、 [保存] を選択します。

LUIS ポータルなし

LUIS ポータルを使わずに予測リソースを割り当てる

CI/CD パイプラインのような自動化されたプロセスの場合、次の手順で LUIS アプリへの LUIS リソースの割り当てを自動化することできます。

1. 英数字の文字列である Azure Resource Manager トークン を取得します。 このトークンには有効期限があるため、すぐに使用してください。 次の Azure CLI コマンドを使うこともできます。

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. そのトークンを使用して、サブスクリプション間の LUIS ランタイム リソースを要求します。 API を使用して、ユーザー アカウントでアクセスできる LUIS Azure アカウントを取得 します。

   この POST API には、次の値が必要です。

   ヘッダー	値
   Authorization	Authorization の値は Bearer {token} です。 トークンの値の前に、Bearer という単語とスペースを 1 つ追加する必要があります。
   Ocp-Apim-Subscription-Key	実際のオーサリング キー。

   API により、LUIS サブスクリプションを表す JSON オブジェクトの配列が返されます。 返された値には、サブスクリプション ID、リソース グループ、および AccountName として返されるリソース名が含まれます。 LUIS アプリに割り当てる LUIS リソースである要素を、配列から見つけます。

3. アプリケーションへの LUIS Azure アカウントの割り当て API を使用して、LUIS リソースにトークンを割り当てます。

   この POST API には、次の値が必要です。

   Type	設定	値
   ヘッダー	Authorization	Authorization の値は Bearer {token} です。 トークンの値の前に、Bearer という単語とスペースを 1 つ追加する必要があります。
   ヘッダー	Ocp-Apim-Subscription-Key	実際のオーサリング キー。
   ヘッダー	Content-type	application/json
   Querystring	appid	LUIS アプリ ID。
   Body		{AzureSubscriptionId: ご使用のサブスクリプション ID, ResourceGroup: 予測リソースがあるリソース グループ名, AccountName: 予測リソースの名前}

   この API が正常に完了すると、201 - created status が返されます。

リソースの割り当てを解除する

リソースの割り当てを解除しても、Azure からそれは削除されません。 LUIS からのリンクが解除されるだけです。

LUIS ポータル

LUIS ポータルを使用してリソースの割り当てを解除する

1. LUIS ポータルにサインインして、 [マイ アプリ] の一覧からアプリを選択します。
2. [管理]>[Azure リソース] に移動します。
3. リソースの [Unassign resource](リソースの割り当て解除) ボタンを選択します。

LUIS ポータルなし

LUIS ポータルを使わずに、予測リソースの割り当てを解除する

1. 英数字の文字列である Azure Resource Manager トークン を取得します。 このトークンには有効期限があるため、すぐに使用してください。 次の Azure CLI コマンドを使うこともできます。

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. そのトークンを使用して、サブスクリプション間の LUIS ランタイム リソースを要求します。 ユーザー アカウントでアクセスできる LUIS ユーザー アカウント取得 API を使用します。

   この POST API には、次の値が必要です。

   ヘッダー	値
   Authorization	Authorization の値は Bearer {token} です。 トークンの値の前に、Bearer という単語とスペースを 1 つ追加する必要があります。
   Ocp-Apim-Subscription-Key	実際のオーサリング キー。

   API により、LUIS サブスクリプションを表す JSON オブジェクトの配列が返されます。 返された値には、サブスクリプション ID、リソース グループ、および AccountName として返されるリソース名が含まれます。 LUIS アプリに割り当てる LUIS リソースである要素を、配列から見つけます。

3. Unassign a LUIS Azure account from an application API を使用して、LUIS リソースにトークンを割り当てます。

   この DELETE API には、次の値が必要です。

   Type	設定	値
   ヘッダー	Authorization	Authorization の値は Bearer {token} です。 トークンの値の前に、Bearer という単語とスペースを 1 つ追加する必要があります。
   ヘッダー	Ocp-Apim-Subscription-Key	実際のオーサリング キー。
   ヘッダー	Content-type	application/json
   Querystring	appid	LUIS アプリ ID。
   Body		{AzureSubscriptionId: ご使用のサブスクリプション ID, ResourceGroup: 予測リソースがあるリソース グループ名, AccountName: 予測リソースの名前}

   この API が正常に完了すると、200 - OK status が返されます。

リソース所有権

LUIS リソースのような Azure リソースは、そのリソースが含まれるサブスクリプションによって所有されています。

リソースの所有権を変更するには、次のいずれかの操作を実行します。

• サブスクリプションの所有権を譲渡します。
• LUIS アプリをファイルとしてエクスポートしてから、別のサブスクリプションにアプリをインポートします。 エクスポートは、LUIS ポータルの [マイ アプリ] ページで使用できます。

リソース制限

オーサリング キーの作成の制限

サブスクリプションごとに、各リージョンで最大 10 個のオーサリング キーを作成できます。 公開リージョンは、オーサリング リージョンとは異なります。 クライアント アプリケーションを配置する公開リージョンに対応するオーサリング リージョンにアプリを作成してください。 オーサリング リージョンを公開リージョンにマップする方法の詳細については、オーサリング リージョンと公開リージョンに関するページを参照してください。

詳細については、リソースの制限に関するページを参照してください。

キーの使用制限に関するエラー

使用制限は、価格レベルに基づいています。

1 秒あたりのトランザクション数 (TPS) のクォータを超えると、HTTP 429 エラーが発生します。 1 か月あたりのトランザクション数 (TPM) のクォータを超えると、HTTP 403 エラーが発生します。

価格レベルを変更する

1. Azure portal で [すべてのリソース] に移動して、リソースを検索します。

   

2. 左側のメニューから [価格レベル] を選択して、使用可能な価格レベルを確認します。

3. 使用したい価格レベルを選択し、 [選択] をクリックして変更内容を保存します。 価格の変更が完了すると、価格レベル更新の通知が右上に表示されます。

Azure リソースのメトリックを表示する

Azure リソースの使用状況の概要を表示する

LUIS の使用状況に関する情報は Azure portal で見ることができます。 [概要] ページには、最近の呼び出しやエラーなどの概要が示されます。 LUIS エンドポイント要求を行う場合、変更が表示されるまで最大 5 分かかります。

Azure リソースの使用状況グラフのカスタマイズ

[メトリック] ページには、データのさらに詳細なビューが表示されます。 特定の期間とメトリックのメトリック グラフを構成できます。

トランザクション合計しきい値のアラート

トランザクションしきい値に達したこと (たとえば、トランザクション数が 10,000 になったこと) を知るには、アラートを作成します。

1. 左側のメニューから、[アラート] を選択します

2. 上部のメニューで、 [新しいアラート ルール] を選択します。

   

3. ［条件の追加］ を選択します

   

4. [呼び出し合計] を選択する

   

5. [アラート ロジック] セクション まで下にスクロールし、必要に応じて属性を設定し、 [完了] をクリック します。

   

6. アラート ルールのトリガー時に通知を送信したり、アクションを呼び出したりするには、 [アクション] セクションに移動し、アクション グループを追加します。

   

オーサリング キーをリセットする

移行されたオーサリング リソース アプリの場合: オーサリング キーが侵害された場合は、Azure portal のそのオーサリング リソースの [キー] ページでキーをリセットします。

移行されていないアプリの場合: LUIS ポータルのすべてのアプリでキーがリセットされます。 オーサリング API を使用してアプリを作成する場合は、Ocp-Apim-Subscription-Key の値を新しいキーに変更する必要があります。

Azure キーを再生成する

Azure portal の [キー] ページから、Azure キーを再生成できます。

アプリの所有権、アクセス、セキュリティ

アプリは Azure リソースによって定義され、それは所有者のサブスクリプションによって決まります。

LUIS アプリを移行できます。 Azure portal または Azure CLI を使用してそれを行う方法については、次のリソースを参照してください。

• リソースを新しいリソース グループまたはサブスクリプションに移動する
• 同じサブスクリプション内またはサブスクリプション間でリソースを移行する

次のステップ

• バージョンを使用してアプリのライフ サイクルを制御する方法を確認します。