Inicio rápido: Creación de un recurso de Cognitive Services con Azure Portal

  • Artículo
  • 16 minutos para leer

Use este inicio rápido para crear un recurso de Cognitive Services. Después de crear un recurso de Cognitive Service en Azure Portal, obtendrá un punto de conexión y una clave para autenticar las aplicaciones.

Azure Cognitive Services es un servicio de inteligencia artificial (IA) basado en la nube que ayuda a los desarrolladores a crear inteligencia cognitiva en las aplicaciones sin tener aptitudes o conocimientos directos de IA o ciencia de datos. Están disponibles a través de las API de REST y los SDK de la biblioteca cliente en lenguajes de desarrollo populares. Azure Cognitive Services permite a los desarrolladores agregar fácilmente características cognitivas en sus aplicaciones con soluciones cognitivas que pueden ver, oír, hablar y analizar.

Tipos de recursos de Cognitive Services

Puede acceder a Azure Cognitive Services mediante dos recursos distintos: Un recurso de varios servicios o uno de un único servicio.

  • Recurso de varios servicios:
    • Acceda a varias instancias de Azure Cognitive Services con una sola clave y un punto de conexión.
    • Consolida la facturación de los servicios que usa.
  • Recurso de servicio único:
    • Acceda a una única instancia de Azure Cognitive Services con una clave y un punto de conexión únicos para cada servicio creado.
    • Use el nivel gratuito para probar el servicio.

Prerrequisitos

  • Una suscripción a Azure válida: cree una de manera gratuita.
  • La cuenta de Azure debe tener asignado un rol de colaborador de Cognitive Services a fin de que pueda aceptar los términos de IA responsable y crear un recurso. Para asignar este rol a su cuenta, siga los pasos descritos en la documentación Asignación de roles o póngase en contacto con el administrador.

Creación de un nuevo recurso de Azure Cognitive Services

El recurso multiservicio se denomina Cognitive Services en el portal. En este momento, el recurso multiservicio permite el acceso a los siguientes servicios de Cognitive Services:

  • Decisión: Content Moderator
  • Idioma: Language, Translator
  • Voz: Voz
  • Visión: Computer Vision, Custom Vision, Form Recognizer, Face

  1. Puede seleccionar este vínculo para crear un recurso multi-servicio de Azure Cognitive: Crear un recurso Cognitive Services servicio.

  2. En la página Crear, proporcione la siguiente información:

    Detalles del proyecto Descripción
    Suscripción Seleccione una de las suscripciones de Azure disponibles.
    Grupos de recursos El grupo de recursos de Azure que contendrá su recurso de Cognitive Services. Puede crear un nuevo grupo o agregarlo a uno ya existente.
    Región Ubicación de la instancia de Cognitive Services. Las diferentes ubicaciones pueden crear latencias, pero no tienen ningún impacto en la disponibilidad del tiempo de ejecución del recurso.
    Nombre Nombre descriptivo para el recurso de Cognitive Services. Por ejemplo, MyCognitiveServicesResource.
    Plan de tarifa Costo de la cuenta de Cognitive Services, que depende del uso y de las opciones que elija. Para obtener más información, consulte los detalles de los precios.

    Pantalla de creación de un recurso de varios servicios

  3. Configure otras opciones para el recurso según sea necesario, lea y acepte las condiciones (según corresponda) y, a continuación, seleccione Revisar y crear.

Sugerencia

Si la suscripción no permite crear un recurso de Cognitive Services, puede que tenga que habilitar el privilegio de ese proveedor de recursos de Azure con Azure Portal, un comando de PowerShell o un comando de la CLI de Azure . Si no es el propietario de la suscripción, pida al propietario de la suscripción o a alguien con un rol de administrador que complete el registro en su nombre o solicite que se le concedan privilegios de registro y acción a su cuenta.

Obtención de las claves del recurso

  1. Una vez que el recurso se haya implementado correctamente, seleccione Pasos siguientes>Ir al recurso.

    Pantalla Obtener claves de recursos

  2. En el panel de inicio rápido que se abre, puede acceder al punto de conexión y administrar las claves.

Configuración de una variable de entorno para la autenticación

La aplicación debe autenticarse para acceder a los recursos de Cognitive Services. En el caso de producción, use una forma segura de almacenar sus credenciales y acceder a ellas. Por ejemplo, después de obtener una clave para el recurso, escríbela en una nueva variable de entorno en el equipo local que ejecuta la aplicación.

Sugerencia

No incluya la clave directamente en el código ni la exponga nunca públicamente. Consulte el artículo de seguridad de Cognitive Services para ver más opciones de autenticación, como Azure Key Vault.

Para establecer la variable de entorno para la clave de recurso, abra una ventana de consola y siga las instrucciones correspondientes a su sistema operativo y su entorno de desarrollo. Para establecer la variable de entorno COGNITIVE_SERVICE_KEY, reemplace your-key por una de las claves del recurso.

setx COGNITIVE_SERVICE_KEY your-key

Nota:

Si solo necesita acceder a la variable de entorno en la consola que se está ejecutando en este momento, puede establecer la variable de entorno con set en vez de con setx.

Después de agregar la variable de entorno, puede que tenga que reiniciar todas las consolas en ejecución o demás programas en ejecución que necesiten leer la variable de entorno. Por ejemplo, si usa Visual Studio como editor, reinícielo antes de ejecutar el ejemplo.

Para establecer la variable de entorno en la región de recursos de Voz, siga los mismos pasos. Establezca COGNITIVE_SERVICE_REGION en la región del recurso. Por ejemplo, westus.

Limpieza de recursos

Si quiere limpiar y eliminar una suscripción a Cognitive Services, puede eliminar el recurso o grupo de recursos. Al eliminar el grupo de recursos también se eliminan los demás recursos incluidos en el grupo.

  1. En Azure Portal, expanda el menú de la izquierda para abrir el menú de servicios y elija Grupos de recursos para ver una lista con sus grupos de recursos.
  2. Busque el grupo de recursos que contiene el recurso que quiere eliminar.
  3. Si quiere eliminar todo el grupo de recursos, seleccione el nombre del grupo de recursos. En la página siguiente, seleccione Eliminar grupo de recursos y confirme.
  4. Si quiere eliminar solo el recurso de Cognitive Services, seleccione el grupo de recursos para ver todos los recursos que contiene. En la página siguiente, seleccione el recurso que quiere eliminar, seleccione el menú de puntos suspensivos de esa fila y seleccione Eliminar.

Si necesita recuperar un recurso eliminado, consulte el artículo sobre la recuperación de recursos de Cognitive Services eliminados.

Consulte también