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

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

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

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

Для получения дополнительной информации см. разделжизненного цикла разработки проекта.

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

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

Microsoft Foundry
REST API;

Сведения о развертывании пользовательской модели в Foundry см. в статье"Развертывание точно настроенной модели ".

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

Отправьте запрос 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. Значение, на которое ссылается, предназначено для последней версии, выпущенной. Дополнительные сведения см. в разделе"Жизненный цикл модели".	`2022-05-01`

Заголовки

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

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

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

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

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

Ключ	Заполнитель	Значение	Пример
ярлык обученной модели	`{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. Значение, на которое ссылается, предназначено для последней версии, выпущенной. Дополнительные сведения см. в разделе"Жизненный цикл модели".	`2022-05-01`

Заголовки

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

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

Текст ответа

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

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

Поменять местами развертывания

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

Foundry
REST API;

Чтобы заменить развернутую модель, можно обменять развернутую модель с другой моделью в одном регионе:

Выберите имя модели в разделе "Имя" , а затем выберите " Развернуть модель".
Выберите "Замена модели".

Повторное развертывание занимает несколько минут. В то же время развернутая модель будет доступна для использования с API переводчика до завершения этого процесса.

Создайте запрос 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}"
}

Ключ	Заполнитель	Значение	Пример
перваяИмяРазвертывания	`{FIRST-DEPLOYMENT-NAME}`	Название для вашего первого развертывания. Значение чувствительно к регистру.	`production`
второе_имя_развертывания	`{SECOND-DEPLOYMENT-NAME}`	Название для вашего второго развертывания. Значение чувствительно к регистру.	`staging`

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

Если проект больше не нужен, его можно удалить из Foundry.

Перейдите на домашнюю страницу Foundry . Начните процесс аутентификации, выполнив вход, если вы еще не завершили этот шаг и ваш сеанс не активен.
Выберите проект, который нужно удалить из раздела Keep building with Foundry
Выберите центр управления.
Выберите "Удалить проект".

Чтобы удалить концентратор вместе со всеми его проектами:

Перейдите на вкладку «Обзор» в секции «Хаб».
Справа нажмите кнопку "Удалить узел".
Ссылка открывает портал Azure для удаления концентратора.

Создайте запрос DELETE, используя следующий 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. Значение, на которое ссылается, предназначено для последней версии, выпущенной. Дополнительные сведения см. в разделе"Жизненный цикл модели".	`2022-05-01`

Заголовки

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

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

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

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

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

Foundry
REST API;

Дополнительные сведения о развертывании пользовательской модели см. в статье"Развертывание точно настроенной модели"

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

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

Отправьте запрос 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}`	Полный путь ID ресурса, который вы хотите назначить. В портал Azure на вкладке "Свойства" ресурса в поле "Идентификатор ресурса".	`/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource`
`customDomain`	`{CUSTOM-DOMAIN}`	Настраиваемый поддомен ресурса, который требуется назначить. Найдено в портале Azure на вкладке Ключи и Конечная точка ресурса, как поле Конечная точка в URL-адресе`https://<your-custom-subdomain>.cognitiveservices.azure.com/`	`contosoresource`
`region`	`{REGION-CODE}`	Код региона, указывающий регион ресурса, который требуется назначить. Находится в портале Azure на вкладке Keys and Endpoint ресурса в поле Location/Region.	`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"
}

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

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

Foundry
REST API;

Если проект больше не нужен, его можно удалить из Foundry.

Перейдите на домашнюю страницу Foundry . Начните процесс аутентификации, выполнив вход, если вы еще не завершили этот шаг и ваш сеанс не активен.
Выберите проект, который нужно удалить из раздела Keep building with Foundry
Выберите центр управления.
Выберите "Удалить проект".

Чтобы удалить концентратор вместе со всеми его проектами:

Перейдите на вкладку «Обзор» в секции «Хаб».
Справа нажмите кнопку "Удалить узел".
Ссылка открывает портал Azure для удаления концентратора.

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

Отправьте запрос 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/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/ContosoResourceGroup/providers/Microsoft.CognitiveServices/accounts/ContosoResource`

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

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

Запросить 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 в ответ на ваш запрос на отмену назначения ресурса развертывания.	`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"
}

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-11-18

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

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

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

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

Поменять местами развертывания

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

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

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

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

Обратная связь

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