En esta nota
Dónde: Configuración → Contenido y publicación → Tus cuentas de IA
Abre esta página: admin.<your-site>/settings/ai/providers (reemplaza <your-site> con la dirección de tu sitio)
Antes de empezar
- Una cuenta de Azure con un recurso de Azure OpenAI activo.
- Al menos un modelo desplegado en ese recurso. Azure solo ejecuta un modelo una vez que lo has desplegado.
- Permisos para ver y leer las claves del recurso en Azure.
- Solo los miembros con permisos para gestionar la IA pueden conectarlo, y debes haber iniciado sesión recientemente.
Paso a paso
- Entra al portal de Azure y abre tu recurso de Azure OpenAI.
- Ve a Administración de recursos y luego a Claves y punto de conexión.
- Copia el Punto de conexión (endpoint). Se ve como
https://my-resource.openai.azure.com. Debe terminar en.openai.azure.como.cognitiveservices.azure.com. - Copia la CLAVE 1. Guarda la CLAVE 2 como respaldo. El panel de administración acepta una clave de 32 caracteres (letras de la a–f y dígitos) o de 84 caracteres.
- Busca los nombres de tus despliegues. En el portal de Azure AI Foundry, abre los Despliegues de tu recurso. El nombre de despliegue es el que elegiste al desplegar el modelo. Puede ser distinto al nombre del modelo en sí, por ejemplo
gpt-4o-mini. - En el panel de administración de tu sitio, abre Configuración → Contenido y publicación → Tus cuentas de IA y busca la tarjeta de Azure OpenAI.
- Pega el Endpoint de Azure. Agrega cada despliegue en Nombres de las implementaciones y presiona Agregar después de escribir cada uno. Debes añadir al menos uno.
- Pega la clave y presiona Probar y conectar. Verás el mensaje "Comprobando tu clave…" y luego Conectado ✓.
Datos útiles
- Puedes conectar hasta dos recursos de Azure.
- Azure no ofrece una lista automática de modelos para una clave; por eso, el panel solo mostrará los despliegues que ingreses manualmente. Si despliegas más modelos más adelante, puedes añadirlos en cualquier momento.
- Los precios son opcionales. Al incluirlos, el panel te permite ver los costos. Sin ellos, la IA no cambiará a esta cuenta de forma automática si otra cuenta falla.
- Azure te factura directamente. Consulta tus costos y presupuestos en el portal de Azure. Límites y presupuesto de IA
- La clave se guarda de forma segura en tu propio servidor. Keynate nunca tiene acceso a ella.
Problemas frecuentes
Usa tu endpoint de Azure OpenAI
El endpoint debe terminar en .openai.azure.com o .cognitiveservices.azure.com. Cópialo directamente desde Claves y punto de conexión. Un dominio personalizado o una dirección IP no funcionarán.
Este modelo o despliegue no está disponible en tu cuenta de Azure OpenAI
El nombre del despliegue no coincide. Debe ser exactamente igual, incluidas las mayúsculas y minúsculas. Revisa los Despliegues en Foundry, corrige el nombre en la tarjeta e inténtalo de nuevo.
Azure OpenAI rechazó esta clave
Vuelve a copiar la clave completa. Las claves pertenecen a un recurso específico, así que asegúrate de usar una clave del mismo recurso que el endpoint.
No pudimos conectar con esta dirección
Revisa que el endpoint no tenga errores tipográficos. Si tu recurso restringe el acceso a redes específicas, la prueba podría fallar. Habilita el acceso público al recurso o añade la dirección de tu servidor y vuelve a probar.
Azure indica que se alcanzó la cuota o el límite de velocidad
Espera un minuto o amplía la cuota del despliegue directamente en Azure.
Preguntas frecuentes
Preguntas frecuentes
¿Qué clave debo usar, la CLAVE 1 o la CLAVE 2?
Cualquiera de las dos funciona. Te sugerimos usar la CLAVE 1. Si renuevas tus claves en Azure, pega la nueva clave usando Reemplazar clave.
¿Por qué debo escribir los nombres de los despliegues?
Azure te permite asignarle el nombre que quieras a cada despliegue. Como tu panel no puede adivinarlos, debes indicarle cuáles usar.