接入指南
从安装到独立接待,八步。
每一步写清谁来做、在哪里做、会看到什么。预览版有几处需要技术人员参与的地方,也照实写在这里。
步骤
「部署方」是负责服务器与桥接运行时的技术人员;「商家」是店铺的经营者。小店可以是同一个人。
部署服务端
部署方服务器一台 Linux 或 macOS 机器,Docker 24 以上。一条命令拉起 API、控制台、Postgres、Temporal 与 OpenFGA,并执行健康自检。
git clone <repo> ai-employee-oss && cd ai-employee-oss bash infra/up.sh # 拉起全部服务,健康自检 bash infra/up.sh --with-ollama # 可选:在宿主机启动 Ollama 并拉取模型
完成后打印控制台地址(默认
:3000)与 API 地址(:8000/docs)。数据存放在命名卷中,git pull && bash infra/up.sh即可升级,迁移自动执行。生产环境请加固:开启AUTH_REQUIRED=true、更换AUTH_SECRET;Temporal 与 OpenFGA 改用 Postgres 存储;控制台使用 HTTPS 并与 API 同源反向代理(桌面端只接受同源控制台)。注册并创建工作台
商家控制台打开你自己部署的控制台(第一步打印的地址)的
/login,用邮箱注册。注册即创建一个独立租户、一家沙盒店铺和一个 owner 账号,密码至少 8 位。官网上没有公共的注册入口:工作台跟着你的服务端走,不在我们这里托管。沙盒店铺用来熟悉工作台与接待沙盒,不连接真实平台;真实的拼多多店铺在下一步接入。
选择模型
部署方或商家控制台进入「规则与设置 → 自带模型」,为生成、忠实度核查、内容安全三个角色各选一个模型:本地 Ollama、DeepSeek 等模型服务,或任何 OpenAI 兼容端点。保存即生效,下一条消息使用新模型。
- 生成模型建议 4B 以上的 instruct 模型;工具调用与多步追问需要这个量级。
- 忠实度核查留空则沿用生成模型;开启后编造的尝试会被拦下并计入可信度看板。
- 内容安全可接入独立的安全分类模型;未配置时使用关键词规则。
安装桌面端
商家商家电脑桌面端负责在商家电脑上打开受控的浏览器窗口、识别拼多多登录态并上报,以及展示控制台。它不保存拼多多账号密码。
预览版安装包未签名:Windows 首次运行可能显示系统安全提示,macOS 可能阻止打开。请核对本页底部的 SHA-256 校验值后再安装,不要关闭系统安全保护。
预览版需要部署方准备桥接运行时:桌面包只含轻量壳,不含 Python、Playwright 与 Chrome。部署方需按桥接 README 准备受控的 Python 环境、锁定依赖、系统 Chrome、绑定与账本,并通过配置文件与环境变量提供给桌面端。接入拼多多店铺
商家桌面端在桌面端打开「本机连接」并启动。SAS 打开一个独立的浏览器窗口,你在拼多多自己的登录页登录——扫码或密码短信均可。
SAS 不代收、不代理、不重放任何凭据,只识别窗口中是否存在可用的登录态,并核对店铺身份。工作台的「接店状态」每 2 秒刷新一次,六种状态见下表。
只有显示为「已连接」时才会进入后续步骤;其他任何状态都不会启动自动接待。
学习历史
自动知识审核点「从历史学习」,SAS 读取最长三年的会话,出现两次以上的问题聚成候选知识。个案说法、含个人信息、答法不一的候选被自动标记;干净的候选标为推荐,一键批量确认即生效。确认前可以预览这条知识生效后哪些买家问题会变为可回答;确认后自动做冲突扫描。
还没接店、或历史不在这台电脑上:在「知识审核」里上传从拼多多或千牛导出的聊天记录文件(CSV / XLSX / JSON / 纯文本),确认列映射后写入,同样可以学习,也可以在可信度看板「回放历史」提前对账。
知识缺口榜告诉你先补哪几条:AI 因为没有知识而没答上的问题按同一件事聚类排名,带原话样例与当时店里的回复,补答直接进库。覆盖率靠它往上拉。零依赖的词法检索默认可用;知识量大或需要解析商品详情页、PDF 时,可启用 RAGFlow 作为检索内核。校准
自动可信度看板真实店铺在开启全程接管之前一律处于校准模式:AI 对每条买家消息拟稿但不发送,与店内原有回复逐条对账,逐日给出采纳率、改写率、忽略率、越权率与知识覆盖率。
默认达标标准:近 7 天配对样本不少于 50 条,越权率不高于 5%,知识覆盖率不低于 60%。看板会直接写出结论——「可全程接管:AI 能自己回答 68%,每 100 条买家问题约 32 条推到你的手机」,或者「能接管但你会很忙,先补知识再切」。每天二三十条咨询的店铺约一周凑齐样本;导入过历史的店铺,回放当天就有结果。
开启全程接管
商家店铺 · 规则与设置达标后,在「店铺」里把接待模式切到「全程接管」,并在「规则与设置」里打开直发开关。此后售前、物流、售后全部由 AI 独立完成,全天在线;退款与赔付的审批在拼多多商家后台由你本人操作。
- 在「通知」里配置企业微信或飞书群机器人:工单创建、退款申请、差评等事件推送到群;AI 答不了的问题连同 72 小时有效的手机链接一起推送,你在手机上回一句即转发买家并学进知识库。
- 「承诺时限」默认 2 小时、到点前 30 分钟提醒,都可在「规则与设置」里调整;登记话术与超时话术同样可改。
- 需要时关闭开关,AI 即刻停止;正在发送中的消息不会被撤回,但之后的一律不发。「用量与计费」实时统计咨询人头、轮次、直接回答、追问等,口径公开。
连接状态
「接店状态」的六种显示,以及每种状态下该做什么。三条失败必须失败在安全一侧。
预览版的边界
这些是当前版本做不到或尚未验收的事。写在这里,是为了让你在接入前就知道。
真实拼多多接店尚未完成验收
浏览器登录、状态上报与身份核对的链路已在离线环境跑通;在真实店铺上的完整接待验收仍在进行。
桌面端不含桥接运行时
Python、Playwright、Chrome 与绑定需由部署方准备并配置;首版没有凭据保险箱与自动下发。
单店闭环
当前以单店为目标,多店铺在路线图上按序推进。
安装包未签名
Windows 与 macOS 安装包均未签名、未公证;安装前请核对 SHA-256。
不承诺「绝不封号」
非官方接入存在平台策略变化的风险。SAS 把风险降到最低,但不作绝对承诺。
模型与容量
单个本地 4B 模型约每分钟 40 条回答;并发买家多或需要稳定的 3 秒内时延,请切到外部模型服务。
下载
预览版 v0.2.1。完整的安装须知与 SHA-256 校验值在首页「安装包与校验」一节。
Windows
Windows 10 / 11,x64 与 ARM64 同一安装包,235.6 MB。
macOS · Apple 芯片(M 系列)
macOS 13 或更高版本,128.7 MB。
macOS · Intel 芯片
macOS 13 或更高版本,135.4 MB。