Konfigurowanie OpenAI dla Agentów AI 3CX

Wprowadzenie

Ten przewodnik wyjaśnia, jak zintegrować OpenAI z Agentami AI 3CX, aby umożliwić realizację scenariuszy inteligentnej recepcji i obsługi połączeń napędzanych przez AI.

Funkcja ta wymaga edycji 3CX AI.

Krok 1: Konfiguracja konta OpenAI

Jeśli nie masz jeszcze konta OpenAI, utwórz je, skonfiguruj rozliczenia i wygeneruj klucz API.

Utworzenie projektu i konfiguracja rozliczeń

  1. Zaloguj się na stronie logowania OpenAI.
  2. Utwórz nowy projekt („Project”) i nadaj mu opisową nazwę.
  3. Przejdź do „Settings” (Ustawienia) → „Billing” (Rozliczenia) i dokończ konfigurację płatności.
  4. Upewnij się, że masz wystarczające środki na koncie dla przewidywanego zużycia.

Uwaga: Do poprawnego działania wymagane jest płatne konto OpenAI; konta próbne (trial) mają ograniczenia i mogą wykazywać nieprzewidywalne problemy lub błędy. Konta OpenAI, na których wpłacono minimum 100 USD, są zazwyczaj od razu przenoszone do poziomu Tier 3.

Konfiguracja dostępu do modeli i limitów

  1. Przejdź do „Project” (Projekt) → „Limits” (Limity).
  2. Ustaw budżet, aby kontrolować wydatki.
  3. W sekcji „Allow or block models” (Zezwalaj lub blokuj modele) pozostaw listę pustą, aby zezwolić na wszystkie modele.
  4. W sekcji „Rate limits” (Limity stawek/żądań) zwiększ limity dla powyższych modeli w miarę potrzeb (większe instalacje mogą wymagać wyższych limitów, aby uniknąć nieprzewidywalnego zachowania).

Uwaga dotycząca Rate Limits: Twoja możliwość podniesienia limitów zależy od poziomu zużycia (tier) i historii Twojego konta API w OpenAI.

Utworzenie nowego klucza API

  1. Przejdź do „Dashboard” (Panel) → „API Keys” (Klucze API).
  2. Kliknij przycisk „Create a New Secret Key” (Utwórz nowy klucz tajny).
  3. Wprowadź opisową nazwę i ustaw uprawnienia na „All” (Wszystkie).
  4. Skopiuj klucz i przechowuj go w bezpiecznym miejscu.

Krok 2: Konfiguracja OpenAI w 3CX

  1. W Konsoli Administracyjnej przejdź do „Admin” → „Integrations” (Integracje) → „AI” i kliknij przycisk „OpenAI API”.

  1. Wklej swój klucz tajny OpenAI („OpenAI Secret Key”).
  2. Wybierz modele:
  • Model OpenAI dla połączeń w czasie rzeczywistym: gpt-realtime (zalecany).
  • Model OpenAI dla tekstu: gpt-5o-mini (zalecany).
  1. Wypełnij pola:
  • „Company Name” (Nazwa firmy).
  • „Company Description” (Opis firmy) – informacja ta jest używana przez Agentów AI do zrozumienia kontekstu Twojej organizacji.
  1. Kliknij przycisk „Save” (Zapisz).

Krok 3: Dodawanie źródeł wiedzy / RAG (własne treści)

