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

Статья
10/16/2024

После успешного добавления развертывания можно запросить развертывание, чтобы извлечь намерения и прогнозы сущностей из речевого фрагмента на основе модели, назначенной развертыванию. Вы можете запросить развертывание программным способом через 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

Следующие шаги

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

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