Connecter Azure OpenAI à Xcellerate AIG

En connectant Azure OpenAI à Xcellerate AIG, vous envoyez le trafic IA vers votre propre ressource Azure OpenAI : votre abonnement, votre région, vos déploiements. Vos applications continuent d'appeler l'API compatible OpenAI d'AIG avec une clé virtuelle, et AIG convertit chaque requête au format d'Azure. Ce guide s'adresse aux administrateurs qui configurent AIG pour un MSP, une PME ou une entreprise de services.

En bref

• Il vous faut l'endpoint de votre ressource, une clé API et le nom de vos déploiements.
• Les appelants désignent un déploiement sous la forme <nom-du-fournisseur>/<nom-du-déploiement>.
• Un seul fournisseur peut servir plusieurs ressources Azure ou versions d'API, une par clé.

Avant de commencer

• Une ressource Azure OpenAI avec au moins un déploiement de modèle. Notez chaque nom de déploiement exactement comme vous l'avez saisi dans le portail Azure.
• L'endpoint de la ressource, par exemple https://<your-resource>.openai.azure.com, et l'une de ses clés API. Les deux figurent sur la page Keys and Endpoint de la ressource.
• Facultatif : une version d'API. Si vous la laissez vide, AIG utilise 2024-10-21. C'est un minimum, pas une recommandation.
• Le rôle Admin dans AIG, ou un rôle personnalisé autorisé à créer et modifier des fournisseurs.
• Un accès HTTPS sortant d'AIG vers votre endpoint. Aucune URL de rappel n'est nécessaire.

Configurer Azure OpenAI

1. Créez le fournisseur

Allez dans Connexion → Fournisseurs et cliquez sur Connecter un fournisseur (ou Ajouter un fournisseur). Choisissez le type Azure OpenAI et donnez un nom, par exemple « Azure Europe de l'Ouest ». Azure n'a pas d'URL de base par défaut : l'endpoint se règle sur la clé. Une URL de base sur le fournisseur ne sert que de solution de repli.

2. Collez la clé API

Collez la clé Azure dans Clé API.

3. Remplissez les champs Azure

Ces champs s'affichent avec leur nom technique, dans toutes les langues :

• endpoint (obligatoire) : l'URL de votre ressource.
• api_version (facultatif) : la version d'API.
• deployment (facultatif) : lie cette clé à un seul déploiement.

4. Testez et activez

Cliquez sur Tester la connexion, puis sur Enable provider (activer le fournisseur).

5. Appelez un déploiement

Les appelants utilisent <nom-du-fournisseur>/<nom-du-déploiement>. Ainsi, azure_openai/prod-gpt4o atteint le déploiement prod-gpt4o. La partie « modèle » de l'adresse est donc le nom du déploiement.

6. Définissez vos prix

Sous Cost → Pricing (coûts → tarifs), ajoutez un tarif personnalisé. Un nom de déploiement privé peut être absent de la fiche de données publique, et les prix négociés diffèrent.

Ce qui se passe après la connexion

AIG envoie chaque requête vers <endpoint>/openai/deployments/<deployment>/<operation>?api-version=<version>, avec votre clé dans l'en-tête api-key. Sont disponibles : chat, embeddings, images, voix et transcription. Si votre ressource a moins de déploiements, restreignez le fournisseur via Ce que ce fournisseur sert ; les autres requêtes sont alors refusées dès AIG. Gouvernance, journalisation, budgets et solutions de repli s'appliquent comme pour tout autre fournisseur.

Bon à savoir

• Azure attend le nom du déploiement, pas celui du modèle. AIG transmet la partie « modèle » de l'adresse comme déploiement, sauf si vous remplissez deployment sur la clé.
• Deux abonnements sur des versions d'API différentes ? Ajoutez deux clés, chacune avec son propre endpoint et sa propre api_version.
• AIG s'authentifie auprès d'Azure OpenAI avec une clé API.
• Vos données sont traitées dans la région de votre ressource Azure.
• Les clés sont en écriture seule et ne sont jamais renvoyées au navigateur.
• Sans licence, AIG fonctionne en mode gratuit : 5 clés virtuelles, 5 requêtes par clé et par jour.

Dépannage

• Azure provider '<name>' has no endpoint configured on its key. Renseignez endpoint sur la clé, ou une URL de base sur le fournisseur.
• <model> did not answer (<ms> ms): <message> lors du test. En général, l'endpoint, le nom du déploiement ou la version d'API est incorrect.
• No healthy API key is available for provider '…' Azure a refusé la clé et AIG l'a marquée Dead. Corrigez la clé, puis cliquez sur Clear health flags (effacer les indicateurs d'état).

Parlons d'AIG

Vous voulez savoir comment AIG réunit votre environnement Azure et vos autres fournisseurs ? Parlez-nous d'AIG. Pour aller plus loin : tous les fournisseurs dans un catalogue et les clés virtuelles.