如何为Ydisks闲鱼助手接入AI客服:OpenAI兼容模型与议价策略配置

原创2026-10-11 00:57:471,657 阅读
文章标签:电商后端前端AI 应用即时通讯工作流自动化

如何为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)。

Ydisks闲鱼助手账号管理界面,账号卡片上显示AI开关与自动议价状态标签

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)。注意:

Ydisks闲鱼助手自动化规则页面,展示拍下未付款自动改价与交易自动化模板

四、第三步:用一次真实议价对话验证效果

配置完成后,用低风险账号找朋友发一条「最低多少钱?」试试。下面是官方的在线聊天界面截图:买家发出「最低多少钱?」后,AI 根据议价边界自动回复「抱歉,当前价格已经是最低价,暂时不能再优惠了。」——这正是系统判定报价越界后自动切换安全话术的效果。

Ydisks闲鱼助手在线聊天界面,买家询问最低多少钱后AI自动回复价格已是最低价

验证清单:

  1. 折扣金额/比例是否按预期生效;
  2. 砍价轮次用尽后是否礼貌拒绝继续降价;
  3. 开启自动改价时,实际下单后订单价格是否被正确修改;
  4. 在「在线聊天」中查看对话是否完整留痕(每轮买卖对话都会被记录,用于上下文记忆)。

五、常见问题排查

症状 排查路径
AI 完全不回复 ① 系统级 API 地址/Key/模型是否配置正确 → ② 该账号是否已启用 AI 自动回复 → ③ 买家消息是否为砍价消息(AI 只介入议价场景)
AI 降价太狠 检查「最大折扣比例/金额」,设为 0 即禁止降价;调低「最大砍价轮次」
测试连接报错 401/403 = Key 无效或权限不足;404 = 地址或模型名错误(常见于多填了 /chat/completions);429 = 额度或频率受限
担心提示词绕过价格限制 无需担心:折扣上限、轮次上限、报价标记校验均由后端强制执行,提示词只能影响文案风格

六、相关文档与源码

登录后查看全文
Ydisks-Xianyu-Helper