TuringBlog

UDtools 云端配置编辑器

适配扩展 v1.15.0 的多记录结构。PocketBase 集合 UDtools_admin_params每条记录一个域,各自独立生成、独立粘贴

⚠ v1.15.0 结构已变(2026-08-01):原先所有参数挤在一条 key=global 记录里, 现已按域拆成 ticket / reply / monitor / toolbox / category / ai 六条独立记录,global 已退役清空。 每个分区生成的 JSON 只能粘到它对应那条记录的 params 字段,不要混用。

① 先抓线上现值(强烈建议)

抓下来再改,避免用历史默认值覆盖线上正在用的配置。读门 code 已预填(与扩展内置一致)。 若被浏览器 CORS 拦截,改用各分区的「粘贴导入」手动贴。

🎫 录单模板 key = ticket

Alt+Q / Alt+W 的模板文案与下拉默认值。下发后坐席端「快捷录单」tab 对应项转 ☁ 只读。

占位符必须保留{hotel}=酒店编码&名称、{problem}=问题描述、 {solution}=解决方案。删掉会让 Alt+Q 主题同步与 Alt+S 填客户解析不出来

⚠ 服务方式 / 问题类型必须与 udesk 下拉里的选项文字完全一致 —— 差一个字 preset 就选不中,且是静默失败(坐席只看到「没填上」,查不出原因)。

高级:presets / selectors(裸 JSON,一般不用动)

presets整体替换(不是逐条合并),漏写某条 = 坐席端也没有那条。 建议从坐席端「导入导出」导出后再改,别手写。留空 = 不下发。

💬 自动响应 + 快捷回复 key = reply

对客话术,全员统一。这条记录同时管 autoReplyquickReplies 两块。

识别关键词是自动响应的命脉 —— 坐席端靠它判断「新会话进线」。填错或清空会让 自动首句彻底失效且没有任何报错。v1.15.0 起坐席端已移除该项编辑入口,只能在这里改。

⚠ v1.15.0 已删掉第五槽 Alt+Z。「发完自动邀评」下发的是默认值 —— 坐席仍可在自己设置页改(那是现场判断:客户情绪不好时不该硬邀评)。

键位文案发完邀评

🧰 侧栏工具箱三块 key = toolbox

Alt+G 侧栏「工具箱」里的常用文案 / 常用导航 / 常用命令。 云端条目排最前、打 ☁、坐席不可删;坐席可在后面追加自己的。

标题(可留空)正文

⚠ 只收 http:// / https://,其它协议会被客户端整条丢弃(防 javascript:)。

名称图标URL
标题(可留空)命令正文

📊 监控参数 key = monitor

租户标识、告警阈值、轮询频率。坐席端全部只读。

有意不下发 enabledselfStats.* —— 那是坐席的现场开关(要能随时停掉监控/徽标),云端强制会剥夺控制权。写了也会被客户端忽略。

🏷 智能分类 key = category

分类预设 / 同义词 / 黑名单 / 锚点 / 二级系统分流表。 合并语义 = 云端为基线 + 坐席本地追加,两边互不覆盖。

这块数据量大(分流表上百条),不做表单化——裸 JSON 编辑更实际。 请先抓取再改,别从零手写。

🤖 AI 提示词与参数 key = ai

提示词 + 岗位技能 + 行为参数。坐席端已移除 prompt 编辑 UI,只能在这里配。

apiKey 绝不上云(铁律)—— 明文躺在 PB 里风险远大于收益;2026-08-01 起 key 由每个坐席自己填(WorkBuddy 访问密钥),扩展不再内置。写了也会被客户端忽略。
batchSubmitMode(批量补录提交策略)同样有意不下发,那是坐席的现场安全阀。
别在 prompt 里写「你有哪些工具」——工具说明由扩展按当前真实注册的 tool 动态生成并自动拼进 system prompt。写进 prompt 反而会在工具增减时说谎。
提示词(留空 = 不下发该项,客户端用内置默认)

粘贴到 PocketBase 的步骤

  1. 打开 UDtools_admin_params 集合,找到对应 key 的记录(没有就新建,code 填与其它记录相同的读门码);
  2. 把上面生成的 JSON 整体粘进该记录的 params 字段;
  3. 保存后用客户端真实路径验证能读到(匿名 + ?code=,别用超管 token 验,那绕过了读规则);
  4. 坐席端刷新 udesk 页立即生效;不刷新也会在 30 分钟内自动同步。
一条记录的 params 非空 → 该域整体由它说了算(不是逐字段回退到别处)。 漏写某个字段 = 坐席端那个字段用本地默认值。所以务必先抓取再改