Implantação de consulta para previsões de intenção

Depois que a implantação for adicionada com êxito, você poderá consultar a implantação quanto à intenção e às previsões das entidades no enunciado de acordo com o modelo atribuído à implantação. Você pode consultar a implantação programaticamente usando a API de Previsão ou por meio das Bibliotecas de cliente (SDK do Azure).

Testar modelo implantado

Você pode usar o Language Studio para enviar um enunciado, obter previsões e visualizar os resultados.

Para testar seu modelo do Language Studio

1. Selecione Testar implantações no menu à esquerda.

2. Selecione o modelo que deseja testar. Você só pode testar modelos atribuídos a implantações.

3. Na lista suspensa de nome da implantação, selecione o nome da sua implantação.

4. Na caixa de texto, insira um enunciado para testar.

5. No menu superior, selecione Executar o teste.

6. Após executar o teste, você deverá ver a resposta do modelo no resultado. É possível exibir os resultados no modo de exibição de cartões de entidades ou então exibi-los no formato JSON.

   

---

Enviar uma solicitação de fluxo de trabalho de orquestração

Language Studio

1. Depois que o trabalho de implantação for concluído com êxito, selecione a implantação que você deseja usar e, no menu superior, clique em Obter URL de previsão.

   

2. Na janela exibida, copie a URL de solicitação de exemplo e o corpo para a linha de comando. Substitua <YOUR_QUERY_HERE> pelo texto real que você deseja enviar para extrair intenções e entidades.

3. Envie a solicitação cURL POST em seu terminal ou prompt de comando. Você receberá uma resposta 202 com os resultados da API se a solicitação for bem-sucedida.

APIs REST

Primeiro, você precisará obter sua chave de recurso e o ponto de extremidade:

No portal do Azure, vá para a página de visão geral do recurso. No menu do lado esquerdo, selecione Chaves e Ponto de Extremidade. Você usará o ponto de extremidade e a chave para as solicitações de API.

Consultar seu modelo

Crie uma solicitaçãoPOST usando a URL, os cabeçalhos e o corpo JSON a seguir para começar a testar um modelo do fluxo de trabalho de orquestração.

URL da solicitação

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

Espaço reservado	Valor	Exemplo
{ENDPOINT}	O ponto de extremidade para autenticação de sua solicitação de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	A versão da API que você está chamando.	2023-04-01

Cabeçalhos

Use o cabeçalho a seguir para autenticar sua solicitação.

Chave	Valor
Ocp-Apim-Subscription-Key	A chave para o recurso. Usado para autenticação de suas solicitações de API.

Corpo da solicitação

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "text": "Text1",
      "participantId": "1",
      "id": "1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "directTarget": "qnaProject",
    "targetProjectParameters": {
      "qnaProject": {
        "targetProjectKind": "QuestionAnswering",
        "callingOptions": {
          "context": {
            "previousUserQuery": "Meet Surface Pro 4",
            "previousQnaId": 4
          },
          "top": 1,
          "question": "App Service overview"
        }
      }
    }
  }
}

Corpo da resposta

Depois de enviar a solicitação, você receberá a seguinte resposta para a previsão!

{
  "kind": "ConversationResult",
  "result": {
    "query": "App Service overview",
    "prediction": {
      "projectKind": "Orchestration",
      "topIntent": "qnaTargetApp",
      "intents": {
        "qnaTargetApp": {
          "targetProjectKind": "QuestionAnswering",
          "confidenceScore": 1,
          "result": {
            "answers": [
              {
                "questions": [
                  "App Service overview"
                ],
                "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.",
                "confidenceScore": 0.7384000000000001,
                "id": 1,
                "source": "https://learn.microsoft.com/azure/app-service/overview",
                "metadata": {},
                "dialog": {
                  "isContextOnly": false,
                  "prompts": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Bibliotecas de cliente (SDK do Azure)

Primeiro, você precisará obter sua chave de recurso e o ponto de extremidade:

No portal do Azure, vá para a página de visão geral do recurso. No menu do lado esquerdo, selecione Chaves e Ponto de Extremidade. Você usará o ponto de extremidade e a chave para as solicitações de API.

Usar as bibliotecas de clientes (SDK do Azure)

Use também as bibliotecas de clientes fornecidas pelo SDK do Azure para enviar solicitações ao modelo.

Observação

A biblioteca de clientes para a compreensão da linguagem coloquial está disponível apenas para:

• .NET
• Python

1. No portal do Azure, vá para a página de visão geral do recurso

2. No menu do lado esquerdo, selecione Chaves e Ponto de Extremidade. Use o ponto de extremidade para as solicitações de API, e você precisará da chave para o cabeçalho Ocp-Apim-Subscription-Key.

   

3. Baixe e instale o pacote de biblioteca de clientes para sua linguagem de escolha:

   Idioma	Versão do pacote
   .NET	1.0.0
   Python	1.0.0

4. Após instalar a biblioteca de clientes, use os exemplos a seguir no GitHub para iniciar a chamada à API.

   • C#
   • Python

5. Para obter mais informações, confira a seguinte documentação de referência:

   • C#
   • Python

Próximas etapas

• Visão geral do fluxo de trabalho de orquestração