Jak zbudować agenta WhatsApp z OpenAI Agents SDK

OpenAI Agents SDK to otwartoźródłowy framework OpenAI do budowania agentów: model z instrukcjami, narzędziami, które może wywoływać, przekazaniami zadań do innych agentów i zabezpieczeniami wokół danych wejściowych i wyjściowych, wszystko uruchamiane w pętli, aż zadanie zostanie wykonane. To świetny sposób na zbudowanie agenta. Sam z siebie nie daje jednak numeru WhatsApp, skrzynki zespołu, wiadomości szablonowych ani sposobu, by człowiek mógł przejąć rozmowę. Z Agent Harness MonoChat wybierasz OpenAI Agents SDK jako AI Harness, umieszczasz węzeł Agent AI w przepływie, podłączasz WhatsApp i testujesz, a resztą zajmuje się MonoChat.

Ten poradnik opisuje, co daje SDK, trzy sposoby użycia agentów OpenAI w MonoChat, konfigurację krok po kroku oraz szczegóły specyficzne dla WhatsApp, które decydują o tym, czy klienci zaufają agentowi.

Co daje OpenAI Agents SDK

SDK opiera się na kilku podstawowych ideach:

• Agenci: model plus instrukcje opisujące jego zadanie.
• Narzędzia: funkcje, które agent może wywoływać, takie jak „sprawdź zamówienie” lub „sprawdź wolny termin”, a także serwery MCP.
• Przekazania zadań (handoffs): jeden agent przekazuje zadanie innemu, wyspecjalizowanemu w nim, na przykład od ogólnego agenta obsługi do agenta zwrotów.
• Zabezpieczenia (guardrails): kontrole działające obok agenta, które powstrzymują niechciane dane wejściowe lub wyjściowe.
• Sesje i śledzenie: pamięć między turami i zapis tego, co agent zrobił, krok po kroku.

Razem tworzy to agent harness: pętlę, która pozwala modelowi działać, sprawdzać swoją pracę i kontynuować, zamiast odpowiadać jednorazowo. W komunikacji z klientami to różnica między wyjaśnieniem zasad zwrotów a faktycznym utworzeniem zwrotu.

Co WhatsApp dodaje do problemu

Zbudowanie agenta to połowa pracy. Postawienie go przed klientami na WhatsApp oznacza obsługę:

• WhatsApp Business Platform. Oficjalne połączenie API, zweryfikowana firma i zatwierdzony numer.
• Okno 24 godzin. Odpowiedzi w dowolnej formie są dozwolone w ciągu 24 godzin od ostatniej wiadomości klienta; potem potrzebny jest zatwierdzony szablon.
• Polityka. Od 15 stycznia 2026 roku WhatsApp wyklucza z platformy ogólnych asystentów AI. Agent obsługujący Twoich własnych klientów jest dozwolony, a przy automatycznych odpowiedziach oczekiwana jest jasna droga do człowieka.
• Ludzie. Niektóre rozmowy muszą trafić do człowieka, z zachowaną historią, w narzędziu, którego Twój zespół już używa.
• Inne kanały. Klienci piszący na Instagramie, Messengerze lub Twojej stronie oczekują tych samych odpowiedzi.

MonoChat obsługuje to wszystko wokół agenta, więc Twoja praca koncentruje się na samym agencie.

Trzy sposoby użycia agentów OpenAI w MonoChat

Opcja	Gdzie działa	Czego potrzebujesz
OpenAI Agents SDK	Wewnątrz MonoChat	Niczego dodatkowego; korzysta z Twoich modeli AI
OpenAI Agents API (hostowany przez OpenAI)	Chmura OpenAI	Twój klucz API OpenAI
Niestandardowy (Twoja własna usługa Agents SDK)	Twój własny serwer	Adres URL endpointu i wspólny sekret

Zacznij od harnessu OpenAI Agents SDK, jeśli chcesz agenta w stylu OpenAI bez wdrażania czegokolwiek. Wybierz OpenAI Agents API, jeśli Twoi agenci już działają na hostowanej platformie OpenAI. Wybierz Niestandardowy, jeśli Twoi programiści napisali własnego agenta z użyciem SDK, z własnymi narzędziami, przekazaniami zadań i testami, i chcą nadal uruchamiać ten kod; zobacz jak podłączyć własnego agenta AI do WhatsApp.

Krok po kroku: agent OpenAI Agents SDK na WhatsApp

1. Dodaj AI Harness

Dodaj AI Harness w MonoChat i wybierz OpenAI Agents SDK jako dostawcę. Działa wewnątrz MonoChat i korzysta z modeli AI, które już skonfigurowałeś, więc na tym kroku nie potrzebujesz dodatkowych kluczy ani serwerów.

2. Dodaj węzeł Agent AI do przepływu

