Развертывание модели и извлечение сущностей из текста с помощью API среды выполнения

Статья
12/19/2023

Если вы удовлетворены работой модели, значит она готова к развертыванию и использованию для распознавания сущностей в тексте. Развернутая модель становится доступной для использования через API прогнозирования.

Необходимые компоненты

Успешно созданный проект с настроенной учетной записью хранения Azure.
Текстовые данные, отправленные в учетную запись хранения.
Данные с метками и успешно обученная модель.
Изученные сведения об оценке модели для определения ее эффективности.

Дополнительные сведения см. в статье Жизненный цикл разработки проекта.

Развертывание модели

После проверки производительности модели и принятия решения об ее использовании в имеющейся среде, необходимо назначить ее развертыванию. Назначаемая развертыванию модель становится доступной для использования с помощью API прогнозирования. Рекомендуется создать развертывание, называемое производственным, которому вы назначите созданную на данный момент лучшую модель, и будете использовать ее в своей системе. Можно создать другое развертывание, называемое промежуточным, которому можно назначить текущую рабочую модель, чтобы ее проверить. В проекте может быть не более 10 развертываний.

Language Studio
REST API;

Чтобы развернуть модель в студии службы "Язык", выполните следующие действия.

В меню слева выберите Развертывание модели.
Выберите " Добавить развертывание", чтобы запустить новое задание развертывания.
Выберите Создать развертывание, чтобы создать развертывание и назначить обученную модель из раскрывающегося списка ниже. Можно также выбрать вариант Overwrite an existing deployment (Перезаписать существующее развертывание) и выбрать обученную модель, которую требуется назначить развертыванию, в раскрывающемся списке ниже.

Примечание.

Для перезаписи существующего развертывания не требуется вносить изменения в вызов API прогнозирования, но после этого вы будете получать результаты от новой назначенной модели.
Выберите "Развернуть" , чтобы запустить задание развертывания.
После успешного развертывания рядом с ним появится дата окончания срока действия. Окончание срока действия развертывания означает, что модель становится недоступной для использования в целях прогнозирования, что обычно происходит через двенадцать месяцев после окончания срока действия конфигурации обучения.

Отправка задания развертывания

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

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{DEPLOYMENT-NAME}`	Имя развертывания. Это значение учитывает регистр.	`staging`
`{API-VERSION}`	Версия вызываемого API. Указанное здесь значение определяет последнюю выпущенную версию модели. Дополнительные сведения о других доступных версиях API см. в статье Жизненный цикл модели.	`2022-05-01`

Заголовки

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

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

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

Используйте следующий код JSON в тексте запроса. Используйте имя модели, назначаемое развертыванию.

{
  "trainedModelLabel": "{MODEL-NAME}"
}

Ключ	Заполнитель	Значение	Пример
trainedModelLabel	`{MODEL-NAME}`	Имя модели, которое будет назначено развертыванию. Имена можно назначить только успешно обученным моделям. Это значение учитывает регистр.	`myModel`

После отправки запроса API вы получите ответ 202, указывающий, что задание было отправлено правильно. Извлеките значение operation-location из заголовков ответа. Оно будет иметь следующий формат:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} используется для идентификации запроса, так как эта операция является асинхронной. Этот URL-адрес можно использовать для получения состояния развертывания.

Получение состояния задания развертывания

Используйте следующий запрос GET для запроса состояния задания развертывания. Используйте URL-адрес, полученный на предыдущем шаге, или замените приведенные ниже значения заполнителей собственными значениями.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{DEPLOYMENT-NAME}`	Имя развертывания. Это значение учитывает регистр.	`staging`
`{JOB-ID}`	Идентификатор для поиска состояния обучения модели. Это значение находится в заголовке `location`, полученном на предыдущем шаге.	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Версия вызываемого API. Указанное здесь значение определяет последнюю выпущенную версию модели. Дополнительные сведения о других доступных версиях API см. в статье Жизненный цикл модели.	`2022-05-01`

Заголовки

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

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

Текст ответа

После отправки запроса вы получите следующий ответ. Продолжайте опрос этой конечной точки до тех пор, пока значение параметра Состояние не изменится на "Выполнено". Необходимо получить код 200, указывающий на успешное выполнение запроса.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Переключить развертывания

Если после завершения тестирования модели, назначенной одному развертыванию, вы хотите назначить эту модель другому развертыванию, можно переключить эти два развертывания. При переключении развертываний модель, назначенная первому развертыванию, назначается второму развертыванию. Затем модель, назначенная второму развертыванию, назначается первому развертыванию. Этот процесс можно использовать для переключений производственных и промежуточных развертываний, когда требуется взять модель, назначенную промежуточному развертыванию, и назначить ее производственному развертыванию.

Language Studio
REST API;

Чтобы переключить развертывания из Language Studio, выполните указанные далее действия.

На странице "Развертывание модели" выберите два развертывания, которые вы хотите заменить, и выберите "Переключение развертываний" в верхнем меню.
В появившемся окне выберите имена развертываний, которые вы будете переключать.

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

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{API-VERSION}`	Версия вызываемого API. Значение, указанное здесь, предназначено для последней выпущенной версии модели.	`2022-05-01`

Заголовки

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

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

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

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

Ключ	Заполнитель	Значение	Пример
firstDeploymentName	`{FIRST-DEPLOYMENT-NAME}`	Имя первого развертывания. Это значение учитывает регистр.	`production`
secondDeploymentName	`{SECOND-DEPLOYMENT-NAME}`	Имя второго развертывания. Это значение учитывает регистр.	`staging`

После отправки запроса API вы получите ответ 202, указывающий на успешное выполнение.

Чтобы удалить развертывание из Студии Языка, перейдите на страницу Развертывание модели. Выберите развертывание, которое нужно удалить, и выберите пункт "Удалить развертывание " в верхнем меню.

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

Запросить URL-адрес

{Endpoint}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{deploymentName}?api-version={API-VERSION}

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{DEPLOYMENT-NAME}`	Имя, используемое для развертывания. Это значение учитывает регистр.	`prod`
`{API-VERSION}`	Версия вызываемого API. Указанное здесь значение определяет последнюю выпущенную версию модели. Дополнительные сведения о других доступных версиях API см. в статье Жизненный цикл модели.	`2022-05-01`

