Azure OpenAI koppelen aan Xcellerate AIG

Door Azure OpenAI aan Xcellerate AIG te koppelen, stuur je AI-verkeer naar je eigen Azure OpenAI-resource: jouw abonnement, jouw regio, jouw deployments. Je applicaties blijven de OpenAI-compatibele API van AIG aanroepen met een virtuele sleutel, en AIG zet elke aanvraag om naar het formaat van Azure. Deze gids is voor beheerders die AIG opzetten voor een MSP, kmo of dienstverlener.

Kort samengevat

• Je hebt het endpoint van je resource nodig, een API-sleutel en de namen van je deployments.
• Aanroepers spreken een deployment aan als <provider-naam>/<deployment-naam>.
• Eén provider kan meerdere Azure-resources of API-versies bedienen, één per sleutel.

Voor je begint

• Een Azure OpenAI-resource met minstens één modeldeployment. Noteer elke deploymentnaam precies zoals je hem in de Azure-portal hebt genoemd.
• Het endpoint van de resource, bijvoorbeeld https://<your-resource>.openai.azure.com, en een van de API-sleutels. Je vindt beide op de pagina Keys and Endpoint van de resource.
• Optioneel een API-versie. Laat je die leeg, dan gebruikt AIG 2024-10-21. Dat is een ondergrens, geen aanbeveling.
• De rol Admin in AIG, of een eigen rol met het recht om providers aan te maken en te bewerken.
• Uitgaand HTTPS-verkeer van AIG naar je endpoint. Callback-URL's zijn niet nodig.

Azure OpenAI instellen

1. Maak de provider aan

Ga naar Verbinden → Providers en klik op Een provider verbinden (of Provider toevoegen). Kies het providertype Azure OpenAI en geef een naam, bijvoorbeeld "Azure West-Europa". Azure heeft geen standaard Basis-URL: het endpoint zet je op de sleutel. Een Basis-URL op de provider dient alleen als terugvaloptie.

2. Plak de API-sleutel

Plak de Azure-sleutel in API-sleutel.

3. Vul de Azure-velden in

Deze velden staan in elke taal met hun technische naam op het scherm:

• endpoint (verplicht): de URL van je resource.
• api_version (optioneel): de API-versie.
• deployment (optioneel): koppelt deze sleutel vast aan één deployment.

4. Test en schakel in

Klik op Verbinding testen en daarna op Enable provider (provider inschakelen).

5. Spreek een deployment aan

Aanroepers gebruiken <provider-naam>/<deployment-naam>. Zo komt azure_openai/prod-gpt4o terecht bij de deployment prod-gpt4o. Het modeldeel van het adres is dus de naam van de deployment.

6. Stel je prijzen in

Voeg onder Cost → Pricing (kosten → prijzen) een prijsoverschrijving toe. Een eigen deploymentnaam staat mogelijk niet in het publieke gegevensblad, en onderhandelde prijzen wijken af.

Wat er gebeurt na het koppelen

AIG stuurt elke aanvraag naar <endpoint>/openai/deployments/<deployment>/<operation>?api-version=<version>, met je sleutel in de header api-key. Beschikbaar zijn chat, embeddings, afbeeldingen, spraak en transcriptie. Heeft je resource minder deployments, beperk dan de provider via Wat deze provider levert. Andere aanvragen worden dan al in AIG geweigerd. Governance, logging, budgetten en fallbacks werken zoals bij elke andere provider.

Goed om te weten

• Azure heeft de naam van de deployment nodig, niet die van het model. AIG stuurt het modeldeel van het adres door als deployment, tenzij je deployment op de sleutel invult.
• Twee abonnementen op verschillende API-versies? Voeg twee sleutels toe, elk met een eigen endpoint en api_version.
• AIG meldt zich bij Azure OpenAI aan met een API-sleutel.
• Je gegevens worden verwerkt in de regio van je Azure-resource.
• Sleutels zijn alleen-schrijven en worden nooit naar de browser teruggestuurd.
• Zonder licentie draait AIG in de gratis modus: 5 virtuele sleutels met elk 5 aanvragen per dag.

Problemen oplossen

• Azure provider '<name>' has no endpoint configured on its key. Vul endpoint in op de sleutel, of een Basis-URL op de provider.
• <model> did not answer (<ms> ms): <message> bij het testen. Meestal klopt het endpoint, de deploymentnaam of de API-versie niet.
• No healthy API key is available for provider '…' Azure heeft de sleutel geweigerd en AIG heeft hem als Dead gemarkeerd. Herstel de sleutel en klik op Clear health flags (statusmarkeringen wissen).

Praat met ons over AIG

Wil je weten hoe AIG je Azure-omgeving en je andere providers samenbrengt? Praat met ons over AIG. Lees ook meer over alle providers in één catalogus en virtuele sleutels.