几分钟内将圣诞老人语音智能体接入 React 应用
- 发布时间
这个假期,把圣诞老人带进应用。
使用 ElevenLabs 智能体平台 和 @elevenlabs/react SDK,只需几分钟即可将圣诞老人语音智能体接入 React 应用。本指南将带你:
- 在 ElevenLabs 控制台创建圣诞老人智能体
- 用 WebRTC 在 React 组件中接入
- 添加一个简单的“呼叫圣诞老人”按钮
1. 注册并打开 Agents Platform
- 注册 / 登录 ElevenLabs。
- 在左侧边栏,打开 平台切换器(顶部)。
- 选择 智能体平台.
你会看到侧边栏,包含 智能体, 知识库, 工具 和 音色(在“构建”分区下)。
2. 创建圣诞老人智能体
接下来创建一个行为和声音都像圣诞老人的智能体。
- 在侧边栏点击 智能体.
- 点击 + 新建智能体.
- 选择 空白智能体,从零开始。
命名为:Santa。
系统提示词
在 系统提示词 字段粘贴以下内容:
首条消息
将 首条消息 设置为:
嗨嗨嗨!圣诞快乐,朋友。告诉我,你叫什么名字?
用户开始通话时会听到这句话。
音色
在 音色 部分:
- 选择 “Jerry B. – 圣诞老人”
- 音色 ID:
MDLAMJ0jxkpYkjXbmG4t
现在圣诞老人会真正听起来像圣诞老人了。
安全
本示例保持开放:
- 在 安全 下,确保 启用身份验证 为 关闭.
首次演示时,保持 启用身份验证 关闭即可,任何人都能无门槛接入智能体。这样上手更快,适合原型、黑客松或内部演示。
但对于任何生产环境或对外应用,绝不能让智能体保持开放。应使用 ElevenLabs 令牌端点 为每个用户会话生成短时限、限定权限的访问令牌。这样可完全控制谁能接入、访问时长及可执行操作。启用身份验证可防止未授权访问、滥用或超出预期范围的使用——上线前强烈建议开启。
3. 获取智能体 ID
在智能体页面顶部可看到 智能体 ID 字段。
记下该值,稍后会粘贴到 React 组件中:
4. 安装 React SDK
在 React / Next.js 项目中安装 ElevenLabs React SDK:
安装完成后,即可使用 useConversation hook 发起和结束语音通话。
5. 添加“呼叫圣诞老人”按钮
新建一个组件,如 CallSantaButton.tsx,并粘贴如下代码:
现在替换 "<AGENT_ID>" 为刚才从控制台复制的实际智能体 ID。
然后在界面合适位置渲染该按钮,例如:
6. 试用效果
在浏览器中打开并点击 开始通话:
- 浏览器会请求 麦克风权限.
- 将与圣诞老人智能体建立 WebRTC 会话。
- 你会听到:
“嗨嗨嗨!圣诞快乐,朋友。告诉我,你叫什么名字?”
接下来,圣诞老人会询问姓名、心愿单,以及今年做了哪些好事。
下一步可以做什么
基础功能跑通后,你可以:
- 用身份验证限制访问(通过智能体安全设置)
- 切换语言(传递用户语言,让提示词自动适配)
- 自定义界面(自定义按钮、动画或完整“呼叫圣诞老人”界面)
但核心集成其实只需:
- Agents Platform 中一个智能体智能体平台
- 一个
agentId - 一个
useConversationhook 和一个按钮
这样就能把实时对话的圣诞老人体验带进 React 应用了。


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