
Eleven v3 (알파), 이제 API에서 사용 가능
- 카테고리
- ElevenAPI
- 날짜
ElevenLabs를 활용해 리액트 앱에서 실시간 산타클로스 AI 보이스 에이전트를 만들어보세요. 이 빠른 단계별 가이드를 따라 WebRTC와 ElevenLabs Agents Platform으로 즐겁고 완전히 상호작용 가능한 연말 보이스 경험을 구현할 수 있습니다.
이번 연말 시즌, 앱에 산타를 추가해보세요.
ElevenLabs Agents 플랫폼과 @elevenlabs/react SDK만 있으면 몇 분 만에 리액트 앱에 산타클로스 보이스 에이전트를 추가할 수 있습니다. 이 가이드에서는 다음을 진행합니다:
을 선택하세요. 사이드바에서 Agents, 지식 베이스, 도구, 그리고 보이스가 “Build” 섹션 아래에 보입니다.
이제 산타처럼 행동하고 산타 목소리로 말하는 에이전트를 만들어보겠습니다.
이름을 산타로 지정하세요.
시스템 프롬프트란에 아래 내용을 붙여넣으세요:
첫 메시지를 다음과 같이 설정하세요:
호호호! 메리 크리스마스, 친구야. 이름이 뭐니?
통화가 시작되면 사용자가 듣게 되는 메시지입니다.
목소리 섹션에서:
MDLAMJ0jxkpYkjXbmG4t이제 산타가 실제로 산타처럼 들립니다.
이 예시에서는 오픈 상태로 유지합니다:
첫 데모에서는 인증 활성화를 꺼둬도 괜찮으니 누구나 에이전트에 제한 없이 연결할 수 있습니다. 온보딩이 빠르고, 빠른 프로토타입, 해커톤, 내부 시연에 적합합니다.
하지만 운영 환경이나 외부에서 접근 가능한 앱에서는 절대 에이전트를 오픈 상태로 두면 안 됩니다. 대신 ElevenLabs의 토큰 엔드포인트를 사용해 각 사용자 세션마다 단기, 범위 제한 액세스 토큰을 발급하세요. 이를 통해 누가 연결할 수 있는지, 접근 기간, 사용자가 할 수 있는 행동을 완전히 제어할 수 있습니다. 인증을 활성화하면 무단 통화, 오남용, 의도치 않은 사용을 방지할 수 있으니, 실제 서비스 전에는 꼭 권장합니다.
에이전트 페이지 상단에서 에이전트 ID 필드를 볼 수 있습니다.
이 값을 꼭 기록해두세요 — 나중에 리액트 컴포넌트에 붙여넣을 예정입니다:
리액트 / Next.js 프로젝트에서 ElevenLabs 리액트 SDK를 설치하세요:
설치가 완료되면 useConversation 훅을 사용해 음성 통화를 시작하거나 종료할 수 있습니다.
새 컴포넌트(예: CallSantaButton.tsx)를 만들고 아래 코드를 붙여넣으세요:
이제 교체 "<AGENT_ID>"를 대시보드에서 복사한 실제 에이전트 ID로 바꿔주세요.
그리고 UI 내 원하는 위치에 버튼을 렌더링하세요. 예시:
브라우저에서 열고 통화 시작:
이후 산타가 이름, 소원, 올해 착한 일을 물어봅니다.
기본 기능이 잘 동작하면 다음과 같이 확장할 수 있습니다:
하지만 핵심 통합은 단순합니다:
agentIduseConversation 훅과 버튼 하나이것만으로 리액트 앱에 실시간 산타 대화의 마법을 더할 수 있습니다.


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