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 em busca de previsões de intenção e entidades a partir de sua declaração com base no modelo atribuído à implantação. Você pode consultar a API de Previsão de implantação programaticamente ou por meio das bibliotecas de Cliente (SDK do Azure).

Testar modelo implantado

Você pode usar o Language Studio para enviar uma declaração, obter previsões e visualizar os resultados.

Para testar o seu modelo a partir do Language Studio

1. Selecione Testando implantações no menu do lado esquerdo.

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

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

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

5. No menu superior, selecione Executar o teste.

6. Depois de executar o teste, você verá a resposta do modelo no resultado. Você pode exibir os resultados na visualização de cartões de entidades ou visualizá-los no formato JSON.

   

---

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

Estúdio de Idiomas

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

   

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

3. Envie a POST solicitação cURL no 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 ponto de extremidade:

Vá para a página de visão geral do recurso no portal do Azure. No menu do lado esquerdo, selecione Teclas e Ponto de extremidade. Você usará o endpoint e a chave para solicitações de API.

Consultar o seu modelo

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

URL do Pedido

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

Marcador de Posição	valor	Exemplo
{ENDPOINT}	O ponto de extremidade para autenticar 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.

Key	valor
Ocp-Apim-Subscription-Key	A chave para o seu recurso. Usado para autenticar suas solicitações de API.

Corpo do Pedido

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

Organismo de resposta

Depois de enviar o pedido, 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 ponto de extremidade:

Vá para a página de visão geral do recurso no portal do Azure. No menu do lado esquerdo, selecione Teclas e Ponto de extremidade. Você usará o endpoint e a chave para solicitações de API.

Usar as bibliotecas de cliente (SDK do Azure)

Você também pode usar as bibliotecas de cliente fornecidas pelo SDK do Azure para enviar solicitações ao seu modelo.

Nota

A biblioteca de cliente para compreensão de linguagem conversacional só está disponível para:

• .NET
• Python

1. Vá para a página de visão geral dos recursos no portal do Azure

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

   

3. Transfira e instale o pacote de biblioteca de cliente para o idioma da sua escolha:

   Idioma	Versão de pacote
   .NET	1.0.0
   Python	1.0.0

4. Depois de instalar a biblioteca do cliente, use os seguintes exemplos no GitHub para começar a chamar a API.

   • C#
   • Python

5. Consulte a seguinte documentação de referência para obter mais informações:

   • C#
   • Python

Próximos passos

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