Źródła wiedzy („Knowledge Sources”) pozwalają agentom pobierać treści specyficzne dla firmy podczas połączeń/czatów (polityki, FAQ, zasady routingu, dokumentacja produktów). W ekosystemie OpenAI jest to powszechnie realizowane poprzez przesyłanie plików oraz osadzanie (embedding) i wyszukiwanie wektorowe (vector search) w celu wyszukiwania informacji.

  • W Konsoli Administracyjnej przejdź do „Admin” → „Integrations” (Integracje) → „AI”.
  • Kliknij przycisk „Knowledge Sources” (Źródła wiedzy), a następnie przycisk „Add” (Dodaj).

  • Ustaw „Name” (Nazwa) i „Description” (Opis) dla swojej bazy wiedzy.
  • Prześlij pliki (PDF/dokumenty/tekst) zawierające wszystko, co dotyczy Twojej firmy, np.:
  • godziny pracy i zasady dotyczące świąt;
  • instrukcje routingu do działów;
  • FAQ dotyczące produktów/cen;
  • wytyczne dotyczące sformułowań typu „co robimy / jak o nas mówić”.
  • WSKAZÓWKI
  • Upewnij się, że „Description” (Opis) dokładnie opisuje zawartość bazy wiedzy, co poprawi skuteczność wyszukiwania informacji.
  • Jeśli masz dokumenty dotyczące różnych, niezwiązanych ze sobą kontekstów (na przykład dokumentację medyczną i wewnętrzne zasady dotyczące podróży), nie umieszczaj ich w tym samym magazynie; utwórz oddzielne magazyny wiedzy dla każdego kontekstu.
  • OpenAI API nie informuje 3CX o każdej zmianie w bazie wiedzy; po każdej wprowadzonej zmianie naciśnij przycisk „Refresh” (Odśwież) i poczekaj na zakończenie procesu.

Uwaga: Źródła wiedzy są tworzone i rozliczane w ramach skonfigurowanego projektu/klucza OpenAI.

