Verbindungen

Eine Verbindung enthält die Zugangsdaten, die für die Kommunikation mit OpenAI benötigt werden. Eine Verbindung allein kann nichts ausrichten — Sie benötigen außerdem mindestens eine Modell-Konfiguration: ein bestimmtes Modell, das gegen diese Verbindung registriert ist und über eigene Preise und Parameter-Überschreibungen verfügt. In der gesamten Administration wird die Kombination aus Verbindung und Modell als KI-Verbindung bezeichnet.

Verbindungsfelder

Verbindungsname — Bezeichnung in der Administration.
Anbieter — OpenAI (der derzeit einzige unterstützte Anbieter).
API-Schlüssel — Ihr geheimer OpenAI-Schlüssel. Wird verschlüsselt in der Datenbank gespeichert.
Base URL (optional) — leer lassen, um den Standard-Endpunkt von OpenAI zu verwenden. Überschreiben Sie ihn nur, wenn Sie OpenAI über Ihr eigenes Gateway leiten.
Status — wird nach jedem Testaufruf automatisch aktualisiert: Verbunden / Unbekannt / Fehler.
Zuletzt getestet — Zeitstempel des letzten erfolgreichen oder fehlgeschlagenen Tests.

Felder der Modell-Konfiguration

Typ — chat für die Texterzeugung, image_gen für die Bildbearbeitung.
Modell — die Modellkennung (z. B. gpt-4o-mini, gpt-image-1). Wird aus der von /v1/models zurückgegebenen Liste ausgewählt.
Parameter — Temperature, Top P, Max Tokens. Standardmäßig die von OpenAI empfohlenen Werte; pro Anwendungsfall überschreibbar.
Preise:
- Input pro Million Token (USD)
- Output pro Million Token (USD)
- Kosten für Bildbearbeitung (pauschal in USD pro /images/edits-Aufruf)
Standard für Aufgabentypen — Mehrfachauswahl. Dieses Modell wird zum Standard im Dropdown KI-Verbindung für die ausgewählten Aufgabentypen.

Die Preisfelder steuern den Kostenschätzer. Halten Sie sie mit der Preisseite von OpenAI synchron, damit Ihre Statistiken korrekt bleiben.

Assistent „KI-Verbindung hinzufügen“

Die Schaltfläche Verbindung hinzufügen auf der Einstellungsseite „Verbindungen“ öffnet einen dreistufigen Assistenten:

Zugangsdaten — Verbindungsname, Anbieter, API-Schlüssel, optionale Base URL.
Modell-Konfigurationen — nach der Prüfung der Zugangsdaten listet das Plugin die verfügbaren Modelle auf. Fügen Sie eine oder mehrere Modell-Konfigurationen hinzu, jeweils festgelegt auf einen Typ (Chat / Bildgenerierung), eine Modellkennung, Preise und Parameter. Sie können hier außerdem jedes Modell an seine Standard-Aufgabentypen binden.
Überprüfen — Zusammenfassung dessen, was Sie eingerichtet haben, mit Test-Schaltflächen pro Modell-Konfiguration, um zu überprüfen, dass die Zugangsdaten durchgängig funktionieren.

Beim Bearbeiten einer bestehenden Verbindung wird derselbe Assistent vorausgefüllt erneut geöffnet.

Aktionen

Die Verbindungsliste unterstützt die üblichen Shopware-Aktionen:

Verbindung hinzufügen — öffnet den Assistenten.
Verbindung testen — sendet einen Ping an OpenAI und aktualisiert das Status-Abzeichen.
Zugangsdaten & Modelle bearbeiten — öffnet den vorausgefüllten Assistenten.
Löschen — nur zulässig, wenn keine Modell-Konfiguration von einem Prompt als Standard verwendet wird.
Test (pro Modell-Konfiguration) — führt eine kleine Completion aus, um zu bestätigen, dass Parameter und Preise durchgängig funktionieren.

Mehrere Verbindungen

Sie können beliebig viele Verbindungen anlegen — nützlich, um Staging von Produktion zu trennen oder das Verhalten von Modellen per A/B-Vergleich zu testen, ohne Schlüssel zu wechseln. Das Dropdown KI-Verbindung in der gesamten Administration zeigt jedes chat-/image_gen-Modell aus jeder Verbindung an.