如何为Ydisks闲鱼助手接入AI客服:OpenAI兼容模型与议价策略配置
如何为Ydisks闲鱼助手接入AI客服:OpenAI兼容模型与议价策略配置
Ydisks-Xianyu-Helper 是一款闲鱼多账号自动发货、消息回复系统。本文是面向新手的完整指南:教你为 Ydisks 闲鱼助手接入 AI 客服——只需配置任意 OpenAI 兼容模型(如通义千问、OpenAI),再设置议价策略(最大折扣、砍价轮次上限),AI 即可自动应答买家的砍价消息,并在安全边界内自动改价,实现闲鱼无人值守议价。
一、先搞懂:AI 客服在闲鱼助手里如何工作
Ydisks 闲鱼助手采用四级回复引擎:外部 API 回复 → 关键词匹配 → AI 回复 → 默认回复(实现见 internal/engine/reply.go)。理解这一点,配置就不会出错:
- 🤖 AI 只处理议价场景:当买家消息命中「便宜、优惠、少点、最低、砍价、降价、打折」等意图时才由 AI 应答(意图识别规则见 internal/engine/ai.go);
- 问候、售后等普通消息继续走关键词/默认回复链路,AI 不抢答;
- 💰 价格安全规则由后端强制追加:折扣上限、轮次上限永远生效,自定义提示词无法覆盖(见 buildSystemPrompt);
- AI 给出的报价会先校验最低价边界,越界时系统自动改用安全话术,不会亏本降价。
二、第一步:在「系统与AI」接入 OpenAI 兼容模型
只有管理员可见此页面。路径:左侧菜单 → 系统与AI →「AI 智能回复配置」区块(界面代码见 Settings.tsx)。
1. 填写 API 地址(只填版本根路径)
填写任意 OpenAI 兼容服务的 Base URL,例如:
- 阿里云通义千问:
https://dashscope.aliyuncs.com/compatible-mode/v1 - OpenAI:
https://api.openai.com/v1
⚠️ 不要补全 /chat/completions 路径——系统会自动拼接:读取模型时请求 地址 + /models,测试连接与正式对话请求 地址 + /chat/completions(见 ai_model_client.go 与 L247)。
系统出厂默认即为通义千问兼容地址 +
qwen-plus模型(见迁移脚本 00003_global_ai_settings.sql),国内用户不改动也能直接使用。
2. 填写 API Key
API Key 属于敏感字段,加密存储、不回显原文(输入框默认打码,可点击眼睛图标临时显示)。请注意:密钥只填在这里,不要写进自定义提示词、截图或聊天记录中。
3. 「读取模型」+「测试连接」双保险
| 按钮 | 作用 | 说明 |
|---|---|---|
| 读取模型 | 调用 /models 端点拉取模型目录 |
兼容多种响应格式(data/models 数组等),解析后进入下拉框;服务不支持列表时可手动输入模型名(ParseAIModels) |
| 测试连接 | 发送一次最小「你好」对话(最多 64 tokens) | 返回延迟毫秒数与回复摘要,错误信息可直接定位:401/403 认证失败、404 模型不存在或地址错误、429 额度/频率受限(TestConnection) |
另外建议开启「限制用户配置的 HTTP 出站请求只能访问公网」,它会同步约束 AI 出站请求,防止误连内网地址。
三、第二步:在账号管理开启 AI 自动回复
AI 模型是全局配置,但开关和议价策略是按账号设置的。路径:左侧菜单 → 账号管理 → 点击目标账号的「AI助手设置」。
1. 启用 AI 自动回复
打开「启用 AI 自动回复」开关后,该账号的买家砍价消息才会进入 AI 应答流程。
2. 设置砍价策略(三个关键上限)
这是议价策略的核心(界面代码见 AccountAISettingsModal.tsx):
| 参数 | 含义 | 示例 |
|---|---|---|
| 最大折扣比例 (%) | 最多降价百分比 | 填 10 = 最多降 10% |
| 最大折扣金额 (元) | 最多降价金额 | 填 100 = 最多降 100 元 |
| 最大砍价轮次 | 买家最多可砍价次数 | 范围 1~10,建议保守 |
📌 两个折扣上限必须同时满足,系统取更严格的一个作为底价(底价算法见 minimumAllowedPrice);任一上限设为 0 即不允许降价。
3. 自定义提示词(可选)
可以定义回复风格、产品边界、禁止承诺的内容与语气。支持占位符 {item_title}、{item_price}、{item_description} 自动替换为当前商品信息;价格安全规则仍由后端追加,无法被提示词改写。
4. 自动执行 AI 报价改价(进阶)
开启后,当 AI 明确报出一个可成交价格、且买家在 30 分钟内拍下对应商品时,系统自动修改待付款订单价格。
其原理是模型在回复末尾输出内部报价标记 <a href="https://link.gitcode.com/i/83a28fbdde63452bdb2dd2af14c5d538" target="_blank">[AUTO_PRICE:金额]],发送前由系统解析并移除——买家永远看不到这个标记(解析与剥离逻辑见 [internal/engine/ai.go)。注意:
- 标记只有在「商家开启真实改价 + 报价通过边界校验」时才会被执行;
- 开启 AI 自动改价后,固定自动化规则改价将不能同时启用(见 docs/wiki/系统设置.zh-CN.md 与 AccountAISettingsModal.tsx)。
四、第三步:用一次真实议价对话验证效果
配置完成后,用低风险账号找朋友发一条「最低多少钱?」试试。下面是官方的在线聊天界面截图:买家发出「最低多少钱?」后,AI 根据议价边界自动回复「抱歉,当前价格已经是最低价,暂时不能再优惠了。」——这正是系统判定报价越界后自动切换安全话术的效果。
验证清单:
- 折扣金额/比例是否按预期生效;
- 砍价轮次用尽后是否礼貌拒绝继续降价;
- 开启自动改价时,实际下单后订单价格是否被正确修改;
- 在「在线聊天」中查看对话是否完整留痕(每轮买卖对话都会被记录,用于上下文记忆)。
五、常见问题排查
| 症状 | 排查路径 |
|---|---|
| AI 完全不回复 | ① 系统级 API 地址/Key/模型是否配置正确 → ② 该账号是否已启用 AI 自动回复 → ③ 买家消息是否为砍价消息(AI 只介入议价场景) |
| AI 降价太狠 | 检查「最大折扣比例/金额」,设为 0 即禁止降价;调低「最大砍价轮次」 |
| 测试连接报错 | 401/403 = Key 无效或权限不足;404 = 地址或模型名错误(常见于多填了 /chat/completions);429 = 额度或频率受限 |
| 担心提示词绕过价格限制 | 无需担心:折扣上限、轮次上限、报价标记校验均由后端强制执行,提示词只能影响文案风格 |
六、相关文档与源码
- 官方文档:docs/wiki/系统设置.zh-CN.md(「配置 AI」章节)、docs/wiki/AI-Notifications-and-Operations.md(AI 配置、通知与故障排查顺序)
- AI 回复引擎(提示词构建、议价轮次、安全边界):internal/engine/ai.go
- 四级回复链路:internal/engine/reply.go
- 模型目录读取与连接测试:internal/adapter/ai_model_client.go
- 全局 AI 设置默认值:internal/db/migrations/postgres/00003_global_ai_settings.sql
- 账号 AI 设置界面(砍价策略表单):frontend/app/features/accounts/components/AccountAISettingsModal.tsx
- 系统与 AI 设置页(API 地址/Key/模型):frontend/app/features/settings/pages/Settings.tsx


