次の方法で共有

ユーザー テキストを使用して予測ランタイムを照会する方法

重要

Language Understanding Intelligent Service (LUIS) は、2026 年 3 月 31 日に完全に廃止されます。 LUIS リソースの作成は使用できません。 2025 年 10 月 31 日以降、LUIS ポータルは使用できなくなります。 継続的な製品サポートと多言語機能のベネフィットを得るために、LUIS アプリケーションを会話言語理解に移行することをお勧めします。

LUIS の予測エンドポイントから返される内容を理解するために、予測結果を Web ブラウザーで表示します。

前提条件

パブリック アプリのクエリには、以下が必要です。

  • お使いの Language Understanding (LUIS) リソース情報:
    • 予測キー - LUIS ポータルから取得できます。 まだキーを作成するサブスクリプションがない場合は、無料アカウントに登録できます。
    • 予測エンドポイント サブドメイン - サブドメインは、お使いの LUIS リソースの名前でもあります。
  • LUIS アプリ ID - パブリック IoT アプリ ID df67dcdb-c37d-46af-88e1-8b97951ca1c2 を使用します。 クイックスタートのコードで使用されるユーザー クエリは、そのアプリに固有のものです。 このアプリは、オーサリング リージョンとして "westus" を使用するため、ヨーロッパ リージョンまたはオーストラリア リージョン以外の予測リソースで動作するはずです。

ブラウザーを使用して予測を表示する

  1. Web ブラウザーを開きます。

  2. 以下の完全な URL を使用して、YOUR-KEY を独自の LUIS 予測キーに置き換えます。 要求は GET 要求であり、LUIS 予測キーと共に、クエリ文字列パラメーターとして承認が含まれます。

    GET エンドポイント (スロットによる) 要求に使う V3 URL の形式は、次のとおりです。

    https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2/slots/production/predict?query=turn on all lights&subscription-key=YOUR-LUIS-PREDICTION-KEY

  3. この URL をブラウザー ウィンドウに貼り付け、Enter キーを押します。 HomeAutomation.TurnOn の意図が最上位の意図であることと、値が HomeAutomation.Operation の on エンティティが LUIS で検出されたことを示す JSON 結果がブラウザーに表示されます。

    {
    "query": "turn on all lights",
    "prediction": {
        "topIntent": "HomeAutomation.TurnOn",
        "intents": {
            "HomeAutomation.TurnOn": {
                "score": 0.5375382
            }
        },
        "entities": {
            "HomeAutomation.Operation": [
                "on"
            ]
        }
    }
}

  4. すべての意図を表示するには、適切なクエリ文字列パラメーターを追加します。

    show-all-intents=trueために をクエリ文字列の末尾に追加し、エンティティに関するすべての詳細情報を返すために verbose=trueを追加します。

    https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/df67dcdb-c37d-46af-88e1-8b97951ca1c2/slots/production/predict?query=turn on all lights&subscription-key=YOUR-LUIS-PREDICTION-KEY&show-all-intents=true&verbose=true

    {
    "query": "turn off the living room light",
    "prediction": {
        "topIntent": "HomeAutomation.TurnOn",
        "intents": {
            "HomeAutomation.TurnOn": {
                "score": 0.5375382
            },
            "None": {
                "score": 0.08687421
            },
            "HomeAutomation.TurnOff": {
                "score": 0.0207554
            }
        },
        "entities": {
            "HomeAutomation.Operation": [
                "on"
            ]
        }
    }
}

次のステップ