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.
Z ElevenLabs Platforma Agents i @elevenlabs/react SDK możesz dodać agenta głosowego Mikołaja do swojej aplikacji React w kilka minut. W tym przewodniku:
- Stworzysz agenta Mikołaja w panelu ElevenLabs
- Połączysz go w komponencie React z użyciem WebRTC
- Dodasz prosty przycisk „Zadzwoń do Mikołaja”
1. Zarejestruj się i otwórz Agents Platform
- Zarejestruj się / zaloguj do ElevenLabs.
- W lewym menu otwórz przełącznik platformy na górze.
- Wybierz Platforma Agents.
Powinieneś zobaczyć menu z sekcjami: Agenci, Baza wiedzy, Narzędzia, oraz Głosy w sekcji „Build”.
2. Stwórz swojego agenta Mikołaja
Teraz stworzymy agenta, który zachowuje się jak Mikołaj i mówi głosem Mikołaja.
- W menu kliknij Agenci.
- Kliknij + Nowy agent.
- Wybierz Pusty agent, żeby zacząć od zera.
Nazwij go: Santa.
Prompt systemowy
W polu Prompt systemowy wklej poniższy tekst:
Pierwsza wiadomość
Ustaw Pierwsza wiadomość na:
Ho, ho, ho! Wesołych Świąt, przyjacielu. Jak masz na imię?
To usłyszą użytkownicy na początku rozmowy.
Głos
W sekcji Głos:
- Wybierz „Jerry B. – Santa Claus”
- ID głosu:
MDLAMJ0jxkpYkjXbmG4t
Teraz Mikołaj naprawdę będzie brzmiał jak Mikołaj.
Zabezpieczenia
W tym przykładzie zostawiamy wszystko otwarte:
- W sekcji Zabezpieczenia upewnij się, że Włącz uwierzytelnianie jest wyłączone.
Na pierwsze demo możesz spokojnie zostawić Włącz uwierzytelnianie wyłączone, żeby każdy mógł połączyć się z agentem bez ograniczeń. Dzięki temu szybciej przetestujesz rozwiązanie — idealne na szybkie prototypy, hackathony czy prezentacje wewnętrzne.
Ale w przypadku produkcji lub aplikacji dostępnej z zewnątrz nigdy nie zostawiaj agenta otwartego. Zamiast tego użyj w ElevenLabs Endpoint tokena, żeby generować krótkotrwałe, ograniczone tokeny dostępu dla każdej sesji użytkownika. Dzięki temu masz pełną kontrolę, kto się łączy, jak długo ma dostęp i co może zrobić. Włączenie uwierzytelniania chroni agenta przed nieautoryzowanymi połączeniami, nadużyciami czy użyciem poza twoimi limitami — i jest mocno zalecane przed uruchomieniem na produkcji.
3. Skopiuj Agent ID
Na górze strony agenta zobaczysz pole ID agenta.
Zapisz tę wartość — wkleisz ją później do komponentu React:
4. Zainstaluj React SDK
W swoim projekcie React / Next.js zainstaluj ElevenLabs React SDK:
Teraz możesz użyć hooka useConversation, żeby rozpocząć i zakończyć rozmowę głosową.
5. Dodaj przycisk „Zadzwoń do Mikołaja”
Stwórz nowy komponent, np. CallSantaButton.tsx, i wklej ten kod:
Teraz zamień "<AGENT_ID>" na prawdziwy Agent ID, który skopiowałeś z panelu.
Następnie wyświetl przycisk gdzieś w swoim UI, np.:
6. Przetestuj
Otwórz aplikację w przeglądarce i kliknij Rozpocznij rozmowę:
- Przeglądarka poprosi o zgodę na mikrofon.
- Rozpocznie się sesja WebRTC z twoim agentem Mikołajem.
- Usłyszysz:
„Ho, ho, ho! Wesołych Świąt, przyjacielu. Jak masz na imię?”
Potem Mikołaj zapyta cię o imię, listę życzeń i co zrobiłeś w tym roku, żeby trafić na Listę Grzecznych.
Co dalej?
Gdy podstawy działają, możesz:
- Zabezpieczyć dostęp do Mikołaja przez ustawienia Security agenta
- Zmienić język przekazując locale użytkownika i obsługując to w promptach
- Dopasować wygląd UI dodając własne przyciski, animacje lub cały ekran „Zadzwoń do Mikołaja”
Ale cała integracja to tylko:
- Jeden agent w Platforma Agents
- Jeden
agentId - Hook
useConversationi przycisk
To wszystko, czego potrzebujesz, żeby dodać rozmowy z Mikołajem na żywo do swojej aplikacji React.


.webp&w=3840&q=80)
.webp&w=3840&q=80)
