Enviar solicitações de previsão para uma implantação

Depois que a implantação for adicionada com êxito, você poderá consultá-la 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 por meio da 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 os modelos implantados de dentro do Language Studio:

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

2. Para projetos multilíngues, na lista suspensa Selecionar idioma de texto, selecione o idioma do enunciado que você está testando.

3. Na lista suspensa Nome da implantação, selecione o nome da implantação correspondente ao modelo que você deseja testar. Você só pode testar modelos atribuídos a implantações.

4. Na caixa de texto, insira um enunciado para testar. Por exemplo, se você criou um aplicativo para enunciados relacionados a email, poderá inserir Excluir este email.

5. Na parte superior da página, 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 compreensão da linguagem coloquial

Language Studio

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 de solicitação de exemplo e o corpo para a linha de comando.

3. Substitua <YOUR_QUERY_HERE> pelo texto real que você deseja enviar para extrair intenções e entidades.

4. 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ção POST usando a URL, os cabeçalhos e o corpo JSON a seguir para começar a testar um modelo de compreensão da linguagem coloquial.

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": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Chave	Espaço reservado	Valor	Exemplo
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	O enunciado do qual você deseja prever a intenção e extrair entidades.	"Read Matt's email
projectName	{PROJECT-NAME}	O nome do seu projeto. Esse valor diferencia maiúsculas de minúsculas.	myProject
deploymentName	{DEPLOYMENT-NAME}	O nome da sua implantação. Esse valor diferencia maiúsculas de minúsculas.	staging

Após enviar a solicitação, você receberá a seguinte resposta para a previsão

Corpo da resposta

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Chave	Valor de exemplo	Descrição
Consulta	"Ler o email do Marcos"	o texto enviado para a consulta.
topIntent	"Ler"	A intenção prevista com a maior pontuação de confiança.
intenções	[]	Uma lista de todas as intenções previstas para o texto da consulta, cada qual com uma pontuação de confiança.
entidades	[]	matriz que contém a lista de entidades extraídas do texto da consulta.

Resposta de API para um projeto de conversas

Em um projeto de conversas, você obterá previsões para suas intenções e entidades que estão presentes no seu projeto.

• As intenções e as entidades incluem uma pontuação de confiança entre 0,0 e 1,0 associada à confiança do modelo sobre a previsão de um determinado elemento em seu projeto.
• A principal intenção de pontuação está contida no próprio parâmetro.
• Somente as entidades previstas aparecerão em sua resposta.
• As entidades indicam:
  • O texto da entidade que foi extraído
  • O local de início indicado por um valor de deslocamento
  • O comprimento do texto da entidade indicado por um valor de comprimento

Bibliotecas de cliente (SDK do Azure)

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 de Reconhecimento vocal de conversação