如何为 React Native 应用添加 AI 聊天
安装 Sell Whisper AI React Native SDK,用您的 Widget ID 创建客户端,并在您的 iOS 和 Android 应用中渲染聊天界面。
步骤
按顺序完成
安装软件包
从 npm 添加 @sellwhisper/chat-client 和 @sellwhisper/react-native。SDK 支持 React Native 0.73 或更高版本、Expo SDK 53 或更高版本、iOS 15.1 或更高版本,以及 Android API 级别 24 或更高版本。
复制您的 Widget ID
在控制台中打开智能体,进入“部署”(Deploy),打开该智能体的聊天组件。组件设置中的 Widget ID 就是网站嵌入代码使用的那一个,因此应用与网站共用同一个智能体和同一套组件设置。
创建客户端并包裹您的应用
用 Widget ID 和一个存储适配器(例如 AsyncStorage)创建 SellWhisperClient,这样对话可以在两次启动之间保留;然后用 SellWhisperProvider 包裹您的应用。
渲染聊天界面
在需要显示聊天的位置添加 SellWhisperChatScreen。通过它的属性(props)可以开启标题栏、对话历史、附件和语音消息;附件和语音消息需要安装可选的选择器和音频软件包。
两个软件包
| 软件包 | 用途 |
|---|---|
@sellwhisper/chat-client | 无界面客户端:对话、消息和事件,不依赖 React Native |
@sellwhisper/react-native | 面向 React Native 和 Expo 的 provider、hooks 和现成的聊天界面 |
要使用现成的聊天界面,请安装这两个软件包。要构建自己的界面,只安装客户端即可。
应用与您的网站共用什么
应用使用与网站嵌入代码相同的 Widget ID 进行连接。这意味着同一个智能体、同一个知识库和同一套升级规则,而且对智能体知识或指令的更改无需发布新版本就能在应用中生效。
可选功能及其所需条件
| 功能 | 所需条件 |
|---|---|
| 两次启动之间保留对话历史 | 存储适配器,例如 AsyncStorage |
| 附件 | 图片或文档选择器软件包 |
| 语音消息 | 录音软件包 |
| 语音助手 | 音频软件包和开发构建;无法在 Expo Go 中运行 |
| 推送通知 | 在您的应用中设置好推送,并通过 SDK 注册设备 |
发布之前
- 在真机上测试。 在真实的 iOS 和 Android 设备上运行您的构建版本,而不只是在模拟器中。
- 先添加知识。 聊天界面有多大用处,取决于背后的智能体。请参阅如何用您的网站训练 AI 智能体。
- 设置升级。 与您团队的实时聊天在应用中同样可用;请参照如何将 AI 对话转交给人工确定它何时开始。
安装命令、组件属性和完整示例,请参阅 React Native SDK。
常见问题
常见问题
SDK 支持 Expo 吗?
支持,从 Expo SDK 53 起。语音助手需要使用开发构建,而不是 Expo Go。
可以构建我自己的聊天界面吗?
可以。@sellwhisper/chat-client 是一个无界面客户端,不依赖 React Native,因此您可以用它来驱动自己的组件。
在应用中可以升级给人工吗?
可以。升级后的对话会在同一界面上以实时聊天的形式继续,由您的团队接手。如果要在应用处于后台时触达用户,请在您的应用中设置推送通知,并通过 SDK 注册设备。