Krok 4: Tworzenie i konfiguracja Agentów AI

  1. Kliknij przycisk „Admin” → „Integrations” (Integracje) → „AI” → „Add Agent” (Dodaj agenta).

  • Wybierz typ agenta:
  1. Receptionist (Recepcjonista): zorientowany na firmę agent AI do podstawowej obsługi i kierowania połączeń.
  2. Personal Assistant (Asystent osobisty): skonfigurowany do obsługi połączeń dla konkretnego użytkownika (np. dla Boss-Secretary).

  1. W zakładce „Agent Info” (Informacje o agencie):
  • Zdefiniuj ustawienia ogólne („General Settings”) dla swojego Agenta AI:
  1. Extension (Numer wewnętrzny) – unikalny numer wewnętrzny dla Agenta AI.
  2. Assistant For (Asystent dla) (tylko PA) – któremu użytkownikowi asystuje.
  3. Department Membership (Przynależność do działu) – do których działów należy Agent AI.
  4. First Name (Imię) i Last Name (Nazwisko) – tożsamość głosowa/widoczna Agenta AI.
  5. Assigned DID number(s) (Przypisane numery DID) – bezpośrednie numery przychodzące do Agenta AI.
  • Skonfiguruj ustawienia głosu i połączeń („Voice and Call Settings”) dla swojego Agenta AI:
  1. Voice Style (Styl głosu) – wybierz preferowany wariant głosu.
  2. Call Recording (Nagrywanie rozmów) – wyłączone (Off), wszystkie połączenia (All calls) lub tylko połączenia zewnętrzne (External calls only).
  3. Maximum Call Duration (Maksymalny czas trwania połączenia).
  4. Agent Talk Link – umożliwia funkcję „kliknij, aby rozmawiać” lub czat ze strony internetowej; pozostawienie pola pustego wyłącza link dla tego Agenta.
  1. W zakładce „Agent Type” (Typ agenta):
  • Ustaw „Knowledge Sources” – wybierz, do których źródeł wiedzy agent ma mieć dostęp.
  • Ustaw „Introduction Language” – domyślny język powitania.
  1. Możesz także włączyć „Allow Language Switching” (Zezwalaj na zmianę języka).
  • Ustaw „Welcome Message” – pierwszą wiadomość wypowiadaną do dzwoniącego.
  1. W zakładce „Agent Instructions” (Instrukcje agenta): Twoje instrukcje zachowania AI („AI Behaviour Instructions”) zostały wstępnie skonfigurowane; jeśli jednak zajdzie taka potrzeba, przycisk „Customize Prompt” (Dostosuj prompt) pozwala na doprecyzowanie tonu, granic polityki firmy oraz zasad „co robić / czego nie robić”.
  2. W zakładce „Block Spam Calls” (Blokuj połączenia spam):
  • Ochrona przed spamem („Spam Protection”) jest domyślnie włączona.
  • Możesz dostosować sekcję „What Counts as Spam” (Co uznaje się za spam), aby zdefiniować, co oznacza spam lub oszustwo (Fraud) i jakie działanie podjąć:
  1. End Call (Zakończ połączenie).
  2. Transfer To (Przełącz do) – do menedżera lub osoby weryfikującej.
  3. Send screening summary + disconnect (Wyślij podsumowanie weryfikacji + rozłącz).
  1. W zakładce „Call Routing” (Kierowanie połączeń - tylko Recepcjonista):

  • Dodaj reguły zachowania routingu („Routing Behaviour”), aby Twój Agent AI mógł inteligentnie kierować połączenia i czaty do różnych miejsc docelowych na podstawie opisu.
  1. Przykładowo, jeśli dzwoniący powie: „Pojawia mi się błąd 404”, Agent AI może zaklasyfikować to jako połączenie wsparcia i przełączyć je do miejsca docelowego z opisem typu „W przypadku błędów HTTP przełączaj tutaj”.
  2. Możesz utworzyć wiele wpisów routingu, ale unikaj nadmiernego pokrywania się ich zakresów, aby zapewnić dokładność kierowania.
  • Jeśli włączysz „Allow Extension Routing by Name” (Zezwalaj na kierowanie po nazwisku), Agent AI pozwoli dzwoniącym prosić o przełączenie po nazwisku, np. „Proszę mnie połączyć z Jerzym”.
  • Przy włączonym trybie poufności („Confidentiality Mode”):
  1. zapobiega to ujawnianiu przez AI poufnych informacji, takich jak nazwiska i dane pracowników;
  2. pamiętaj, że jeśli połączysz to z funkcją „Allow Extension Routing by Name”, Agent AI nie będzie mógł na przykład zapytać: „Mamy dwóch Jerzych: Jerzy Kowalski i Jerzy Nowak, z którym chcesz się połączyć?”, ale poprosi dzwoniącego o podanie pełnego imienia i nazwiska miejsca docelowego.
  1. W zakładce „Call Screening” (Weryfikacja połączeń):
  • Opcja „Disable Call Screening for Known Contacts” (Wyłącz weryfikację dla znanych kontaktów) rozluźnia proces filtrowania dla znanych, zaufanych kontaktów zapisanych w książce telefonicznej.
  • Możesz włączyć pole wyboru „Busy Check Before Call Transfer” (Sprawdzenie zajętości przed przełączeniem), aby upewnić się, że docelowy numer wewnętrzny jest dostępny przed przełączeniem rozmowy.
  1. W zakładce „Options” (Opcje):
  • Sekcja „Caller Response Actions” (Działania na odpowiedzi dzwoniącego) dotyczy dwóch konkretnych typów problematycznych dzwoniących:
  1. Rozmówców agresywnych lub obelżywych.
  2. Rozmówców niewspółpracujących, którzy utrudniają konwersację.
  • Można skonfigurować odpowiednie działania, aby automatycznie zarządzać takimi sytuacjami.

Uwagi techniczne

  • Kodek audio: Obsługiwany jest wyłącznie PCMU.
  • Konfiguracja sieci / zapory sieciowej (Firewall):
  • Upewnij się, że narzędzie „Firewall Checker” nie wykazuje żadnych błędów.
  • Musisz również zezwolić na ruch wychodzący dla:
  • TCP 443 (HTTPS)
  • UDP 3478 (STUN/TURN)
  • Uwaga dotycząca modeli AI:
  • OpenAI stale aktualizuje swoje modele; gdy pojawiają się nowe i ulepszone wersje, starsze stają się przestarzałe (deprecated). Informacje w tym dokumencie będą od czasu do czasu aktualizowane, aby nadążyć za aktualnie zalecanymi opcjami. Musisz upewnić się, że Twoje konto OpenAI jest skonfigurowane tak, aby pozwalało na używanie nowszych modeli przez 3CX.
  • Nowe wydania 3CX będą automatycznie aktualizować skonfigurowane modele do ich nowszych odpowiedników.


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 26 maja 2026 r.
https://www.3cx.pl/docs/konfiguracja-agenta-ai/