Conectar Azure OpenAI a Xcellerate AIG

Al conectar Azure OpenAI a Xcellerate AIG, el tráfico de IA va a su propio recurso de Azure OpenAI: su suscripción, su región, sus implementaciones (deployments). Sus aplicaciones siguen llamando a la API compatible con OpenAI de AIG con una clave virtual, y AIG convierte cada solicitud al formato de Azure. Esta guía es para administradores que configuran AIG en un MSP, una pyme o una empresa de servicios.

En resumen

• Necesita el endpoint de su recurso, una clave API y los nombres de sus implementaciones.
• Quien llama indica una implementación como <nombre-del-proveedor>/<nombre-de-la-implementación>.
• Un proveedor puede atender varios recursos de Azure o versiones de API, una por clave.

Antes de empezar

• Un recurso de Azure OpenAI con al menos una implementación de modelo. Anote cada nombre de implementación tal como lo escribió en el portal de Azure.
• El endpoint del recurso, por ejemplo https://<your-resource>.openai.azure.com, y una de sus claves API. Ambos están en la página Keys and Endpoint del recurso.
• Opcionalmente, una versión de API. Si la deja vacía, AIG usa 2024-10-21. Es un mínimo, no una recomendación.
• El rol Admin en AIG, o un rol personalizado con permiso para crear y editar proveedores.
• Tráfico HTTPS saliente desde AIG hacia su endpoint. No hacen falta URL de retorno.

Configurar Azure OpenAI

1. Cree el proveedor

Vaya a Connect → Providers (Conectar → Proveedores) y haga clic en Connect a provider (conectar un proveedor) o Add provider (añadir proveedor). Elija el tipo Azure OpenAI y asigne un nombre, por ejemplo «Azure Europa Occidental». Azure no tiene Base URL (URL base) por defecto: el endpoint se configura en la clave. Una Base URL en el proveedor solo sirve de alternativa.

2. Pegue la clave API

Pegue la clave de Azure en API key (clave API).

3. Rellene los campos de Azure

Estos campos aparecen con su nombre técnico en todos los idiomas:

• endpoint (obligatorio): la URL de su recurso.
• api_version (opcional): la versión de API.
• deployment (opcional): fija esta clave a una sola implementación.

4. Pruebe y active

Haga clic en Test connection (probar conexión) y después en Enable provider (activar proveedor).

5. Llame a una implementación

Quien llama usa <nombre-del-proveedor>/<nombre-de-la-implementación>. Por ejemplo, azure_openai/prod-gpt4o llega a la implementación prod-gpt4o. La parte «modelo» de la dirección es el nombre de la implementación.

6. Defina sus precios

En Cost → Pricing (Costes → Precios), añada un precio personalizado. Un nombre de implementación privado puede no figurar en la ficha de datos pública, y los precios negociados son distintos.

Qué ocurre después de conectar

AIG envía cada solicitud a <endpoint>/openai/deployments/<deployment>/<operation>?api-version=<version>, con su clave en la cabecera api-key. Están disponibles chat, embeddings, imágenes, voz y transcripción. Si su recurso tiene menos implementaciones, limite el proveedor con What this provider serves (qué ofrece este proveedor); las demás solicitudes se rechazan entonces dentro de AIG. La gobernanza, los registros, los presupuestos y las alternativas funcionan igual que con cualquier otro proveedor.

Conviene saber

• Azure necesita el nombre de la implementación, no el del modelo. AIG envía la parte «modelo» de la dirección como implementación, salvo que rellene deployment en la clave.
• ¿Dos suscripciones con versiones de API distintas? Añada dos claves, cada una con su propio endpoint y api_version.
• AIG se autentica ante Azure OpenAI con una clave API.
• Sus datos se procesan en la región de su recurso de Azure.
• Las claves son de solo escritura y nunca se devuelven al navegador.
• Sin licencia, AIG funciona en modo gratuito: 5 claves virtuales con 5 solicitudes por clave y día.

Solución de problemas

• Azure provider '<name>' has no endpoint configured on its key. Rellene endpoint en la clave, o una Base URL en el proveedor.
• <model> did not answer (<ms> ms): <message> durante la prueba. Normalmente el endpoint, el nombre de la implementación o la versión de API son incorrectos.
• No healthy API key is available for provider '…' Azure rechazó la clave y AIG la marcó como Dead. Corrija la clave y haga clic en Clear health flags (borrar indicadores de estado).

Hable con nosotros sobre AIG

¿Quiere saber cómo AIG une su entorno de Azure con sus otros proveedores? Hable con nosotros sobre AIG. Más información sobre todos los proveedores en un catálogo y las claves virtuales.