Развертывание запросов для прогнозов намерений

Статья
12/19/2023

После успешного добавления развернутой службы можно отправить ей запрос для прогнозирования намерения и сущностей в речевом фрагменте на основе модели, назначенной этой службе. Вы можете запросить развертывание программным способом через API прогнозирования или через клиентские библиотеки (пакет SDK Azure).

Тестирование развернутой модели

Вы можете использовать Language Studio для отправки речевого фрагмента, получения прогнозов и визуализации результатов.

Тестирование модели в Language Studio

В меню слева выберите Testing deployments (Тестирование развертываний).
Выберите модель для тестирования. Можно тестировать только модели, назначенные развертываниям.
Выберите имя развернутой службы в соответствующем раскрывающемся списке.
В текстовом поле введите речевой фрагмент для тестирования.
В верхнем меню выберите Запустить тест.
После выполнения теста вы получите результат с ответом модели. Результаты можно просмотреть в представлении карточек сущностей или в формате JSON.

Отправка запроса рабочего процесса оркестрации

После успешного завершения задания развертывания выберите нужное развертывание и в верхнем меню выберите Получить URL-адрес прогнозирования.
В появившемся окне скопируйте URL-адрес и текст примера запроса в командную строку. Замените <YOUR_QUERY_HERE> фактическим текстом, который вы хотите отправить на определение намерения и извлечения сущности.
Отправьте запрос POST для получения URL-адреса в терминал или командную строку. Если запрос выполнен успешно, вы получите отклик 202 с результатами API.

Сначала необходимо получить ключ ресурса и конечную точку.

Перейдите на страницу обзора ресурса на портале Azure. В меню слева выберите Ключи и конечная точка. Конечная точка и ключ вам понадобятся для запросов API.

Отправка запроса модели

Создайте запрос POST, используя следующий URL-адрес, заголовки и текст JSON, чтобы приступить к развертыванию модели процесса оркестрации.

URL-адрес запроса

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

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{API-VERSION}`	Версия вызываемого API.	`2023-04-01`

Заголовки

Используйте следующий заголовок для проверки подлинности запроса.

Клавиши	Значение
`Ocp-Apim-Subscription-Key`	Ключ к ресурсу. Используется для проверки подлинности запросов API.

Текст запроса

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

Текст ответа

После отправки запроса вы получите следующий ответ для прогнозирования.

{
  "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": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Сначала необходимо получить ключ ресурса и конечную точку.

Использование клиентских библиотек (пакет SDK для Azure)

Вы также можете использовать клиентские библиотеки, предоставляемые пакетом SDK для Azure, для отправки запросов в модель.

Примечание

Клиентская библиотека для распознавания устной речи доступна только для:

.NET
Python

Перейдите на страницу обзора ресурса на портале Azure.
В меню слева выберите Ключи и конечная точка. Используйте конечную точку для запросов API. Вам потребуется ключ для заголовка Ocp-Apim-Subscription-Key.
Скачайте и установите пакет клиентской библиотеки для выбранного языка:

Язык Версия пакета

.NET 1.0.0

Python 1.0.0
После установки клиентской библиотеки используйте следующие примеры на GitHub, чтобы начать вызов API.
- C#
- Python
Дополнительные сведения приведены в следующей справочной документации:
- C#
- Python

Язык	Версия пакета
.NET	1.0.0
Python	1.0.0

Дальнейшие действия

Общий обзор рабочих процессов оркестрации

Поделиться через