Una vez que esté satisfecho con el rendimiento del modelo, está listo para implementarse y consultar las predicciones de las expresiones. 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 del modelo y haya decidido que es adecuado para usarse 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 el asistente Agregar implementación.
Seleccione Crear un nuevo nombre de implementación para crear una nueva implementación y asignar un modelo entrenado de la lista desplegable siguiente. De lo contrario, puede seleccionar Sobrescribir un nombre de implementación existente para reemplazar eficazmente el modelo usado por una implementación existente.
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 un modelo entrenado de la lista desplegable Modelo.
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
Cree una solicitud PUT con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para empezar a implementar un modelo de reconocimiento del lenguaje conversacional.
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
{
"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 se ha realizado correctamente. En los encabezados de respuesta, extraiga el valor operation-location. Tendrá el formato siguiente:
Puede usar esta dirección URL para obtener el estado del trabajo de implementación.
Obtención del estado del trabajo de implementación
Cuando se envía una solicitud de implementación correcta, la dirección URL de solicitud completa para comprobar el estado del trabajo (incluido el punto de conexión, el nombre del proyecto y el id. de trabajo) se encuentra en el encabezado de respuesta operation-location.
Use la siguiente solicitud GET para consultar el estado del trabajo de implementación. Reemplace los valores de los marcadores de posición por sus propios valores.
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".
Una vez que haya terminado de probar un modelo asignado a una implementación, es posible que quiera asignarlo a otra implementación. El intercambio de implementaciones implica:
Tomar el modelo asignado a la primera implementación y asignarlo a la segunda.
Tomar el modelo asignado a la segunda implementación y asignarlo a la primera.
Esto se podría usar para intercambiar las implementaciones production y staging cuando quiera tomar el modelo asignado a staging y asignarlo a production.
En la página Implementar modelo, seleccione las dos implementaciones que desea intercambiar y seleccione 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 Implementar modelo. A continuación, seleccione la implementación que desea eliminar y seleccione Eliminar implementación en el menú superior.
Cree una solicitud DELETE con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para eliminar una implementación de reconocimiento del lenguaje conversacional.
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.
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.
Para la asignación de recursos de implementación mediante programación, se necesita 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 usar la autenticación de Microsoft Entra mediante programación al realizar llamadas API de REST, consulte la Documentación sobre autenticación de los 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 Keys and Endpoint (Claves y puntos de conexión) del recurso, y es parte del 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 Keys and Endpoint (Claves y puntos de conexión) del recurso, y es parte del 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 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".