Dodaj agenta głosowego Świętego Mikołaja do swojej aplikacji React w kilka minut
- Opublikowano
PosłuchajPosłuchaj tego artykułu
W te święta dodaj Mikołaja do swojej aplikacji.
Dzięki Agents Platform od ElevenLabs i pakietowi @elevenlabs/react SDK możesz dodać agenta głosowego Świętego Mikołaja do aplikacji React w zaledwie kilka minut. W tym poradniku:
- Utworzysz agenta Mikołaja w panelu ElevenLabs
- Połączysz go z komponentem React przez WebRTC
- Dodasz prosty przycisk „Zadzwoń do Mikołaja”
1. Zarejestruj się i otwórz Agents Platform
- Zarejestruj się / zaloguj się w ElevenLabs.
- Na lewym pasku bocznym otwórz u góry przełącznik platformy.
- Wybierz Agents Platform.
Zobaczysz pasek boczny z pozycjami Agents, Knowledge Base, Tools i Voices w sekcji „Build”.
2. Utwórz agenta Mikołaja
Teraz utworzymy agenta, który zachowuje się jak Mikołaj i mówi jego głosem.
- Na pasku bocznym kliknij Agents.
- Kliknij + New Agent.
- Wybierz Blank Agent, aby zacząć od zera.
Nazwij go: Mikołaj.
Prompt systemowy
W polu System Prompt wklej poniższy tekst:
Pierwsza wiadomość
Ustaw First Message na:
Ho, ho, ho! Wesołych Świąt, mój przyjacielu. Powiedz, jak masz na imię?
To usłyszą użytkownicy po rozpoczęciu rozmowy.
Głos
W sekcji Voice:
- Wybierz „Jerry B. – Santa Claus”
- ID głosu:
MDLAMJ0jxkpYkjXbmG4t
Teraz Mikołaj będzie naprawdę brzmiał jak Mikołaj.
Zabezpieczenia
W tym przykładzie pozostawimy dostęp otwarty:
- W sekcji Security upewnij się, że Enable authentication jest wyłączone.
W pierwszym demo możesz spokojnie zostawić opcję Enable Authentication wyłączoną, aby każdy mógł bez ograniczeń połączyć się z agentem. Przyspiesza to rozpoczęcie pracy i sprawdza się w szybkich prototypach, projektach hackathonowych oraz prezentacjach wewnętrznych.
Jednak w każdej aplikacji produkcyjnej lub dostępnej z zewnątrz nigdy nie zostawiaj agenta otwartego. Zamiast tego użyj Token Endpoint ElevenLabs, aby generować krótkotrwałe tokeny dostępu o określonym zakresie dla każdej sesji użytkownika. Dzięki temu w pełni kontrolujesz, kto może się połączyć, jak długo trwa dostęp i jakie działania użytkownik może wykonywać. Włączenie uwierzytelniania chroni agenta przed nieautoryzowanymi połączeniami, nadużyciami i użyciem poza ustalonymi limitami — zdecydowanie zalecamy to przed wdrożeniem.
3. Skopiuj ID agenta
U góry strony agenta zobaczysz pole Agent ID.
Zapisz tę wartość — w kolejnym kroku wkleimy ją do komponentu React:
4. Zainstaluj React SDK
W projekcie React / Next.js zainstaluj React SDK ElevenLabs:
Teraz możemy użyć hooka useConversation do rozpoczynania i kończenia rozmów głosowych.
5. Dodaj przycisk „Zadzwoń do Mikołaja”
Utwórz nowy komponent, np. CallSantaButton.tsx, i wklej ten kod:
Teraz zastąp "<AGENT_ID>" rzeczywistym ID agenta skopiowanym z panelu.
Następnie wyrenderuj przycisk w dowolnym miejscu interfejsu, na przykład:
6. Wypróbuj
Otwórz aplikację w przeglądarce i kliknij Start Call:
- Przeglądarka poprosi o dostęp do mikrofonu.
- Rozpocznie się sesja WebRTC z agentem Mikołaja.
- Usłyszysz:
„Ho, ho, ho! Wesołych Świąt, mój przyjacielu. Powiedz, jak masz na imię?”
Potem Mikołaj zapyta o twoje imię, listę życzeń i to, co zrobiłeś w tym roku, by znaleźć się na Liście Grzecznych Dzieci.
Co dalej
Gdy podstawy już działają, możesz:
- Ograniczyć dostęp do Mikołaja uwierzytelnianiem w ustawieniach Security agenta
- Zmieniać języki przez przekazanie lokalizacji użytkownika i obsłużenie jej w prompcie
- Dostosować wygląd interfejsu własnymi przyciskami, animacjami lub pełnym ekranem „Zadzwoń do Mikołaja”
Podstawowa integracja to jednak tylko:
- Jeden agent w Agents Platform
- Jedno
agentId - Hook
useConversationi przycisk
Tyle wystarczy, by wnieść magię rozmów z Mikołajem w czasie rzeczywistym do aplikacji React.


