Preguntas generales
¿Qué hay disponible?
Los contenedores de Azure Cognitive Services permiten a los desarrolladores usar las mismas API inteligentes que están disponibles en Azure, pero con las ventajas que aportan los contenedores. Algunos contenedores están disponibles como versión preliminar validada, lo que podría exigir una aplicación para acceder. Otros contenedores están disponibles públicamente como versión preliminar no validada o están disponibles con carácter general. Puede encontrar una lista completa de contenedores y su disponibilidad en el artículo Compatibilidad con contenedores en Azure Cognitive Services. También puede ver los contenedores en Docker Hub.
¿Hay alguna diferencia entre la nube de Cognitive Services y los contenedores?
Los contenedores de Cognitive Services son una alternativa a la nube de Cognitive Services. Los contenedores ofrecen las mismas funcionalidades que los servicios en la nube correspondientes. Los clientes pueden implementar los contenedores en un entorno local o en Azure. La tecnología básica de inteligencia artificial, los planes de tarifa, las claves de API y la firma de API son los mismos entre los servicios locales y sus homólogos en la nube. Hay características y ventajas por elegir contenedores en lugar de sus equivalentes de un servicio en la nube.
¿Cómo accedo y uso un contenedor en versión preliminar validada?
Anteriormente, los contenedores de versión preliminar validados se hospedaban en el repositorio de containerpreview.azurecr.io. A partir del 22 de septiembre de 2020, estos contenedores se hospedan en Microsoft Container Registry. Para su descarga no requiere el comando docker login. Podrá ejecutar un contenedor en versión preliminar validada si el recurso de Azure se creó con el identificador de la suscripción de Azure aprobada. No va a poder ejecutar el contenedor si la suscripción de Azure no se ha aprobado después de completar el formulario de solicitud.
¿Los contenedores van a estar disponibles para todas las ofertas de Cognitive Services, y cuál es el siguiente conjunto de contenedores que podría estar disponible?
Nos gustaría ofrecer más ofertas de Cognitive Services como contenedores. Póngase en contacto con el administrador de la cuenta de Microsoft local para obtener actualizaciones sobre nuevas versiones de contenedores y otros anuncios de Cognitive Services.
¿Cuál va a ser el Acuerdo de Nivel de Servicio (SLA) de los contenedores de Cognitive Services?
Los contenedores de Cognitive Services no tienen SLA.
Los clientes controlan las configuraciones de recursos de los contenedores de Cognitive Services, por lo que Microsoft no va a ofrecer ningún SLA de disponibilidad general (GA). Los clientes pueden implementar contenedores en el entorno local y definir los entornos de host.
Importante
Para obtener más información sobre los Acuerdos de Nivel de Servicio de Cognitive Services, visite la página de SLA.
¿Estos contenedores están disponibles en nubes soberanas?
No todo el mundo está familiarizado con el término nube soberana, así que vamos a definirlo:
La nube soberana consta de las nubes Azure Government, Azure Alemania y Azure China 21Vianet.
Desafortunadamente, los contenedores de Cognitive Services no se admiten de forma nativa en las nubes soberanas. Los contenedores se pueden ejecutar en estas nubes, pero se extraen de la nube pública y tienen que enviar datos de uso al punto de conexión público.
Control de versiones
¿Cómo se actualizan los contenedores a la versión más reciente?
Los clientes pueden elegir cuándo actualizar los contenedores que han implementado. Los contenedores se marcarán con las etiquetas de Docker estándar, como latest para indicar la versión más reciente. Se recomienda a los clientes extraer las versiones más recientes de los contenedores cuando se publican. Para obtener detalles sobre cómo recibir notificaciones cuando se actualiza una imagen, vea Webhooks de Azure Container Registry.
¿Qué versiones se admitirán?
Se admitirá la versión actual y la versión principal más reciente del contenedor. Sin embargo, animamos a los clientes a mantenerse al día para conseguir la tecnología más moderna.
¿Cómo se controlan las actualizaciones de versiones?
Los cambios de versión principal indican que hay un cambio importante en la firma de la API. Se prevé que esto normalmente coincida con cambios de versión principal en la oferta de nube de Cognitive Services correspondiente. Los cambios de versión secundaria indican correcciones de errores, actualizaciones de modelos o nuevas características que no suponen un cambio importante en la firma de la API.
Preguntas técnicas
¿Cómo puedo diagnosticar posibles errores en mi entorno de implementación?
Si tiene problemas al ejecutar un contenedor de Cognitive Services, puede intentar usar el contenedor de diagnósticos de Microsoft. Use este contenedor para diagnosticar errores comunes en el entorno de implementación que podrían impedir que los contenedores de Cognitive Services funcionen según lo previsto.
Para obtener el contenedor, use el comando de Docker pull siguiente:
docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic
Luego ejecute el contenedor, reemplace {ENDPOINT_URI} por el punto de conexión y {API_KEY} por la clave del recurso:
docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
El contenedor prueba la conectividad de red con el punto de conexión de facturación.
¿Cómo debo ejecutar los contenedores de Cognitive Services en dispositivos IoT?
Si no tiene una conexión de Internet confiable, quiere ahorrar en costos de ancho de banda, tiene requisitos de baja latencia o está tratando con datos confidenciales que deben analizarse en el sitio, Azure IoT Edge con contenedores de Cognitive Services le proporciona coherencia con la nube.
¿Son compatibles estos contenedores con OpenShift?
Los contenedores no se prueban con OpenShift, pero normalmente los contenedores de Cognitive Services deberían ejecutarse en cualquier plataforma que admita imágenes de Docker. Si usa OpenShift, se recomienda ejecutar los contenedores como root-user.
¿Cómo proporcionar comentarios sobre el producto y recomendaciones de características?
Se anima a los clientes a que expongan sus preocupaciones públicamente y a que voten a otros usuarios que hayan hecho lo mismo siempre que los posibles problemas se solapen. La herramienta de comentarios se puede usar tanto para los comentarios de los productos como para las recomendaciones de características.
¿Qué errores y mensajes de estado devuelven los contenedores de Cognitive Services?
Estos son los errores y mensajes de estado:
| Estado | Descripción |
|---|---|
Valid |
La clave de API es válida. No se requiere ninguna acción. |
Invalid |
La clave de API no es válida. Debe proporcionar una clave de API válida para ejecutar el contenedor. Busque la clave de API y la región del servicio en Azure Portal, en la sección Claves y punto de conexión del recurso de Cognitive Services. |
Mismatch |
Ha proporcionado una clave de API o un punto de conexión de otro tipo de recurso de Cognitive Services. Busque la clave de API y la región del servicio en Azure Portal, en la sección Claves y punto de conexión del recurso de Cognitive Services. |
CouldNotConnect |
El contenedor no se pudo conectar al punto de conexión de facturación. Revise el valor Retry-After y espere a que este período finalice para realizar más solicitudes. |
OutOfQuota |
La clave de API ha superado la cuota. Puede actualizar el plan de tarifa o esperar a que haya cuota adicional disponible. Busque el plan en Azure Portal, en la sección Plan de tarifa del recurso de Cognitive Services. |
BillingEndpointBusy |
Actualmente, el punto de conexión de facturación está ocupado. Revise el valor Retry-After y espere a que este período finalice para realizar más solicitudes. |
ContainerUseUnauthorized |
La clave de API proporcionada no está autorizada para su uso con este contenedor. Lo más probable es que esté usando un contenedor validado, así que asegúrese de que el identificador de la suscripción de Azure se ha aprobado; para ello envíe una solicitud en línea. |
Unknown |
Actualmente, el servidor no puede procesar las solicitudes de facturación. |
¿Cómo obtengo soporte técnico?
Los canales de soporte técnico al cliente son los mismos que en las API basadas en la nube de Cognitive Services. Todos los contenedores de Cognitive Services incluyen características de registro que nos ayudarán a nosotros y a la comunidad a proporcionar soporte técnico a los clientes. Estas son las opciones para obtener más soporte técnico:
- Busque información de contacto en el plan de soporte técnico de Azure.
- Pruebe estas áreas de Stack Overflow, un sitio de preguntas y respuestas para programadores profesionales y aficionados:
¿Cómo funciona la facturación?
Se cobra a los clientes en función del consumo, igual que en la nube de Cognitive Services. Los contenedores deben configurarse para enviar datos de medición a Azure y las transacciones se facturarán según corresponda. Los recursos usados en los servicios hospedados y locales se agregan a la cuota única con los precios del plan, teniendo en cuenta ambos usos. Para obtener más información, vea las siguientes páginas de precios:
- Anomaly Detector
- Computer Vision
- Face
- Form Recognizer
- Language Understanding (LUIS)
- Speech Service API
- Servicio de lenguaje: Análisis de sentimiento
- Servicio de lenguaje: Text Analytics for Health
- Servicio de lenguaje: Detección de idioma
- Servicio de lenguaje: Extracción de frases clave
Importante
Los contenedores de Cognitive Services no tienen licencia para ejecutarse sin estar conectados a Azure para realizar mediciones. Los clientes tienen que habilitar los contenedores para comunicar la información de facturación con el servicio de medición en todo momento. Los contenedores de Cognitive Services no envían los datos del cliente a Microsoft.
Este es un ejemplo de la información que un contenedor comunica para la medición:
"usageRequestBody": {
"id": "customer_subscriptionID",
"apiType": "textanalytics",
"containerType": "keyphrase",
"containerVersion": "1.1.00864.0001",
"containerId": "dep--keyphrase-",
"meter": {
"name": "CognitiveServices.TextAnalytics.Container.BatchScoring",
"quantity": 10.0
}
¿Cuál es la garantía de soporte técnico actual para los contenedores?
No hay ninguna garantía para las versiones preliminares. La garantía estándar de Microsoft para el software empresarial se aplica cuando los contenedores se anuncian formalmente como de disponibilidad general (GA).
¿Qué ocurre con los contenedores de Cognitive Services cuando se pierde la conectividad a Internet?
Los contenedores de Cognitive Services no tienen licencia para ejecutarse sin estar conectados a Azure para realizar mediciones. Los clientes tienen que habilitar los contenedores para comunicarse con el servicio de medición en todo momento.
¿Cuánto tiempo puede funcionar el contenedor sin estar conectado a Azure?
Los contenedores de Cognitive Services no tienen licencia para ejecutarse sin estar conectados a Azure para realizar mediciones. Los clientes tienen que habilitar los contenedores para comunicarse con el servicio de medición en todo momento.
¿Cuál es el hardware necesario para ejecutar estos contenedores?
Los contenedores de Cognitive Services son contenedores basados en x64 que pueden ejecutar cualquier nodo, máquina virtual y dispositivo perimetral compatible con Linux que admita contenedores de Docker de Linux x64. Todos ellos requieren procesadores de CPU. En estas páginas puede ver la configuración mínima y la recomendada de cada oferta de contenedor:
¿Se admiten actualmente estos contenedores en Windows?
Los contenedores de Cognitive Services son contenedores de Linux, aunque hay cierta compatibilidad con contenedores de Linux en Windows. Para obtener más información sobre contenedores de Linux en Windows, vea la documentación de Docker.
¿Cuál es la diferencia entre los contenedores de Cognitive Services y las ofertas de AWS y Google?
Microsoft es el primer proveedor de nube que traslada sus modelos de inteligencia artificial con entrenamiento previo a contenedores con una facturación sencilla por transacción, como si los clientes estuvieran usando un servicio en la nube. Microsoft considera que una nube híbrida ofrece más opciones a los clientes.
¿Qué certificaciones de cumplimiento tienen los contenedores?
Los contenedores de Cognitive Services no tienen certificaciones de cumplimiento.
¿En qué regiones están disponibles los contenedores de Cognitive Services?
Los contenedores se pueden ejecutar en cualquier ubicación de cualquier región, aunque necesitan una clave y deben llamar de nuevo a Azure para las mediciones. Todas las regiones admitidas del servicio en la nube son compatibles con las llamadas de medición de los contenedores.
Pasos siguientes
Vamos a seguir trabajando con los contenedores de Azure Cognitive Services.