如何使用用户文本查询预测运行时

重要

LUIS 将于 2025 年 10 月 1 日停用,从 2023 年 4 月 1 日开始,你将无法创建新的 LUIS 资源。 建议将 LUIS 应用程序迁移对话语言理解,以便从持续的产品支持和多语言功能中受益。

若要了解 LUIS 预测终结点返回的内容,请在 Web 浏览器中查看预测结果。

先决条件

若要查询公共应用,需要:

  • 语言理解 (LUIS) 资源信息:
    • 预测密钥 - 可从 LUIS 门户获取。 如果还没有用于创建密钥的订阅,可以注册一个试用版
    • 预测终结点子域 - 该子域也是 LUIS 资源的名称 。
  • LUIS 应用 ID - 使用 df67dcdb-c37d-46af-88e1-8b97951ca1c2 的公共 IoT 应用 ID。 快速入门代码中使用的用户查询特定于该应用。

使用浏览器查看预测

  1. 打开 Web 浏览器。

  2. 使用以下完整 URL(请将 YOUR-KEY 替换为你自己的 LUIS 预测密钥)。 请求为 GET 请求,并包含授权(使用 LUIS 预测密钥作为查询字符串参数)。

    GET 终结点(按槽)请求的 V3 URL 格式为:

    https://YOUR-LUIS-ENDPOINT-SUBDOMAIN.api.cognitive.azure.cn/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。 浏览器显示的 JSON 结果指示 LUIS 将 HomeAutomation.TurnOn 意向检测为首要意向,并检测到值为 onHomeAutomation.Operation 实体。

    {
        "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.azure.cn/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"
                ]
            }
        }
    }
    

后续步骤