Połączenia

Połączenie przechowuje poświadczenia potrzebne do komunikacji z OpenAI. Samo połączenie nic nie zrobi — potrzebujesz też przynajmniej jednej konfiguracji modelu: konkretnego modelu zarejestrowanego w tym połączeniu, z własnymi cenami i nadpisaniami parametrów. W całej administracji wybór kombinacji połączenie+model jest oznaczony jako AI connection.

Pola połączenia

Connection name — etykieta admina.
Provider — OpenAI (jedyny obecnie wspierany dostawca).
API key — twój sekretny klucz OpenAI. Zapisany w bazie danych w postaci zaszyfrowanej.
Base URL (optional) — pozostaw puste, aby użyć domyślnego endpointu OpenAI. Nadpisz tylko, jeśli proxujesz OpenAI przez własny gateway.
Status — aktualizowany automatycznie po każdym wywołaniu testowym: connected / unknown / error.
Last tested at — znacznik czasu ostatniego udanego lub nieudanego testu.

Pola konfiguracji modelu

Kind — chat dla generowania tekstu, image_gen dla edycji obrazu.
Model — identyfikator modelu (np. gpt-4o-mini, gpt-image-1). Wybierany z listy zwracanej przez /v1/models.
Parameters — temperature, top P, max tokens. Domyślnie wartości rekomendowane przez OpenAI; nadpisz per przypadek użycia.
Pricing:
- Input per million tokens (USD)
- Output per million tokens (USD)
- Image edit cost (płaska stawka USD za wywołanie /images/edits)
Default for task types — multi-select. Ten model staje się wartością domyślną na liście rozwijanej AI connection dla wybranych typów zadań.

Pola cen napędzają estymator kosztów. Trzymaj je w synchronizacji ze stroną cenową OpenAI, aby twoje statystyki pozostawały dokładne.

Kreator Add AI connection

Przycisk Add connection na stronie ustawień Connections otwiera 3-krokowy kreator:

Credentials — nazwa połączenia, dostawca, klucz API, opcjonalny base URL.
Model configurations — po weryfikacji poświadczeń plugin wyświetla dostępne modele. Dodaj jedną lub więcej konfiguracji modelu, każda przypięta do kindu (chat / image generation), identyfikatora modelu, cen i parametrów. Tutaj możesz również przypisać każdy model do jego domyślnych typów zadań.
Review — podsumowanie tego, co zostało skonfigurowane, z przyciskami Test per konfiguracja modelu, aby zweryfikować end-to-end działanie poświadczeń.

Podczas edycji istniejącego połączenia ten sam kreator otwiera się ponownie z wypełnionymi polami.

Operacje

Strona listy połączeń wspiera standardowe akcje Shopware:

Add connection — otwórz kreator.
Test connection — pinguje OpenAI i aktualizuje plakietkę statusu.
Edit credentials & models — otwiera kreator z wypełnionymi polami.
Delete — dozwolone tylko, jeśli żadna konfiguracja modelu nie jest używana przez żaden prompt jako wartość domyślna.
Test (per konfiguracja modelu) — uruchamia małe completion, aby potwierdzić, że parametry i ceny działają end-to-end.

Wiele połączeń

Możesz mieć dowolną liczbę połączeń — przydatne do oddzielenia staging od produkcji lub do porównań A/B zachowania modeli bez rotacji kluczy. Lista rozwijana AI connection w administracji pokazuje każdy model chat / image_gen z każdego połączenia.