Podłączanie AI

Zanim P2Lab AI będzie mógł cokolwiek zrobić, musisz podać mu dane uwierzytelniające do konta OpenAI i wskazać, których modeli chcesz używać. Plugin trzyma dwa powiązane rekordy:

• Connection — samo konto OpenAI (klucz API, opcjonalny override Base URL, status ostatniego testu).
• Jedna lub więcej model configurations — konkretne modele zarejestrowane na danym połączeniu, każdy z własnym cennikiem, parametrami i domyślnymi przypisaniami do typów zadań.

W całym panelu administracyjnym wybór kombinacji połączenie-plus-model jest oznaczony jako AI connection.

Krok 1 — Dodaj połączenie

1. Otwórz AI Assistant → Settings → Connections.
2. Kliknij Add connection — otworzy się kreator Add AI connection.
3. Wypełnij:
   • Connection name — etykieta, którą rozpoznasz później, np. “OpenAI production”.
   • Provider — OpenAI.
   • API key — Twój sekretny klucz OpenAI (sk-...).
   • Base URL (optional) — zostaw puste, żeby używać domyślnego endpointu OpenAI. Nadpisuj tylko, jeśli przepuszczasz OpenAI przez własny gateway.
4. Kliknij Next. Plugin pinguje OpenAI, żeby zweryfikować dane uwierzytelniające.

Krok 2 — Dodaj jedną lub więcej konfiguracji modeli

Połączenie bez konfiguracji modelu nie może uruchomić żadnych zadań. W kroku Model configurations kreatora:

1. Kliknij Add model configuration.
2. Wybierz kind:
   • Chat — do generowania tekstu, ekstrakcji, tłumaczeń itp.
   • Image generation — do zadań edycji obrazów.
3. Wybierz model. Lista rozwijana pokazuje wszystko, czego Twoje konto może używać (np. gpt-4o-mini, gpt-image-1, …).
4. Wypełnij Pricing:
   • Input per million tokens — dopasuj do opublikowanej stawki OpenAI dla wybranego modelu.
   • Output per million tokens — to samo.
   • Web-search call cost — stała opłata za wywołanie narzędzia web_search (tylko modele chat).
   • Image edit cost — stała opłata za wywołanie /images/edits (tylko modele obrazu).
5. (Opcjonalnie) Dostosuj temperature, top P, max tokens, jeśli chcesz odejść od domyślnych wartości OpenAI.
6. W Default for task types zaznacz każde zadanie, które ten model ma domyślnie obsługiwać (np. generate_seo.product, extract_measures, translate.product, …).
7. Zapisz konfigurację modelu.

Wskazówka

Plugin nie zakłada żadnego cennika. Stawki, które tutaj wpisujesz, to dokładnie te, przez które estymator kosztów mnoży liczbę tokenów. Trzymaj je zsynchronizowane ze stroną cennika OpenAI, żeby statystyki były dokładne.

Możesz dodać wiele konfiguracji modeli do tego samego połączenia i podzielić zadania między nimi — na przykład tańszy model tekstowy do tłumaczeń i mocniejszy do generowania treści.

Krok 3 — Review i test

W kroku Review kreatora zobaczysz podsumowanie połączenia i każdej konfiguracji modelu. Kliknij przycisk Test przy każdej konfiguracji modelu, żeby uruchomić mały completion end-to-end i potwierdzić, że dane uwierzytelniające i cennik działają.

Konfigurowanie wielu połączeń

Możesz dodać więcej niż jedno połączenie — przydatne do rozdzielenia kont staging i produkcyjnych albo do testów porównawczych. Każde połączenie ma własny klucz, własne modele i własny status. Lista rozwijana AI connection w panelu pokazuje każdy model chat / image_gen z każdego połączenia.

Rozwiązywanie problemów

• “Invalid API key” — klucz został odrzucony przez OpenAI. Skopiuj go ponownie z panelu OpenAI.
• “No models returned” — Twoje konto OpenAI nie ma dostępnych modeli. Sprawdź rozliczenia po stronie OpenAI.
• Test connection times out — Twój serwer nie może dotrzeć do api.openai.com. Sprawdź reguły sieci wychodzącej.

Dalej: uruchom prompt

Mając połączenie i co najmniej jedną konfigurację modelu, przejdź do First prompt, żeby zobaczyć plugin w akcji.