150 lines
3.6 KiB
Markdown
150 lines
3.6 KiB
Markdown
# 通过控制台创建助手
|
||
|
||
本指南详细介绍如何通过 Web 控制台创建和配置 AI 助手。
|
||
|
||
## 步骤 1：登录控制台
|
||
|
||
1. 打开浏览器访问控制台地址（如 `http://localhost:3000`）
|
||
2. 使用账号密码登录
|
||
|
||
## 步骤 2：创建助手
|
||
|
||
|
||
|
||
1. 在左侧导航栏点击 **助手管理**
|
||
2. 点击右上角 **新建助手** 按钮
|
||
3. 在弹出的对话框中输入：
|
||
- **助手名称**：为你的助手起一个名字，如 "产品咨询助手"
|
||
- **描述**：简单描述助手的用途（可选）
|
||
|
||
4. 点击 **创建**
|
||
|
||
## 步骤 3：配置基本设置
|
||
|
||
创建完成后，你将进入助手配置页面。
|
||
|
||
### 全局设置
|
||
|
||
| 配置项 | 建议值 | 说明 |
|
||
|-------|--------|------|
|
||
| 系统提示词 | 见下方示例 | 定义助手的角色和行为 |
|
||
| 开场白 | "你好，我是产品咨询助手，请问有什么可以帮您？" | 对话开始时的问候 |
|
||
| 温度 | 0.7 | 平衡创意和准确性 |
|
||
|
||
### 系统提示词示例
|
||
|
||
```
|
||
你是一个专业的产品咨询助手。你的主要任务是：
|
||
|
||
1. 解答用户关于产品功能的问题
|
||
2. 提供使用建议和最佳实践
|
||
3. 帮助用户解决常见问题
|
||
|
||
请注意：
|
||
- 保持友好和专业的语气
|
||
- 回答简洁明了，避免冗长
|
||
- 如果不确定答案，请如实告知并建议联系人工客服
|
||
- 不要编造不存在的功能或信息
|
||
```
|
||
|
||
## 步骤 4：配置语音
|
||
|
||
切换到 **语音配置** 标签页：
|
||
|
||
### TTS 设置
|
||
|
||
1. **选择 TTS 引擎**
|
||
- 阿里云：多音色、高自然度
|
||
- 火山引擎：低延迟
|
||
- Minimax：高性价比
|
||
|
||
2. **选择音色**
|
||
- 根据助手定位选择合适的声音
|
||
- 建议先试听再确定
|
||
|
||
3. **调整参数**
|
||
- 语速：1.0（正常速度）
|
||
- 音量：80%
|
||
- 音调：1.0
|
||
|
||
### ASR 设置
|
||
|
||
1. **选择 ASR 引擎**
|
||
- Whisper：通用识别
|
||
- SenseVoice：中文识别更准
|
||
|
||
2. **设置语言**
|
||
- 选择 "中文" 或 "自动检测"
|
||
|
||
## 步骤 5：关联知识库（可选）
|
||
|
||
如果你已创建知识库，可以在 **知识** 标签页进行关联：
|
||
|
||
1. 点击 **添加知识库**
|
||
2. 选择要关联的知识库
|
||
3. 设置检索参数：
|
||
- 相似度阈值：0.7
|
||
- 返回数量：3
|
||
|
||
## 步骤 6：测试助手
|
||
|
||
1. 点击页面右上角的 **保存** 按钮
|
||
2. 点击 **测试** 按钮打开测试面板
|
||
3. 进行对话测试：
|
||
|
||
**测试用例建议：**
|
||
|
||
| 测试类型 | 示例问题 |
|
||
|---------|---------|
|
||
| 基础问候 | "你好" |
|
||
| 功能询问 | "你能做什么？" |
|
||
| 业务问题 | "产品有哪些功能？" |
|
||
| 边界测试 | "帮我写一首诗" |
|
||
|
||
4. 检查回复是否符合预期
|
||
5. 如有问题，返回修改配置
|
||
|
||
## 步骤 7：发布助手
|
||
|
||
测试通过后：
|
||
|
||
1. 点击 **发布** 按钮
|
||
2. 确认发布
|
||
3. 复制生成的信息：
|
||
- `assistant_id`：用于 API 调用
|
||
- WebSocket 地址：用于实时对话
|
||
|
||
## 嵌入到网页
|
||
|
||
发布后，你可以将助手嵌入到你的网站：
|
||
|
||
```html
|
||
<!-- 添加到你的网页 -->
|
||
<script>
|
||
const ws = new WebSocket('ws://your-server/ws?assistant_id=YOUR_ASSISTANT_ID');
|
||
// ... 实现对话逻辑
|
||
</script>
|
||
```
|
||
|
||
详细集成指南请参考 [API 参考](../api-reference/websocket.md)。
|
||
|
||
## 常见问题
|
||
|
||
### 助手不回复？
|
||
|
||
1. 检查 LLM 模型是否配置正确
|
||
2. 查看浏览器控制台是否有错误
|
||
3. 确认后端服务正常运行
|
||
|
||
### 语音无法播放？
|
||
|
||
1. 检查浏览器是否允许自动播放
|
||
2. 确认 TTS 配置正确
|
||
3. 检查音量设置
|
||
|
||
## 下一步
|
||
|
||
- [通过 API 创建助手](api.md)
|
||
- [配置知识库](../customization/knowledge-base.md)
|
||
- [添加工具](../customization/tools.md)
|