In diesem Artikel
Bereich: Einstellungen → Inhalte & Veröffentlichung → Deine KI-Konten
Diese Seite öffnen: admin.<your-site>/settings/ai/providers (ersetze <your-site> durch deine Website-Adresse)
Vorab prüfen
- Ein Azure-Konto mit einer Azure OpenAI-Ressource.
- Mindestens ein in dieser Ressource bereitgestelltes (deployed) Modell. Azure führt Modelle erst aus, wenn sie bereitgestellt wurden.
- Die Berechtigung, die Keys der Ressource in Azure einzusehen.
- Nur Mitglieder, die KI verwalten dürfen, können die Verknüpfung einrichten. Außerdem musst du dich vor Kurzem angemeldet haben.
Schritt für Schritt
- Öffne das Azure-Portal und gehe zu deiner Azure OpenAI-Ressource.
- Wechsle zu Ressourcenverwaltung und dann zu Schlüssel und Endpunkt.
- Kopiere den Endpunkt. Er sieht aus wie
https://my-resource.openai.azure.comund muss auf.openai.azure.comoder.cognitiveservices.azure.comenden. - Kopiere KEY 1. Hebe dir KEY 2 als Reserve auf. Dein Adminbereich akzeptiert Keys mit 32 Zeichen (Buchstaben a–f und Ziffern) oder 84 Zeichen.
- Finde deine Deployment-Namen. Öffne im Portal von Azure AI Foundry die Deployments deiner Ressource. Der Deployment-Name ist die Bezeichnung, die du beim Bereitstellen vergeben hast. Er kann vom eigentlichen Modellnamen abweichen, wie etwa
gpt-4o-mini. - Öffne im Adminbereich deiner Website Einstellungen → Inhalte & Veröffentlichung → Ihre KI-Konten und suche die Karte Azure OpenAI.
- Füge den Azure-Endpunkt ein. Trage unter Deployment-Namen deine Deployments ein und tippe nach jedem Namen auf Hinzufügen. Füge mindestens eines hinzu.
- Füge den Key ein und tippe auf Testen & verbinden. Es erscheint „Key wird geprüft …“ und anschließend Verbunden ✓.
Gut zu wissen
- Du kannst bis zu zwei Azure-Ressourcen verknüpfen.
- Da Azure für einen Key keine Liste der Modelle bereitstellt, zeigt der Adminbereich nur die von dir eingetragenen Deployments an. Füge einfach weitere hinzu, wenn du später neue Modelle bereitstellst.
- Preisangaben sind optional. Mit Preisen kann der Adminbereich Kosten anzeigen. Ohne Preise wechselt die KI nicht automatisch zu diesem Konto, falls ein anderer Anbieter ausfällt.
- Die Abrechnung erfolgt über Azure. Deine Kosten und Limits findest du im Azure-Portal. KI-Budget und Limits
- Der Key verbleibt sicher auf deinem eigenen Server. Keynate bekommt ihn nie zu Gesicht.
Typische Probleme
Verwende deinen Azure OpenAI-Endpunkt
Der Endpunkt muss auf .openai.azure.com oder .cognitiveservices.azure.com enden. Kopiere ihn direkt aus Schlüssel und Endpunkt. Eine eigene Domain oder eine IP-Adresse funktioniert hier nicht.
Dieses Modell oder Deployment ist in deinem Azure OpenAI-Konto nicht verfügbar
Der Name des Deployments stimmt nicht überein. Die Schreibweise muss exakt passen, inklusive Groß- und Kleinschreibung. Prüfe deine Deployments in Foundry, passe den Namen auf der Karte an und versuche es erneut.
Azure OpenAI hat diesen Key abgelehnt
Kopiere den gesamten Key noch einmal. Keys gehören immer fest zu einer bestimmten Ressource – nutze also einen Key aus derselben Ressource wie der Endpunkt.
Diese Adresse konnte nicht erreicht werden
Prüfe den Endpunkt auf Tippfehler. Falls der Zugriff auf deine Ressource auf bestimmte Netzwerke beschränkt ist, kann der Verbindungstest fehlschlagen. Erlaube den öffentlichen Zugriff auf die Ressource oder hinterlege die Adresse deines Servers und teste es noch einmal.
Azure meldet, dass das Kontingent oder Rate-Limit erreicht ist
Warte kurz ab oder erhöhe das Kontingent (Quota) für das jeweilige Deployment in Azure.
Fragen
Häufig gestellte Fragen
Welchen Key soll ich nutzen – KEY 1 oder KEY 2?
Das ist egal. Nimm am besten KEY 1. Wenn du Keys in Azure rotierst, kannst du den neuen Key jederzeit über Schlüssel ersetzen einfügen.
Warum muss ich die Deployment-Namen von Hand eingeben?
In Azure wählst du den Namen für jede Bereitstellung selbst. Dein Adminbereich kann diese nicht erraten, daher musst du ihm mitteilen, welche Deployments er nutzen soll.