# 通过控制台创建助手

本指南详细介绍如何通过 Web 控制台创建和配置 AI 助手。

## 步骤 1：登录控制台

1. 打开浏览器访问控制台地址（如 `http://localhost:3000`）
2. 使用账号密码登录

## 步骤 2：创建助手

![创建助手](../images/assistants.png)

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)