Implementación de un modelo y clasificación de texto mediante la API en tiempo de ejecución
Artículo
Una vez que esté satisfecho con el rendimiento del modelo, estará listo para implementarse y se usará para clasificar texto. La implementación de un modelo hace que esté disponible para su uso a través de la API de predicción.
Una vez que haya revisado el rendimiento de su modelo y decidido que se puede usar en su entorno, debe asignarlo a una implementación para poder consultarlo. La asignación del modelo a una implementación hace que esté disponible para su uso mediante la API de predicción. Se recomienda crear una implementación denominada production a la que asigne el mejor modelo que ha creado hasta ahora y usarlo en el sistema. Puede crear otra implementación denominada staging a la que puede asignar el modelo en el que está trabajando actualmente para poder probarlo. Puede tener un máximo en 10 implementaciones en el proyecto.
Seleccione Implementación de un modelo en el menú de la izquierda.
Seleccione Agregar implementación para iniciar un nuevo trabajo de implementación.
Seleccione Crear nueva implementación para crear una nueva implementación y asignar un modelo entrenado de la lista desplegable siguiente. También puede sobrescribir una implementación existente; para ello, seleccione esta opción y el modelo entrenado que quiere asignar en la lista desplegable siguiente.
Nota:
La sobrescritura de una implementación existente no requiere cambios en la llamada de la API de predicción, pero los resultados que obtendrá se basarán en el modelo recién asignado.
seleccione Implementar para iniciar el trabajo de implementación.
Después de que la implementación se realice correctamente, aparecerá una fecha de expiración junto a ella. La expiración de la implementación aparece cuando el modelo implementado deja de estar disponible para usarlo en la predicción, lo que suele ocurrir doce meses después de que expire una configuración de entrenamiento.
Enviar el trabajo de implementación
Envíe una solicitud PUT mediante la dirección URL, los encabezados y el cuerpo JSON para enviar un trabajo de implementación. Reemplace los valores de los marcadores de posición por sus propios valores.
Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.
myProject
{DEPLOYMENT-NAME}
Nombre de la implementación. Este valor distingue mayúsculas de minúsculas.
staging
{API-VERSION}
Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Obtenga más información sobre otras versiones de API disponibles
2022-05-01
encabezados
Use el siguiente encabezado para autenticar la solicitud.
Clave
Valor
Ocp-Apim-Subscription-Key
Clave para el recurso. Se usa para autenticar las solicitudes de API.
Cuerpo de la solicitud
Use el siguiente código JSON en el cuerpo de la solicitud. Use el nombre del modelo que se va a asignar a la implementación.
{
"trainedModelLabel": "{MODEL-NAME}"
}
Clave
Marcador de posición
Valor
Ejemplo
trainedModelLabel
{MODEL-NAME}
Nombre del modelo que se asignará a la implementación. Solo puede asignar modelos entrenados correctamente. Este valor distingue mayúsculas de minúsculas.
myModel
Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que el trabajo se ha enviado correctamente. En los encabezados de respuesta, extraiga el valor operation-location. Tendrá el formato siguiente:
{JOB-ID} se usa para identificar la solicitud, ya que esta operación es asincrónica. Puede usar esta dirección URL para obtener el estado de la implementación.
Obtención del estado del trabajo de implementación
Use la siguiente solicitud GET para consultar el estado del trabajo de implementación. Puede usar la dirección URL que recibió en el paso anterior o reemplazar los valores de los marcadores de posición siguientes por sus propios valores.
Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.
myProject
{DEPLOYMENT-NAME}
Nombre de la implementación. Este valor distingue mayúsculas de minúsculas.
staging
{JOB-ID}
Id. para buscar el estado del entrenamiento del modelo. Se encuentra en el valor de encabezado location que recibió en el paso anterior.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Obtenga más información sobre otras versiones de API disponibles
2022-05-01
encabezados
Use el siguiente encabezado para autenticar la solicitud.
Clave
Valor
Ocp-Apim-Subscription-Key
Clave para el recurso. Se usa para autenticar las solicitudes de API.
Cuerpo de la respuesta
Una vez que envíe la solicitud, recibirá la siguiente respuesta. Siga sondeando este punto de conexión hasta que el parámetro status cambie a "succeeded". Debe obtener un código 200 para indicar el éxito de la solicitud.
Puede intercambiar implementaciones después de probar un modelo asignado a una implementación y desea asignarla a otra. El intercambio de implementaciones implica tomar el modelo asignado a la primera implementación y asignarlo a la segunda. A continuación, tome el modelo asignado a la segunda implementación y asígnelo a la primera. Esto se podría usar para intercambiar production las implementaciones y staging cuando quiera tomar el modelo asignado a staging y asignarlo a production.
En la página Implementación de un modelo, seleccione las dos implementaciones que quiere intercambiar y haga clic en Intercambiar implementaciones en el menú superior.
En la ventana que aparece, seleccione los nombres de las implementaciones que desea intercambiar.
Cree una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para iniciar el trabajo de cambio de implementaciones.
Para eliminar una implementación desde Language Studio, vaya a la página Implementación de un modelo. Seleccione la implementación que desea eliminar y seleccione Eliminar implementación en el menú superior.
Cree una solicitud DELETE usando la dirección URL, los encabezados y el cuerpo JSON siguientes para eliminar una implementación.
Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.
myProject
{DEPLOYMENT-NAME}
Nombre de su implementación. Este valor distingue mayúsculas de minúsculas.
prod
{API-VERSION}
Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Obtenga más información sobre otras versiones de API disponibles
2022-05-01
encabezados
Use el siguiente encabezado para autenticar la solicitud.
Clave
Valor
Ocp-Apim-Subscription-Key
Clave para el recurso. Se usa para autenticar las solicitudes de API.
Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que se ha realizado correctamente, lo que significa que la implementación se ha eliminado. Una llamada correcta devuelve un encabezado Operation-Location que se usa para comprobar el estado del trabajo.
Vaya a la página Deploying a model (Implementación de un modelo) en Language Studio.
Seleccione la pestaña Regiones.
Seleccione Agregar recurso de implementación.
Seleccione un recurso de lenguaje en otra región.
Ya está a punto para implementar el proyecto en las regiones en las que ha asignado recursos.
La asignación de recursos de implementación mediante programación requiere la autenticación de Microsoft Entra. Microsoft Entra ID se usa a fin de confirmar que tiene acceso a los recursos que le interesa asignar al proyecto para la implementación en varias regiones. Para programar el uso de la autenticación de Microsoft Entra al realizar llamadas a la API de REST, obtenga más información en la documentación de servicios de Azure AI.
Asignación de recursos
Envíe una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON siguientes para asignar recursos de implementación.
URL de la solicitud
Use la siguiente dirección URL al crear la solicitud de API. Reemplace los valores de los marcadores de posición por sus propios valores.
La ruta de acceso de id. de recurso completa que quiere asignar. Se encuentra en Azure Portal, en la pestaña Propiedades del recurso, en el campo Id. de recurso.
Subdominio personalizado del recurso que quiere asignar. Se encuentra en Azure Portal, en la pestaña Claves y puntos de conexión del recurso, como el campo Punto de conexión en la dirección URL https://<your-custom-subdomain>.cognitiveservices.azure.com/.
contosoresource
region
{REGION-CODE}
Código de región que especifica la región del recurso que quiere asignar. Se encuentra en Azure Portal, en la pestaña Claves y puntos de conexión del recurso, en el campo Location/Region (Ubicación o región).
eastus
Obtención del estado del recurso de asignación
Use la solicitud GET siguiente para obtener el estado del trabajo de asignación del recurso de implementación. Reemplace los valores de los marcadores de posición por sus propios valores.
Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.
myProject
{JOB-ID}
El identificador del trabajo para obtener el estado de asignación de la implementación. Se encuentra en el valor de encabezado operation-location que recibió de la API como respuesta a la solicitud de asignación del recurso de implementación.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versión de la API a la que se llama.
2022-10-01-preview
encabezados
Use el siguiente encabezado para autenticar la solicitud.
Clave
Valor
Ocp-Apim-Subscription-Key
Clave para el recurso. Se usa para autenticar las solicitudes de API.
Cuerpo de la respuesta
Una vez que envíe la solicitud, recibirá la siguiente respuesta. Siga sondeando este punto de conexión hasta que el parámetro status cambie a succeeded.
Anulación de la asignación de recursos de implementación
Al anular la asignación de un recurso de implementación de un proyecto, o al quitarlo, también eliminará todas las implementaciones que se hayan implementado en la región de ese recurso.
Para anular la asignación de recursos de implementación o quitarlos en otras regiones mediante Language Studio, haga lo siguiente:
Vaya a la pestaña Regiones de la página Implementar un modelo.
Seleccione el recurso cuya asignación quiere anular.
Seleccione el botón Quitar asignación.
En la ventana que aparece, escriba el nombre del recurso que quiere quitar.
Anulación de la asignación de un recurso
Envíe una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON siguientes para anular la asignación de recursos de implementación del proyecto o quitarlos.
URL de la solicitud
Use la siguiente dirección URL al crear la solicitud de API. Reemplace los valores de los marcadores de posición por sus propios valores.
La ruta de acceso completa del id. de recurso cuya asignación quiere anular. Se encuentra en Azure Portal, en la pestaña Propiedades del recurso, como el campo Id. de recurso.
Obtención del estado de la anulación de la asignación del recurso
Use la solicitud GET siguiente para obtener el estado del trabajo de anulación de la asignación de recursos de implementación. Reemplace los valores de los marcadores de posición por sus propios valores.
Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.
myProject
{JOB-ID}
El identificador del trabajo para obtener el estado de asignación de la implementación. Se encuentra en el valor de encabezado operation-location que recibió de la API como respuesta a la solicitud de anulación de la asignación del recurso de implementación.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}
Versión de la API a la que se llama.
2022-10-01-preview
encabezados
Use el siguiente encabezado para autenticar la solicitud.
Clave
Valor
Ocp-Apim-Subscription-Key
Clave para el recurso. Se usa para autenticar las solicitudes de API.
Cuerpo de la respuesta
Una vez que envíe la solicitud, recibirá la siguiente respuesta. Siga sondeando este punto de conexión hasta que el parámetro status cambie a "succeeded".