AI-VideoAssistant/docs/content/quickstart/dashboard.md

通过控制台创建助手

本指南详细介绍如何通过 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 地址：用于实时对话

嵌入到网页

发布后，你可以将助手嵌入到你的网站：

<!-- 添加到你的网页 -->
<script>
  const ws = new WebSocket('ws://your-server/ws?assistant_id=YOUR_ASSISTANT_ID');
  // ... 实现对话逻辑
</script>

详细集成指南请参考 API 参考。

常见问题

助手不回复？

1. 检查 LLM 模型是否配置正确
2. 查看浏览器控制台是否有错误
3. 确认后端服务正常运行

语音无法播放？

1. 检查浏览器是否允许自动播放
2. 确认 TTS 配置正确
3. 检查音量设置

下一步

• 通过 API 创建助手
• 配置知识库
• 添加工具