93 lines
2.2 KiB
Markdown
93 lines
2.2 KiB
Markdown
# Realtime Dialog External RAG Test
|
||
|
||
一个新的独立测试项目，参考 `realtime_dialog/java` 的实现方式，直接通过 WebSocket 接入实时对话服务，验证 `external_rag` 外接知识库输入是否能稳定产生音频回复。
|
||
|
||
## 能力
|
||
|
||
- 文本模式测试
|
||
- 麦克风模式测试
|
||
- 音频文件模式测试
|
||
- 原始音频播放
|
||
- 通过 `external_rag` 注入外接知识库内容
|
||
- 将服务端返回音频保存为 `output.pcm`
|
||
|
||
## 环境要求
|
||
|
||
- Java 8+
|
||
- Maven 3.8+
|
||
|
||
## 运行前准备
|
||
|
||
准备一个 JSON 文件，内容是数组，例如：
|
||
|
||
```json
|
||
[
|
||
{
|
||
"title": "公司介绍",
|
||
"content": "我们是一家专注于企业数字化服务的公司。"
|
||
},
|
||
{
|
||
"title": "核心产品",
|
||
"content": "核心产品包括智能客服平台、知识库系统和企业自动化工具。"
|
||
}
|
||
]
|
||
```
|
||
|
||
默认情况下，程序会自动尝试读取 `../../test2/server/.env`，并复用其中的：
|
||
|
||
- `VOLC_S2S_APP_ID`
|
||
- `VOLC_S2S_TOKEN`
|
||
|
||
也可以通过 `--test2-env` 显式指定路径。
|
||
|
||
## 常用命令
|
||
|
||
编译：
|
||
|
||
```bash
|
||
mvn clean package
|
||
```
|
||
|
||
文本模式：
|
||
|
||
```bash
|
||
mvn exec:java -Dexec.args="--mod=text --app_id=你的AppId --access_key=你的AccessKey --rag-file=sample_rag.json"
|
||
```
|
||
|
||
文本模式（直接复用 `test2/server/.env`）：
|
||
|
||
```bash
|
||
mvn exec:java -Dexec.args="--mod=text --rag-file=sample_rag.json"
|
||
```
|
||
|
||
麦克风模式：
|
||
|
||
```bash
|
||
mvn exec:java -Dexec.args="--app_id=你的AppId --access_key=你的AccessKey --rag-file=sample_rag.json"
|
||
```
|
||
|
||
音频文件模式：
|
||
|
||
```bash
|
||
mvn exec:java -Dexec.args="--audio=whoareyou.wav --app_id=你的AppId --access_key=你的AccessKey --rag-file=sample_rag.json"
|
||
```
|
||
|
||
## 参数
|
||
|
||
- `--app_id`：实时对话应用 ID
|
||
- `--access_key`：实时对话 Access Key
|
||
- `--audio`：音频文件路径
|
||
- `--mod`：`audio` 或 `text`
|
||
- `--format`：`pcm` 或 `pcm_s16le`
|
||
- `--rag-file`：外接知识库 JSON 文件路径
|
||
- `--rag-delay-ms`：发送 external_rag 前延迟，默认 3000ms
|
||
- `--test2-env`：显式指定 `test2/server/.env` 路径
|
||
|
||
## 说明
|
||
|
||
这个项目保留了 `realtime_dialog` 的核心思路：
|
||
|
||
- 用真实音频包判断回复是否发生
|
||
- 用 `external_rag` 验证外接知识库是否能直接进入主回复链路
|
||
- 不依赖 RTC 字幕判断是否有音频返回
|