Enviar solicitações de previsão para uma implantaçã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 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 uma declaração, obter previsões e visualizar os resultados.

Para testar seus modelos implantados de dentro do Language Studio:

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

2. Para projetos multilíngues, na lista suspensa Selecionar idioma do 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 declarações relacionadas a e-mail, você pode digitar Excluir este e-mail.

5. Na parte superior da página, selecione Executar o teste.

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

---

Enviar uma solicitação de compreensão de idioma de conversaçã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.

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

4. 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 ponto de extremidade e a chave para as 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 compreensão de linguagem conversacional.

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

Chave	Marcador de Posição	valor	Exemplo
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	O enunciado do qual você deseja prever sua 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

Depois de 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 da amostra	Description
query	"Leia o e-mail de Matt"	O texto enviado para consulta.
topIntent	"Ler"	A intenção prevista com maior pontuação de confiança.
intenções	[]	Uma lista de todas as intenções que foram previstas para o texto da consulta, cada uma delas com uma pontuação de confiança.
entidades	[]	Matriz que contém a lista de entidades extraídas do texto da consulta.

Resposta da 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 em seu projeto.

• As intenções e entidades incluem uma pontuação de confiança entre 0,0 e 1,0 associada à confiança do modelo em prever um determinado elemento em seu projeto.
• A intenção de pontuação máxima está contida em seu próprio parâmetro.
• Apenas as entidades previstas aparecerão na sua resposta.
• As entidades indicam:
  • O texto da entidade que foi extraída
  • Seu local de início denotado 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 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 da compreensão da linguagem conversacional