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

快速开始

5 分钟创建你的第一个 AI 助手。

概述

本指南将帮助你快速创建一个能够进行语音对话的智能助手。你可以选择通过控制台或 API 两种方式创建。

前提条件

• 已部署 AI Video Assistant 服务
• 已配置至少一个 LLM 模型
• 已配置至少一个 TTS 语音

选择创建方式

方式	适用场景	复杂度
通过控制台	快速体验、可视化配置	简单
通过 API	程序化创建、批量管理	中等

---

方式一：通过控制台创建

步骤 1：创建助手

1. 登录控制台，进入 助手管理 页面
2. 点击 新建助手
3. 输入助手名称，如 "客服助手"

步骤 2：配置提示词

在 全局设置 中配置系统提示词：

你是一个友好的客服助手。你的任务是帮助用户解答问题。

要求：
- 保持友好和专业的语气
- 回答要简洁明了
- 如果不确定答案，请如实告知

步骤 3：配置语音

在 语音配置 中：

1. 选择 TTS 引擎
2. 选择合适的音色
3. 调整语速为 1.0

步骤 4：测试助手

1. 点击 保存
2. 点击 测试 按钮
3. 输入 "你好，你能做什么？"
4. 验证回复是否符合预期

步骤 5：发布助手

1. 确认测试通过后，点击 发布
2. 复制生成的 assistant_id

---

方式二：通过 API 创建

步骤 1：创建助手

curl -X POST "http://localhost:8080/api/v1/assistants" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "客服助手",
    "prompt": "你是一个友好的客服助手。",
    "language": "zh-CN",
    "temperature": 0.7
  }'

步骤 2：配置语音

curl -X PATCH "http://localhost:8080/api/v1/assistants/{assistant_id}" \
  -H "Content-Type: application/json" \
  -d '{
    "voice": {
      "vendor": "aliyun",
      "voice_id": "xiaoyun",
      "speed": 1.0
    }
  }'

步骤 3：测试连接

const ws = new WebSocket('ws://localhost:8000/ws?assistant_id=YOUR_ASSISTANT_ID');

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: 'session.start',
    audio: {
      encoding: 'pcm_s16le',
      sample_rate_hz: 16000,
      channels: 1
    }
  }));
};

ws.onmessage = (event) => {
  console.log('收到消息:', event.data);
};

---

下一步

恭喜！你已成功创建了第一个 AI 助手。接下来可以：

• 配置知识库 - 让助手回答专业问题
• 添加工具 - 扩展助手能力
• 查看 API 文档 - 深入了解协议细节
• 部署到生产环境 - 正式上线