Azure OpenAI mit Xcellerate AIG verbinden

Wenn Sie Azure OpenAI mit Xcellerate AIG verbinden, geht KI-Verkehr an Ihre eigene Azure-OpenAI-Ressource: Ihr Abonnement, Ihre Region, Ihre Deployments. Ihre Anwendungen rufen weiterhin die OpenAI-kompatible API von AIG mit einem virtuellen Schlüssel auf, und AIG setzt jede Anfrage in das Azure-Format um. Diese Anleitung richtet sich an Admins, die AIG für ein MSP, KMU oder Dienstleistungsunternehmen einrichten.

Kurz gesagt

• Sie brauchen den Endpoint Ihrer Ressource, einen API-Schlüssel und die Namen Ihrer Deployments.
• Aufrufer sprechen ein Deployment als <provider-name>/<deployment-name> an.
• Ein Provider kann mehrere Azure-Ressourcen oder API-Versionen bedienen, eine pro Schlüssel.

Bevor Sie beginnen

• Eine Azure-OpenAI-Ressource mit mindestens einem Modell-Deployment. Notieren Sie jeden Deployment-Namen genau so, wie Sie ihn im Azure-Portal vergeben haben.
• Den Endpoint der Ressource, zum Beispiel https://<your-resource>.openai.azure.com, und einen ihrer API-Schlüssel. Beides finden Sie auf der Seite Keys and Endpoint der Ressource.
• Optional eine API-Version. Bleibt sie leer, verwendet AIG 2024-10-21. Das ist eine Untergrenze, keine Empfehlung.
• Die Rolle Admin in AIG oder eine eigene Rolle mit dem Recht, Provider anzulegen und zu bearbeiten.
• Ausgehendes HTTPS von AIG zu Ihrem Endpoint. Callback-URLs sind nicht nötig.

Azure OpenAI einrichten

1. Provider anlegen

Gehen Sie zu Connect → Providers (Verbinden → Provider) und klicken Sie auf Connect a provider (Provider verbinden) oder Add provider (Provider hinzufügen). Wählen Sie den Typ Azure OpenAI und vergeben Sie einen Namen, zum Beispiel „Azure Westeuropa“. Azure hat keine Standard-Base URL (Basis-URL): Der Endpoint wird am Schlüssel eingetragen. Eine Base URL am Provider dient nur als Rückfall.

2. API-Schlüssel einfügen

Fügen Sie den Azure-Schlüssel in API key (API-Schlüssel) ein.

3. Azure-Felder ausfüllen

Diese Felder erscheinen in jeder Sprache mit ihrem technischen Namen:

• endpoint (Pflicht): die URL Ihrer Ressource.
• api_version (optional): die API-Version.
• deployment (optional): bindet diesen Schlüssel an ein Deployment.

4. Testen und aktivieren

Klicken Sie auf Test connection (Verbindung testen) und danach auf Enable provider (Provider aktivieren).

5. Ein Deployment aufrufen

Aufrufer verwenden <provider-name>/<deployment-name>. So erreicht azure_openai/prod-gpt4o das Deployment prod-gpt4o. Der Modellteil der Adresse ist also der Deployment-Name.

6. Preise festlegen

Fügen Sie unter Cost → Pricing (Kosten → Preise) eine Preisüberschreibung hinzu. Ein eigener Deployment-Name steht womöglich nicht im öffentlichen Datenblatt, und ausgehandelte Preise weichen ab.

Was nach dem Verbinden passiert

AIG sendet jede Anfrage an <endpoint>/openai/deployments/<deployment>/<operation>?api-version=<version>, mit Ihrem Schlüssel im Header api-key. Verfügbar sind Chat, Embeddings, Bilder, Sprachausgabe und Transkription. Hat Ihre Ressource weniger Deployments, grenzen Sie den Provider über What this provider serves (was dieser Provider liefert) ein; andere Anfragen lehnt AIG dann schon selbst ab. Governance, Protokollierung, Budgets und Fallbacks gelten wie bei jedem anderen Provider.

Gut zu wissen

• Azure braucht den Deployment-Namen, nicht den Modellnamen. AIG gibt den Modellteil der Adresse als Deployment weiter, außer Sie tragen deployment am Schlüssel ein.
• Zwei Abonnements mit unterschiedlichen API-Versionen? Legen Sie zwei Schlüssel an, jeweils mit eigenem endpoint und api_version.
• AIG meldet sich bei Azure OpenAI mit einem API-Schlüssel an.
• Ihre Daten werden in der Region Ihrer Azure-Ressource verarbeitet.
• Schlüssel sind nur schreibbar und werden nie an den Browser zurückgegeben.
• Ohne Lizenz läuft AIG im kostenlosen Modus: 5 virtuelle Schlüssel mit je 5 Anfragen pro Tag.

Fehlerbehebung

• Azure provider '<name>' has no endpoint configured on its key. Tragen Sie endpoint am Schlüssel ein oder eine Base URL am Provider.
• <model> did not answer (<ms> ms): <message> beim Test. Meist stimmt der Endpoint, der Deployment-Name oder die API-Version nicht.
• No healthy API key is available for provider '…' Azure hat den Schlüssel abgelehnt, und AIG hat ihn als Dead markiert. Korrigieren Sie den Schlüssel und klicken Sie auf Clear health flags (Statusmarkierungen löschen).

Sprechen Sie mit uns über AIG

Sie möchten wissen, wie AIG Ihre Azure-Umgebung und Ihre anderen Provider zusammenführt? Sprechen Sie mit uns über AIG. Mehr dazu: alle Anbieter in einem Katalog und virtuelle Schlüssel.