From cbc498b73d0d4ab2d5006dd2a61884447bd13a1d Mon Sep 17 00:00:00 2001
From: wutao <wutao@wutaodeMacBook-Pro.local>
Date: Tue, 16 Dec 2025 11:36:14 +0800
Subject: [PATCH 1/4] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=99=BA=E8=83=BD?=
 =?UTF-8?q?=E4=BD=93=E6=8F=90=E7=A4=BA=E8=AF=8D=E6=9B=BF=E6=8D=A2=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/xrobot/platform/websocket.md | 39 +++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/docs/xrobot/platform/websocket.md b/docs/xrobot/platform/websocket.md
index d459d7e..34813d7 100644
--- a/docs/xrobot/platform/websocket.md
+++ b/docs/xrobot/platform/websocket.md
@@ -293,6 +293,45 @@ WebSocket 支持 **🎵 音频数据帧**（二进制方式）以及 **文本帧
 }
 ```
 
+##### 5. 智能体提示词替换 消息
+用于设备端向服务器告知检测到唤醒词。
+###### 参数规则:
+- key: 只能英文(小写)、并且是 snake_case 的命名风格,不能出现数字和非英文的字符,最长50字符，超过50将丢弃当前参数
+- value: 最长200字符，大于200只保留前200字符
+- 数量: 最多100个参数，超过100个只保留前100个
+###### 使用示例：
+提示词配置参数
+```
+你是{{assistant_name}}，一个智能助手。
+当前用户是{{user_name}}，所在地点是{{location}}。
+今天是{{date}}，天气{{weather}}。
+请根据这些信息与用户进行个性化交互。
+```
+hello消息
+```json
+{
+  "type": "hello",
+  "transport": "websocket",
+  "session_id": "session_67890",
+  "agent_params": {
+    "custom_replace_prompt": {
+      "assistant_name": "小牛牛",
+      "user_name": "张三",
+      "location": "北京",
+      "date": "2024年12月1日",
+      "weather": "晴天"
+    }
+  }
+}
+```
+最终生成的系统提示词:
+```
+你是小牛牛，一个智能助手。
+当前用户是张三，所在地点是北京。
+今天是2024年12月1日，天气晴天。
+请根据这些信息与用户进行个性化交互。
+```
+
 #### 服务端发送消息
 
 ##### 1. Hello 响应

From 964abccbdc488bc5bd12e54519fc47a664056950 Mon Sep 17 00:00:00 2001
From: wutao <wutao@wutaodeMacBook-Pro.local>
Date: Tue, 16 Dec 2025 11:46:10 +0800
Subject: [PATCH 2/4] =?UTF-8?q?=E8=AF=84=E5=AE=A1=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/xrobot/platform/websocket.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/xrobot/platform/websocket.md b/docs/xrobot/platform/websocket.md
index 34813d7..13d3a4a 100644
--- a/docs/xrobot/platform/websocket.md
+++ b/docs/xrobot/platform/websocket.md
@@ -293,10 +293,10 @@ WebSocket 支持 **🎵 音频数据帧**（二进制方式）以及 **文本帧
 }
 ```
 
-##### 5. 智能体提示词替换 消息
-用于设备端向服务器告知检测到唤醒词。
+##### 5. Hello 消息扩展：智能体提示词替换
+此功能通过在 `hello` 消息中添加 `agent_params` 字段，允许设备端在建立连接时传递动态参数，用于替换智能体系统提示词中的占位符。
 ###### 参数规则:
-- key: 只能英文(小写)、并且是 snake_case 的命名风格,不能出现数字和非英文的字符,最长50字符，超过50将丢弃当前参数
+- key: 只能英文(小写)和下划线、并且是 snake_case 的命名风格,不能出现数字和非英文的字符,最长50字符，超过50将丢弃当前参数
 - value: 最长200字符，大于200只保留前200字符
 - 数量: 最多100个参数，超过100个只保留前100个
 ###### 使用示例：
@@ -307,12 +307,11 @@ WebSocket 支持 **🎵 音频数据帧**（二进制方式）以及 **文本帧
 今天是{{date}}，天气{{weather}}。
 请根据这些信息与用户进行个性化交互。
 ```
-hello消息
+hello消息（包含智能体提示词替换参数）
 ```json
 {
   "type": "hello",
   "transport": "websocket",
-  "session_id": "session_67890",
   "agent_params": {
     "custom_replace_prompt": {
       "assistant_name": "小牛牛",

From 45b4da7a8a58eb88d35e2d5a1f9ae8ae358ed261 Mon Sep 17 00:00:00 2001
From: wutao <wutao@wutaodeMacBook-Pro.local>
Date: Tue, 16 Dec 2025 13:50:10 +0800
Subject: [PATCH 3/4] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E8=AF=84=E5=AE=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/xrobot/platform/websocket.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/xrobot/platform/websocket.md b/docs/xrobot/platform/websocket.md
index 13d3a4a..732c534 100644
--- a/docs/xrobot/platform/websocket.md
+++ b/docs/xrobot/platform/websocket.md
@@ -295,19 +295,20 @@ WebSocket 支持 **🎵 音频数据帧**（二进制方式）以及 **文本帧
 
 ##### 5. Hello 消息扩展：智能体提示词替换
 此功能通过在 `hello` 消息中添加 `agent_params` 字段，允许设备端在建立连接时传递动态参数，用于替换智能体系统提示词中的占位符。
-###### 参数规则:
+**参数规则：**
 - key: 只能英文(小写)和下划线、并且是 snake_case 的命名风格,不能出现数字和非英文的字符,最长50字符，超过50将丢弃当前参数
 - value: 最长200字符，大于200只保留前200字符
 - 数量: 最多100个参数，超过100个只保留前100个
-###### 使用示例：
-提示词配置参数
+
+**使用示例：**
+提示词配置参数:
 ```
 你是{{assistant_name}}，一个智能助手。
 当前用户是{{user_name}}，所在地点是{{location}}。
 今天是{{date}}，天气{{weather}}。
 请根据这些信息与用户进行个性化交互。
 ```
-hello消息（包含智能体提示词替换参数）
+hello消息（包含智能体提示词替换参数）:
 ```json
 {
   "type": "hello",

From 5bf65b4b44904d641ba3bf1bd34d6dea85c3235d Mon Sep 17 00:00:00 2001
From: wutao <wutao@wutaodeMacBook-Pro.local>
Date: Tue, 16 Dec 2025 13:56:44 +0800
Subject: [PATCH 4/4] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E8=AF=84=E5=AE=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/xrobot/platform/websocket.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/xrobot/platform/websocket.md b/docs/xrobot/platform/websocket.md
index 732c534..928c84b 100644
--- a/docs/xrobot/platform/websocket.md
+++ b/docs/xrobot/platform/websocket.md
@@ -295,10 +295,6 @@ WebSocket 支持 **🎵 音频数据帧**（二进制方式）以及 **文本帧
 
 ##### 5. Hello 消息扩展：智能体提示词替换
 此功能通过在 `hello` 消息中添加 `agent_params` 字段，允许设备端在建立连接时传递动态参数，用于替换智能体系统提示词中的占位符。
-**参数规则：**
-- key: 只能英文(小写)和下划线、并且是 snake_case 的命名风格,不能出现数字和非英文的字符,最长50字符，超过50将丢弃当前参数
-- value: 最长200字符，大于200只保留前200字符
-- 数量: 最多100个参数，超过100个只保留前100个
 
 **使用示例：**
 提示词配置参数: