Configuración del Entorno de Desarrollo para Azure AI Foundry

July 2, 2026 · View on GitHub

Esta guía configura los modelos de Azure AI Foundry para las aplicaciones de IA en Java de este curso, usando autenticación sin claves (Microsoft Entra ID) — no hay claves de API que gestionar. ¿Nuevo en estas herramientas? Comienza con la guía del entorno de desarrollo.

Esta guía configura los modelos de Azure AI Foundry para las aplicaciones de IA en Java de este curso. Tienes dos opciones:

  • Opción A — Provisionar con azd + Bicep (recomendado): un comando despliega la cuenta de Foundry y los modelos como código. Sin hacer clic en el portal.
  • Opción B — Crear los recursos manualmente en el portal de Azure AI Foundry.

Ambas opciones usan autenticación sin claves (Microsoft Entra ID) — no hay claves de API que copiar o exponer.

Tabla de Contenidos

Qué se crea

Las plantillas Bicep en infra/ crean:

  • Una cuenta de Azure AI Foundry (Microsoft.CognitiveServices/accounts, tipo AIServices) con un proyecto
  • Un despliegue de chat — gpt-4o-mini
  • Un despliegue de embedding — text-embedding-3-small (usada en capítulos posteriores)
  • Una asignación de rol sin clave (Cognitive Services OpenAI User) para que inicies sesión con az login en lugar de administrar claves

Requisitos Previos

Opción A: Provisionar con azd + Bicep (Recomendado)

Desde la carpeta 02-SetupDevEnvironment:

cd 02-SetupDevEnvironment

# Iniciar sesión (ambas herramientas)
azd auth login
az login

# Proporcionar la cuenta Foundry + despliegues de modelos
azd up

azd solicitará un nombre de entorno (por ejemplo genai-java) y una región. Elige una región donde estén disponibles gpt-4o-mini y text-embedding-3-small — por ejemplo, eastus2 o swedencentral.

Cuando finalice la provisión, azd:

  1. Despliega todo lo definido en infra/main.bicep.
  2. Ejecuta un hook postprovisionamiento que escribe examples/basic-chat-azure/.env con tu endpoint y nombres de despliegue (sin secretos).

Consejo: Ejecuta azd up nuevamente en cualquier momento para aplicar cambios. Ejecuta azd down para eliminar todo y dejar de generar costos.

Para ver los ajustes generados:

azd env get-values

Ahora ve a Prueba Tu Configuración.

Opción B: Crear Recursos Manualmente

¿Prefieres el portal? Crea los recursos manualmente:

  1. Ve al portal de Azure AI Foundry e inicia sesión.
  2. Crea un proyecto (esto también crea un recurso de AI Foundry). Ponle un nombre como GenAIJava.
  3. En tu proyecto, abre Modelos + endpoints → Desplegar modelo → Desplegar modelo base.
  4. Despliega gpt-4o-mini (nombre de despliegue gpt-4o-mini). Repite para text-embedding-3-small si deseas los ejemplos de embedding.
  5. Desde Resumen, copia el endpoint (por ejemplo https://<recurso>.openai.azure.com/).
  6. Concede acceso sin clave: en el recurso, abre Control de acceso (IAM) → Agregar asignación de rol → asigna Cognitive Services OpenAI User a tu cuenta.

¿Todavía tienes problemas? Consulta la documentación de Azure AI Foundry.

Configura Tu Entorno

Si usaste la Opción A (azd up), tu archivo de configuración ya está creado — no necesitas hacer nada más. Salta a Prueba Tu Configuración.

Si usaste la Opción B (manual), crea tú mismo el archivo .env del ejemplo:

cd 02-SetupDevEnvironment/examples/basic-chat-azure
cp .env.example .env

Edita .env con tu endpoint (sin clave — la autenticación es sin clave):

AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT=gpt-4o-mini

Nota de seguridad: No hay clave API que almacenar. Autenticas con Microsoft Entra ID mediante az login (localmente) o una identidad administrada (en Azure). El archivo .env contiene solo configuraciones no secretas y ya está cubierto por .gitignore.

Prueba Tu Configuración

Asegúrate de haber iniciado sesión para que la autenticación sin clave obtenga un token, luego ejecuta el ejemplo:

cd 02-SetupDevEnvironment/examples/basic-chat-azure

az login          # si aún no has iniciado sesión
mvn clean spring-boot:run

¡Deberías ver una respuesta del modelo gpt-4o-mini!

Usuarios de VS Code: Presiona F5 para ejecutar. La aplicación carga tu .env automáticamente.

Ejemplo completo: Consulta el Ejemplo Básico de Chat con Azure AI Foundry para detalles y solución de problemas.

¿Qué Sigue?

¡Configuración completa! Ahora tienes:

  • Azure AI Foundry con gpt-4o-mini y text-embedding-3-small desplegados
  • Autenticación sin claves (Microsoft Entra ID) — sin claves que gestionar
  • Un archivo .env local con tu endpoint y nombres de despliegue
  • Un entorno de desarrollo en Java listo para usar

Continúa a Capítulo 3: Técnicas Básicas de IA Generativa para comenzar a construir aplicaciones de IA.

Recursos

Recursos Adicionales

Descargo de responsabilidad: Este documento ha sido traducido utilizando el servicio de traducción automática Co-op Translator. Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automatizadas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional humana. No somos responsables de cualquier malentendido o interpretación errónea que surja del uso de esta traducción.