OpenAI

Integracja z OpenAI pozwala odpowiadać klientom w wiadomościach tekstem napisanym przez model OpenAI. Podłączasz ją własnym kluczem API z OpenAI Platform - za użycie płacisz bezpośrednio u dostawcy.

Integracji OpenAI możesz dodać dowolnie wiele, także kilka z tym samym kluczem API - na przykład z innym modelem albo innym promptem systemowym dla różnych kanałów. Każda działa osobno.

Jak wygenerować klucz API

Klucz tworzysz w OpenAI Platform. Skopiuj go od razu - klucz jest pokazywany tylko raz.

1. Zaloguj się na platform.openai.com.
2. Przejdź do API Keys i kliknij Create new secret key.
3. Skopiuj klucz.

Podłączenie konta

Zacznij w Ritevo:

1. Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
2. W sekcji Sztuczna inteligencja wybierz kafelek OpenAI.
3. W polu Nazwa konta wpisz własną nazwę integracji, wklej API Token i wybierz Model.
4. W karcie Ustawienia Zaawansowane wpisz Prompt systemowy i ustaw Maks. ilość tokenów - opis niżej.
5. Kliknij Utwórz integrację. Od razu wysyłamy do OpenAI krótkie zapytanie próbne z tym kluczem i modelem: jeśli się uda, integracja zostaje dodana i otworzą się jej ustawienia. Jeśli nie - zobaczysz błąd i nic nie zostanie zapisane.

Ustawienia integracji

Na stronie integracji znajdziesz poniższe pola. Zmiany zapisujesz przyciskiem Zaktualizuj integrację:

• Nazwa konta - Twoja własna nazwa integracji. Pod nią wybierasz integrację w akcji automatycznej.
• Model - model OpenAI, który pisze odpowiedzi: gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-4 albo gpt-3.5-turbo.
• Prompt systemowy - instrukcja dla AI dołączana do każdej odpowiedzi: kim jesteś, jakim tonem odpisywać, godziny pracy, zasady zwrotów, w jakim języku odpowiadać. To jedyne miejsce, w którym przekazujesz AI wiedzę o firmie.
• Maks. ilość tokenów - górny limit długości odpowiedzi. Domyślnie 1000. Za niski limit utnie odpowiedź w połowie i klient dostanie ją uciętą.
• Zaktualizuj token - podajesz nowy klucz API.

Odpowiedzi AI w wiadomościach

Integracja AI działa w akcjach dla wiadomości, w kroku Wyślij wiadomość AI do wątku. Szczegóły kroku i gotowy przykład znajdziesz w Akcjach dla wiadomości.

• Co dostaje AI - treść ostatniej wiadomości w wątku oraz Prompt systemowy. Nie dostaje wcześniejszej historii rozmowy ani danych zamówienia.
• Wysyłka - odpowiedź od razu trafia do klienta, bez zatwierdzania.
• Błąd - gdy dostawca AI zwróci błąd, nic nie jest wysyłane, a akcja się zatrzymuje. Błąd zobaczysz w audycie wiadomości.
• Koszty - każda odpowiedź rozlicza się na Twoim koncie u dostawcy AI. Dodanie integracji i zmiana klucza wysyłają jedno krótkie zapytanie próbne.

Wymaga ponownego połączenia

Ten stan pojawia się, gdy OpenAI odrzucił klucz API podczas pisania odpowiedzi - na przykład po jego usunięciu. Do czasu podania nowego klucza AI nie odpowie klientom.

1. Utwórz nowy klucz API w OpenAI Platform.
2. Na stronie integracji kliknij Zaktualizuj token, wklej klucz w polu API Token i zatwierdź. Sprawdzamy go krótkim zapytaniem próbnym - poprawny odświeży połączenie, a ustawienia zostają bez zmian.

Usunięcie integracji

Usuń integrację wyłącza integrację w Ritevo: przestaje pobierać i wysyłać dane, ale to, co pobrała wcześniej, zostaje. Przywróć integrację włącza ją z powrotem.

Czego integracja nie robi

• Nie podpowiada odpowiedzi do ręcznego wstawienia - odpowiada tylko przez akcję automatyczną.
• Nie czyta historii rozmowy ani danych zamówienia.
• Nie zapisuje odpowiedzi jako szkicu do zatwierdzenia.
• Nie ogranicza wydatków - limity ustawiasz na swoim koncie u dostawcy AI.