Заголовки

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

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

После отправки запроса API вы получите ответ 202, означающий успешное выполнение (развертывание было удалено). Ответ будет содержать заголовок Operation-Location, используемый для проверки состояния задания.

Назначение ресурсов развертывания

Проект можно развернуть в нескольких регионах , назначив различные языковые ресурсы, существующие в разных регионах.

Language Studio
REST API;

Чтобы назначить ресурсы развертывания в других регионах в Language Studio, выполните следующее:

Убедитесь, что вы назначили себя владельцем языка Cognitive Services ресурсу, используемому для создания проекта.
Перейдите на страницу развертывания модели в Language Studio.
Перейдите на вкладку "Регионы ".
Выберите " Добавить ресурс развертывания".
Выберите ресурс языка в другом регионе.

Теперь вы готовы развернуть проект в регионах, где назначены ресурсы.

Назначение ресурсов развертывания программным способом требует проверки подлинности Microsoft Entra. Идентификатор Microsoft Entra используется для подтверждения доступа к ресурсам, которые вы хотите назначить проекту для развертывания в нескольких регионах. Чтобы программно использовать проверку подлинности Microsoft Entra при вызове REST API, ознакомьтесь со статьей по службам ИИ Azure.

Назначить ресурс

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

Запросить URL-адрес

При создании запроса API используйте следующий URL-адрес. Замените значения заполнителей ниже собственными значениями.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}

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

Заголовки

Используйте проверку подлинности Microsoft Entra для проверки подлинности этого API.

Текст

Используйте следующий пример JSON в качестве текста.

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

Ключ	Заполнитель	Значение	Пример
`azureResourceId`	`{AZURE-RESOURCE-ID}`	Полный путь к идентификатору ресурса, который нужно назначить. В портал Azure на вкладке "Свойства" ресурса в поле "Идентификатор ресурса".	`/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource`
`customDomain`	`{CUSTOM-DOMAIN}`	Настраиваемый поддомен ресурса, который требуется назначить. В портал Azure на вкладке "Ключи" и "Конечная точка" ресурса в качестве поля "Конечная точка" в URL-адресе`https://<your-custom-subdomain>.cognitiveservices.azure.com/`	`contosoresource`
`region`	`{REGION-CODE}`	Код региона, указывающий регион ресурса, который требуется назначить. Находится в портал Azure на вкладке "Ключи" и "Конечная точка" ресурса в поле "Расположение или регион".	`eastus`

Получение состояния ресурса

Используйте следующий запрос GET , чтобы получить состояние задания ресурса развертывания. Замените значения заполнителей ниже собственными значениями.

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/assign/jobs/{JOB-ID}?api-version={API-VERSION}

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{JOB-ID}`	Идентификатор задания для получения состояния развертывания. Это значение заголовка, полученное `operation-location` от API в ответ на назначение запроса ресурса развертывания.	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Версия вызываемого API.	`2022-10-01-preview`

Заголовки

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

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

Текст ответа

После отправки запроса вы получите следующий ответ. Продолжайте опрашивать эту конечную точку, пока status параметр не изменится succeeded.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Отмена назначения ресурсов развертывания

При отмене назначения или удалении ресурса развертывания из проекта вы также удалите все развертывания, развернутые в регионе этого ресурса.

Language Studio
REST API;

Чтобы отменить назначение или удаление ресурсов развертывания в других регионах с помощью Language Studio:

Перейдите на вкладку "Регионы " на странице "Развертывание модели ".
Выберите ресурс, который вы хотите отменить.
Нажмите кнопку "Удалить назначение ".
В появившемся окне введите имя ресурса, который требуется удалить.

Отменить присвоение ресурса

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

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}

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

Заголовки

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

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

Текст

Используйте следующий пример JSON в качестве текста.

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

Ключ	Заполнитель	Значение	Пример
`assignedResourceIds`	`{AZURE-RESOURCE-ID}`	Полный путь к идентификатору ресурса, который требуется отменить. В портал Azure на вкладке "Свойства" ресурса в качестве поля "Идентификатор ресурса".	`/subscriptions/d73a1925-0000-0000-0000-0000c5fe888e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource`

Получение состояния ресурса отмены назначения

Используйте следующий запрос GET , чтобы получить состояние задания ресурсов развертывания unassign. Замените значения заполнителей ниже собственными значениями.

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/unassign/jobs/{JOB-ID}?api-version={API-VERSION}

Заполнитель	Значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{JOB-ID}`	Идентификатор задания для получения состояния развертывания. Это значение заголовка, полученное `operation-location` от API в ответ на запрос ресурса развертывания unassign.	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx`
`{API-VERSION}`	Версия вызываемого API.	`2022-10-01-preview`

Заголовки

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

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

Текст ответа

После отправки запроса вы получите следующий ответ. Продолжайте опрос этой конечной точки до тех пор, пока значение параметра Состояние не изменится на "Выполнено".

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

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

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

Развертывание модели и извлечение сущностей из текста с помощью API среды выполнения

Необходимые компоненты

Развертывание модели

Переключить развертывания

Удалить развертывание

Назначение ресурсов развертывания

Отмена назначения ресурсов развертывания

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

Дополнительные ресурсы