文档

文档

modelriver websocket

测试到 ModelRiver 的实时 WebSocket 连接。直接在终端中发送请求并接收 AI 响应。

概述

websocket 命令会发送一个异步请求，并立即通过 WebSocket 进行连接以接收实时响应。这是从命令行端到端测试工作流的最快方法。

使用方法

Bash
# 使用工作流测试
modelriver websocket --workflow my-workflow --message "来自 CLI 的问候"
 
# 使用自定义负载
modelriver websocket --workflow my-workflow --payload '{"messages": [{"role": "user", "content": "测试"}]}'
 
# 连接到现有频道
modelriver websocket --channel-id abc-123 --project-id xyz-789
 
# 详细输出
modelriver websocket --workflow my-workflow --message "测试" --verbose

输出示例

✓ 正在发出异步请求...
✓ 请求已排队: abc-123-def
 
> 频道 ID: abc-123-def
> 项目 ID: xyz-789
 
✓ 正在连接 WebSocket...
✓ WebSocket 已连接
✓ 已加入频道
 
> 正在等待响应...
 
✅ 收到响应：
{
"status": "success",
"data": { ... },
"meta": { ... }
}

选项说明

选项描述
--workflow <name>要测试的工作流
--message <text>简单的文本消息
--payload <json>自定义 JSON 负载
--channel-id <id>现有频道 ID
--project-id <id>项目 ID
--verbose显示详细日志

故障排除

"WebSocket 连接失败"

  • 验证 API URL 是否正确
  • 检查 ws_token 是否过期（CLI 令牌限制为 24 小时）
  • 检查网络连接情况
  • 如果是在生产环境使用，请确保使用 wss://（安全 WebSocket）

下一步