Reto 00 - Prerrequisitos - En sus marcas, listos… ¡fuera!

Home - Siguiente reto »

Introducción

Gracias por participar en el What The Hack Fundamentos de Azure OpenAI. Antes de que puedas comenzar a hackear, necesitarás configurar algunos prerrequisitos.

Descripción

En este desafío, configurarás los prerrequisitos necesarios y el entorno para completar el resto del hack, incluyendo:

Acceso a Azure OpenAI

Necesitarás una suscripción a Azure para completar este truco. Si no tienes una, obtén una prueba gratuita aquí…

Es necesaria una suscripción a Azure para poder crear un recurso de Azure OpenAI y acceder a sus modelos.

GitHub Codespaces

Para facilitar el desarrollo y evitar complicaciones con dependencias, utilizaremos GitHub Codespaces. Este es un entorno de desarrollo alojado en la nube, accesible desde tu navegador, que simplifica considerablemente la configuración inicial.

Debes tener una cuenta de GitHub para poder utilizar GitHub Codespaces. Si no tienes una cuenta de GitHub, puedes Registrarte Aquí.

Cada cuenta personal de GitHub incluye un plan gratuito que ofrece 120 horas núcleo (60 horas de tiempo real de ejecución en un Codespace de 2 núcleos) así como 15 GB de almacenamiento al mes para operar Codespaces, lo que te permite trabajar sin preocuparte por la configuración local de tu equipo. Puedes revisar el saldo de tus horas disponibles en la página de facturación de GitHub.

El GitHub Codespace para este hack albergará los archivos de Jupyter Notebook, los archivos de configuración y otros archivos de datos necesarios para este desafío.

Comencemos

Para iniciar con el hack, sigue estos pasos:

  1. Inicia sesión con tu cuenta personal de GitHub. Por favor NO uses una cuenta gestionada por tu empresa.

  2. Accede al repositorio de Codespace de WTH Fundamentos de Azure OpenAI que usaremos para el hack.

  3. Verás que el repositorio es una plantilla (template). Utiliza esta plantilla para crear un repositorio público en tu cuenta personal. NO Hagas fork del proyecto, crea una copia del repositorio a partir de la plantilla. Puedes colocar el nombre que desees (por ejemplo, wth-aoai) al repositorio y en acceso utiliza Public.

  4. Dentro de tu nuevo repositorio, crea un Codespace seleccionando la opción “Code”, luego “Codespaces” y luego “Crear codespace en main”.

Tu entorno de Codespace debería cargarse en una nueva pestaña del navegador. La primera vez que creas el Codespace, tardará aproximadamente entre 3 y 5 minutos en cargarse. Este entorno ya tiene preinstaladas todas las herramientas necesarias, permitiéndote concentrarte completamente en el desarrollo.

Cuando el Codespace termine de cargarse, deberías encontrar una instancia de Visual Studio Code ejecutándose en tu navegador con los archivos necesarios para este hackathon.

Solución de problemas

Si al iniciar el Codespace se queda la ventana con el mensaje Setting up your codespace por más de un minuto, sigue este proceso:

  1. Cierra la pestaña del Codespace.
  2. Instala Visual Studio Code en tu computadora desde aquí en caso de que no lo tengas instalado.
  3. En tu repositorio de GitHub creado a partir de la plantilla, da clic en Code, luego en Codespaces y en los puntos suspensivos elige la opción “Open in Visual Studio Code”.
  4. Si te aparece una ventana emergente “¿Abrir en Visual Studio Code?” da clic en el botón Abrir Visual Studio Code. Se debería abrur esta aplicación en tu equipo automáticamente. En caso de que no, abre manualmente Visual Studio Code y reintenta desde el paso 3.
  5. Si te aparece la ventana emergente “Would you like to install GitHub Codespaces extension from GitHub” da clic en el botón “Install Extension and Open URI”. Espera unos minutos a que se instale la extensión.
  6. Si te aparece otra ventana emergente de Visual Studio Code donde la extensión de GitHub Codespaces desea iniciar sesión en GitHub, da clic en “Allow”. Serás dirigido al navegador.
  7. Da clic en el botón verde “Authorize Visual Studio Code”.
  8. Si te vuelve a aparecer la ventana emergente “¿Abrir en Visual Studio Code?” da clic en el botón Abrir Visual Studio Code.
  9. Ahora sí, tu Codespace debería ser abierto en tu instancia local de Visual Studio Code donde estarás trabajando. Espera a que aparezcan los archivos de tu repositorio y estás listo para proseguir con la configuración de Azure OpenAI.

Configuración de Azure OpenAI

Crea un recurso de Azure OpenAI en tu suscripción de Azure y realiza algunas configuraciones iniciales.

¡Ahora estás listo para configurar y ejecutar los archivos de Jupyter Notebook, muy bien!

Configuración del Archivo env. para Jupyter Notebooks

El código de los Jupyter Notebooks obtiene sus valores de configuración de variables de entorno configuradas en un archivo .env. Algunos de estos valores de configuración son secretos (por ejemplo, la clave para acceder a tu recurso de Azure OpenAI).

NOTA: Un archivo .env nunca debe almacenarse en un repositorio de Git. Por lo tanto, hemos proporcionado un archivo de muestra llamado .env.sample que contiene una lista de las variables de entorno requeridas por los Jupyter Notebooks.

Encontrarás el archivo .env.sample en la raíz del codespace.

NOTA: Recursos adicionales de Azure como Azure Document Intelligence (también conocido como Azure Form Recognizer) y Azure AI Search (también conocido como Azure Cognitive Search) serán necesarios para desafíos posteriores. Puedes añadir estos valores al archivo .env más adelante a medida que avances en los desafíos.

NOTA: También hemos proporcionado un archivo .gitignore que debería evitar que accidentalmente hagas un commit de tu archivo .env renombrado a un repositorio de Git durante este desafío.

Instalación de bibliotecas de Python en el Codespace

En tu GitHub Codespace, abre una Terminal y ejecuta el siguiente comando python3 -m pip install -r requirements.txt a fin de comenzar el proceso de instalación de varias bibliotecas de Python que serán utilizadas en los desafíos (por ejemplo, openai, scikit-learn, pandas, langchain, etc).

Este proceso demorará unos minutos.

Criterios de Éxito

Para completar este desafío con éxito, deberías poder:

Recursos de Aprendizaje

Siguientes pasos

Ahora puedes proseguir con el Siguiente reto »