客户端 → 服务端（中文）
消息外层格式
{
"event": "event-name",
"data": {}
}
1) ping 心跳
{
"event": "ping"
}
2) gen 生成请求
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
event |
"gen" |
是 | 生成事件名 |
data.prompt |
string |
是 | 用户输入，去空后不能为空 |
data.conversationId |
string |
否 | 续写会话 |
data.isPrivate |
boolean |
否 | 历史拉取参数 |
data.temperature |
number |
否 | 自动归一化到 0~2 |
data.tools |
OpenAI tool[] |
否 | 透传到 OpenAI 兼容链路，支持 tool call 循环 |
data.enableWebSearch |
boolean 或 0/1 或 "true"/"false" |
否 | 搜索开关 |
data.webSearch.enabled |
同上 | 否 | 与 enableWebSearch 同义 |
data.webSearch.mode |
"auto" 或 "force" |
否 | 默认 auto |
data.webSearch.maxResults |
number |
否 | 归一化 1~8，默认 5 |
data.webSearch.freshness |
"day" 或 "week" 或 "month" 或 "any" |
否 | 默认 week |
data.webSearch.lang |
"zh" 或 "en" 或 "auto" |
否 | 默认 auto |
示例
{
"event": "gen",
"data": {
"prompt": "最近一周欧盟 AI 监管更新",
"temperature": 0.2,
"enableWebSearch": "true",
"webSearch": {
"mode": "force",
"maxResults": 5,
"freshness": "week",
"lang": "auto"
},
"tools": [
{
"type": "function",
"function": {
"name": "get_regulation_updates",
"description": "按地区获取监管更新",
"parameters": {
"type": "object",
"properties": {
"region": { "type": "string" }
},
"required": ["region"]
}
}
}
]
}
}
3) set-model（兼容保留）
当前网关保留该事件，但不作为主模型切换入口。
English version: Client → Server