W przepływie odbierającym Twoje rozmowy z WhatsApp dodaj węzeł Agent AI i wybierz harness. Napisz instrukcje agenta: komu służy, co może robić, czego nigdy nie wolno mu robić i kiedy przekazuje rozmowę.

3. Wybierz model główny, zapasowy i szybki

Każdy węzeł Agent AI ma trzy role modeli:

• Model główny analizuje i pisze odpowiedzi.
• Model zapasowy przejmuje zadanie po przekroczeniu miękkiego limitu lub awarii.
• Model szybki obsługuje zadania w tle.

Dodaj limit budżetu na uruchomienie, aby jedna nietypowa rozmowa nie wygenerowała dużego rachunku. Nie wiesz, jak wybrać model zapasowy? Przeczytaj, dlaczego agent AI obsługujący klientów potrzebuje modelu zapasowego.

4. Podłącz swoje narzędzia

Daj agentowi narzędzia odpowiadające Twoim najczęstszym prośbom:

• Narzędzia funkcji AI do wywołań Twoich własnych API ze zdefiniowanymi danymi wejściowymi.
• Integracja MCP dla narzędzi z systemów zgodnych z MCP.
• Baza wiedzy AI dla odpowiedzi opartych na Twoich dokumentach i zasadach.
• Funkcje niestandardowe dla logiki wykonywanej w trakcie rozmowy.

Trzy dobre narzędzia są lepsze niż piętnaście słabo przetestowanych. Dodawaj kolejne, gdy zobaczysz prawdziwe rozmowy.

5. Podłącz WhatsApp (i całą resztę)

Podłącz swój numer WhatsApp Business przez MonoChat, oficjalnego partnera biznesowego Meta (Meta Business Partner). Ten sam przepływ może działać na Instagramie, Messengerze, TikToku, Telegramie, czacie na stronie, w SMS-ach i na kanale głosowym, więc jeden agent obsługuje każdy kanał.

6. Testuj na prawdziwych wiadomościach

Użyj rozmów z ostatniego miesiąca jako zestawu testowego. Uwzględnij te trudne: zdenerwowanych klientów, niejasne pytania, kilka próśb w jednej wiadomości, klienta, który od razu prosi o człowieka. Sprawdź wywołania narzędzi, ton i przekazywanie rozmów. Potem uruchom.

Wzorce, które dobrze działają na WhatsApp

Jedno pytanie na wiadomość. Agenci zbudowani do czatu w sieci mają tendencję do odpowiadania długimi listami. Na telefonie krótkie wiadomości i jedno wyraźne pytanie naraz dają lepsze odpowiedzi klientów.

Potwierdzaj przed działaniami nieodwracalnymi. Pozwól agentowi zaproponować, a klientowi potwierdzić, przed anulowaniem, zwrotem lub zmianą rezerwacji.

Specjaliści przez przekazania zadań, ludzie przez skrzynkę. Przekazania zadań w SDK świetnie nadają się do kierowania między agentami (sprzedaż, obsługa, zwroty). Przekazanie rozmowy człowiekowi należy do wspólnej skrzynki zespołu MonoChat, gdzie rozmowa trafia z pełną historią.

Instrukcje, które nazywają granice. „Zwroty do 50 € możesz zatwierdzić; powyżej tej kwoty przekaż rozmowę zespołowi rozliczeń.” Konkretne liczby są lepsze niż niejasne reguły.

Trzymaj się swojej firmy. Agent, który pomaga Twoim klientom, jest dozwolony na WhatsApp. Taki, który odpowiada na cokolwiek, ryzykuje naruszenie zasad WhatsApp z 2026 roku; nasz przewodnik po zasadach chatbotów AI na WhatsApp wyjaśnia, gdzie leży granica.

Koszty

Składają się na nie trzy rzeczy: Twój plan MonoChat, użycie modeli AI i opłaty Meta za wiadomości WhatsApp. Od 1 października 2026 roku Meta pobiera opłaty za odpowiedzi serwisowe po pierwszych 1000 miesięcznie na numer firmy; zobacz nasz przewodnik po cenniku WhatsApp API.

Po stronie AI MonoChat nie dolicza marży, gdy używasz własnych kluczy dostawców. Budżety na uruchomienie, tańszy model szybki do zadań w tle i niezawodny model zapasowy utrzymują przewidywalny rachunek.

Bez uzależnienia

Agent Harness pozwala wybrać framework, nie tylko model. Jeśli później zechcesz wypróbować Claude Agent SDK, Pi, Claude Managed Agents lub własny framework, dodaj kolejny AI Harness i wskaż go w węźle Agent AI. Twoje kanały, narzędzia i przekazywanie rozmów pozostają bez zmian. Porównaj wszystkich dostawców na stronie Agent Harness.