Como consultar o runtime de previsão com o texto do usuário

  • Artigo

Importante

O LUIS será desativado em 1º de outubro de 2025 e, a partir de 1º de abril de 2023, você não poderá criar novos recursos do LUIS. É recomendável migrar seus aplicativos LUIS para a compreensão da linguagem coloquial a fim de usufruir do suporte contínuo ao produto e dos recursos multilíngues.

Para entender o que um ponto de extremidade de previsão do LUIS retorna, exiba um resultado de previsão em um navegador da Web.

Pré-requisitos

Para consultar um aplicativo público, você precisará de:

  • Suas informações de recurso do LUIS (Reconhecimento vocal):
    • Chave de previsão, que pode ser obtida do Portal do LUIS. Caso você ainda não tenha uma assinatura para criar uma chave, registre-se em uma conta gratuita.
    • Subdomínio do ponto de extremidade de previsão – o subdomínio também é o nome do recurso LUIS.
  • Uma ID do aplicativo LUIS – use a ID do aplicativo IoT público de df67dcdb-c37d-46af-88e1-8b97951ca1c2. A consulta de usuário usada no código de início rápido é específica para esse aplicativo. Esse aplicativo deve funcionar com qualquer recurso de previsão diferente das regiões da Europa ou da Austrália, pois ele usa "westus" como a região de criação.

Usar o navegador para ver as previsões

  1. Abra um navegador da Web.

  2. Use as URLs completas abaixo, substituindo YOUR-KEY por sua própria chave de Previsão do LUIS. As solicitações são solicitações GET e incluem a autorização, com a chave de Previsão do LUIS, como um parâmetro de cadeia de consulta.

    O formato da URL V3 para uma solicitação de ponto de extremidade GET (por slots) é:

    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. Cole a URL em uma janela do navegador e pressione Enter. O navegador exibe um resultado JSON que indica que o LUIS detecta a intenção HomeAutomation.TurnOn como a intenção principal e a entidade HomeAutomation.Operation com o valor on.

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

  4. Para ver todas as intenções, adicione o parâmetro de cadeia de consulta apropriado.

    Adicione show-all-intents=true ao final da cadeia de consulta para mostrar todas as intenções e verbose=true para retornar todas as informações detalhadas de entidades.

    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"
            ]
        }
    }
}

Próximas etapas