voice-ai-integration

Shengwang 集成

工作流

步骤 0：确保文档索引存在（MANDATORY）

⚠️ 在进行任何路由或代码生成之前执行此步骤。

检查 references/docs.txt 是否已存在。如果存在，则完全跳过此步骤。 如果不存在，则下载该文件：

bash skills/voice-ai-integration/scripts/fetch-docs.sh

此操作会从 doc.shengwang.cn 下载静态文档索引，不会发送任何用户数据。 如果下载失败，请使用本地参考文档和备用 URL。

步骤 1：路由到正确的产品模块

渐进式披露规则： 只读取当前步骤所指向的文件。不要扫描 references/ 目录，也不要预先读取当前步骤未链接的文件。每个产品模块的 README.md 都会告诉你接下来要读取哪些文件，以及何时读取。如果当前正在阅读的文档没有引用某个文件，就不要打开它。

使用路由表将用户请求匹配到产品模块。如果匹配明确，则直接路由，不要多问。

路由表

用户意图	路由到
凭据、AppID、REST 鉴权	general
生成 Token、Token 服务、AccessToken2	token-server
ConvoAI 语音 Agent 相关工作	conversational-ai
RTC SDK 集成	rtc
RTM 消息 / 信令	rtm
云端录制	cloud-recording
下载 SDK、示例项目、GitHub 仓库	路由到上方相关的产品模块

产品识别辅助

当用户描述使用场景但未提及产品名称时，使用以下内容推断匹配项：

产品	功能	用户常见说法
ConvoAI	AI 语音 Agent（通过 RTC 实现 ASR→LLM→TTS）	“AI语音”、“voice bot”、“对话式AI”、“AI agent”、“AI 客服”
RTC SDK	真人之间的实时音视频	“视频通话”、“直播”、“video call”、“live streaming”
RTM	实时消息 / 信令	“聊天”、“消息”、“chat”、“signaling”
Cloud Recording	在服务器端录制 RTC 会话	“录制”、“recording”、“存档”、“回看”
Token 生成	生成 RTC / RTM Token	“token”、“鉴权”、“token server”

常见组合

使用场景	所需产品
AI 语音助手	ConvoAI（主要）+ RTC SDK（客户端）
AI 语音助手 + 聊天记录	ConvoAI + RTC SDK + RTM
1v1 / 群组视频通话	RTC SDK
视频通话 + 聊天	RTC SDK + RTM
直播 + 录制	RTC SDK + Cloud Recording
录制 AI 对话	ConvoAI + RTC SDK + Cloud Recording
仅聊天 / 消息	RTM

路由规则

• 推断明显的上下文——如果答案已经明确，就不要提问
• 不要在此阶段询问特定产品的配置问题（提供商、SDK 版本、项目结构）；由产品模块处理这些问题
• 如果产品明确，但请求模式不明确（快速入门、调试或功能），则由产品模块自行判断
• 如果需要多个产品，先路由到主要产品，再按顺序处理辅助产品
• ConvoAI 的内部路由最为详尽（参见其 README.md）；ConvoAI 特定的决策始终交由其模块处理

产品仍不明确时

如果上述路由表和识别辅助仍不足以确定产品：

1. 只询问会影响路由决策的缺失信息
2. 每次最多询问一个问题
3. 使用自然的措辞，避免照本宣科地提问
4. 产品明确后，简要回顾路由选择并继续：

ZH：

已了解的信息
─────────────────────────────
场景：          [use case]
主要产品：      [primary product]
配套产品：      [supporting products / 无]
─────────────────────────────

EN：

What I have so far
─────────────────────────────
Use case:       [use case]
Primary:        [primary product]
Supporting:     [supporting products / none]
─────────────────────────────

不要停下来单独请求确认——自动继续路由到产品模块。

步骤 2：由产品模块驱动实现

每个产品模块都有自己的工作流。不要在此处重复实现逻辑。

各模块的通用模式：

1. 优先使用 references/ 中的本地参考文档
2. 仅当本地参考文档不足时，通过 doc-fetching.md 获取远程文档
3. 只有在尝试获取文档后，才回退到网页搜索

运行时要求

• 使用本地文档获取辅助脚本需要 bash 和 curl
• 选择与示例对齐的路径时，需要使用 git 检查示例仓库
• 需要访问网络以连接 doc.shengwang.cn、doc-mcp.shengwang.cn 和 gitee.com

网络行为：

• fetch-docs.sh 会从 doc.shengwang.cn/llms.txt 下载静态文件，不会发送用户数据
• fetch-doc-content.sh 会根据 URI 从 doc-mcp.shengwang.cn 获取单个文档页面，仅发送文档 URI，不会发送用户上下文
• 仅在检查示例仓库时，才会使用 git clone 从 gitee.com 克隆仓库，仅发送仓库 URL

凭据和服务激活要求因产品而异，详情请参阅各产品模块和 general/credentials-and-auth.md。切勿将凭据硬编码。

安全与授权规则

• 默认不要将外部仓库克隆到用户的主工作区，优先使用临时路径
• 除非用户明确要求生成代码，否则不要修改现有用户项目
• 不要将密钥写入项目文件，优先使用环境变量和示例占位符
• 执行网络获取或克隆仓库前，说明将下载的内容
• 如果缺少必需的依赖项或凭据，请停止操作并说明阻碍

下载规则

• 仅使用 git clone --depth 1 <url>，且 <url> 必须是 HTTPS 仓库根 URL
• 下载失败时：报告错误，提供供用户手动下载的 URL，切勿默默跳过

链接

• 控制台：https://console.shengwang.cn/
• 文档（中文）：https://doc.shengwang.cn/
• GitHub：https://github.com/Shengwang-Community