1. 从零跑通 Dify 聊天助手：智能淘宝店小二问答机器人怎么落地
Dify 聊天助手是一个可视化编排 LLM 应用的工具，能让你不写后端代码就把 Prompt、知识库、模型参数串成一个可发布的对话应用。它适合谁？适合想快速验证客服、导购、售后问答场景的产品、运营和独立开发者。我这次要做的，是一个“智能淘宝店小二”：客户问“我的货怎么还没到”，它能用朋友语气回复、主动索要订单号、遇到索赔时礼貌拒绝，最后还能通过 API 被自己的页面调用。
整条链路分五步：创建聊天助手并写 Prompt、处理 think 冗余输出、加边界约束、完善订单号交互、发布并接入 API。其中最关键的一步是把模型 endpoint 统一改到 TaoToken，这样你只维护一个 Key，就能在 Dify 里切换不同模型，不用为每个模型单独配一套鉴权。下面按可跟做的顺序展开，每一步都给到能直接复制的配置和验证命令。
先明确一个认知：Dify 本身不生产模型能力，它负责编排。模型从哪来、走哪个 endpoint、用哪个 Key，是你在“模型供应商”里配置的。很多人卡住不是因为 Prompt 写得不好，而是 endpoint 填错、Key 权限不对、模型 ID 写成了展示名。把这三件事对齐，店小二就能跑起来。
2. TaoToken 前置：统一 Key 与 endpoint 填写位置
在 Dify 里接入模型，路径是「设置 → 模型供应商 → 添加模型供应商」。如果你用的是 OpenAI 兼容协议，选 OpenAI 供应商即可，然后把 Base URL 改成 TaoToken 的 API 地址。TaoToken 的 API 地址是https://taotoken.net/api，注意这里不要加任何查询参数，保持干净。官网入口是https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=，需要看文档或领 Key 从官网进。
你需要准备三件套：Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api；API Key 在控制台的 API Keys 页面创建，形如sk-开头的一串；Model ID 要填模型真实调用名，比如qwen-plus-latest，而不是界面上显示的中文名。这三者缺一不可，且必须完全对应。
在 Dify 的 OpenAI 供应商配置里，通常有两个字段：API Key 和 API Base。API Base 填https://taotoken.net/api，API Key 填你创建的那串。保存后 Dify 会拉取模型列表，如果拉取失败，多半是 Base URL 多了斜杠或少了/api。我试过把 Base 写成https://taotoken.net/api/带尾斜杠，结果列表拉不出来，去掉尾斜杠就正常了。
如果你要在 Dify 之外单独验证 Key 是否可用，可以用 curl 直接打模型对话接口。这一步很重要，因为它能把“Dify 配置问题”和“Key/endpoint 问题”分开。命令如下：
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-plus-latest", "messages": [ {"role": "user", "content": "你好，帮我查一下订单"} ] }'返回里如果有choices数组且message.content有内容，说明 Key 和 endpoint 都通。如果返回 401，是 Key 无效或没带Bearer；如果返回 404，是路径写错，注意是/api/v1/chat/completions。这一步过了，再回 Dify 配模型，成功率会高很多。
3. 可复制配置：Dify 聊天助手 Prompt 与模型参数
进入 Dify「工作室 → 创建应用 → 聊天助手」，起名“淘宝店小二”。在「编排」页，先写系统 Prompt。第一版 Prompt 如下，直接复制：
请你用朋友的语气回复给到客户，并称他为“亲”，他的订单已经发货在路上了，预计在3天之内会送达，订单号{{order_code}}，我们很抱歉因为天气的原因物流时间比原来长，感谢他选购我们的商品。这里的{{order_code}}是 Dify 的变量占位符，你可以在「变量」里定义一个order_code，测试时填ZG1283213939434。但实测下来，这种把订单号写死在 Prompt 里的方式对真实客服不友好，因为客户不一定主动给单号。后面第 4 节会改成动态询问。
模型选择上，第一版如果选了带 think 的模型，回复里会夹带“已深度思考(8.3s)”这类内容。对店小二场景，这属于冗余输出，客户看到会困惑。解决办法有两个：一是选不带 think 的模型，二是选支持关闭 think 的模型。这里选qwen-plus-latest，它在 Dify 里通过 OpenAI 兼容协议调用时，默认不输出思考过程。
在「模型参数」里，建议把 Temperature 调到 0.7 左右，Top P 保持 0.9，最大 Token 设 1024。店小二回复不需要太长，太长反而像机器人。如果你希望回复更稳定，可以把 Temperature 降到 0.5，但语气会偏正式，失去“朋友感”。
如果你用的是 Dify 的「Agent」模式而不是「聊天助手」，配置会多一层工具调用。店小二场景不需要工具，用聊天助手即可，链路更短、更可控。发布前记得在「编排」页右上角点「发布 → 更新」，否则 API 访问的还是旧版本。
4. 验证请求与成功结果：curl 打 Dify 对话接口
Dify 应用发布后，进入「访问 API」页面，能看到 API Base 和 API Key。Dify 的 API Base 通常是https://你的Dify域名/v1，API Key 形如app-开头。用 curl 验证对话接口：
curl https://你的Dify域名/v1/chat-messages \ -H "Authorization: Bearer app-你的DifyKey" \ -H "Content-Type: application/json" \ -d '{ "inputs": {"order_code": "ZG1283213939434"}, "query": "我的货怎么还没到", "response_mode": "blocking", "user": "customer-001" }'response_mode用blocking会等完整回复再返回，方便调试；用streaming是流式返回。返回 JSON 里answer字段就是店小二的回复。如果返回里出现“已深度思考”，说明模型带 think，需要换模型或加参数关闭。
成功返回的样子大概是：answer里包含“亲，别着急”“订单号 ZG1283213939434”“预计 3 天内送达”这些要素。如果answer为空，检查inputs里的变量名是否和 Prompt 里的{{order_code}}一致，大小写敏感。
这一步跑通后，你就有了一个可被外部调用的店小二接口。你可以用自己的前端页面、微信机器人、甚至淘宝客服插件去调它。Dify 的「嵌入网站」也提供了三种方式：iframe、script 气泡、以及直接复制代码。如果界面不够炫，就走 API 自己开发页面。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
第一个高频错是 401。报错原文通常是{"error":{"message":"Invalid API key","type":"invalid_request_error"}}。原因有三种：Key 复制时带了空格、Key 已删除、或者请求头没写Bearer。注意Bearer和 Key 之间有一个空格，少这个空格也会 401。排查方法：用第 2 节的 curl 直接打 TaoToken，如果也 401，就是 Key 问题；如果 TaoToken 通但 Dify 不通，就是 Dify 里 Key 填错。
第二个错是local proxy failed或connection refused。这通常出现在 Dify 部署在内网、而模型 endpoint 需要外网访问时。检查 Dify 容器能否解析taotoken.net，可以用docker exec -it dify-api curl -I https://taotoken.net/api测试。如果解析失败，是 DNS 问题；如果超时，是网络出口问题。注意不要用任何非正规网络手段，企业环境应走合规出口。
第三个错是reading choices相关，比如Cannot read properties of undefined (reading 'choices')。这是 Dify 在解析模型返回时没找到choices字段，通常因为 endpoint 返回的不是 OpenAI 兼容格式，或者 Base URL 少了/v1。TaoToken 的对话接口是https://taotoken.net/api/v1/chat/completions，在 Dify 里 Base 填https://taotoken.net/api，Dify 会自动补/v1/chat/completions。如果你手动填了/v1，就会变成/v1/v1，导致 404 进而解析失败。
第四个错是 OAuth 相关，比如OAuth token exchange failed。这通常出现在你误选了需要 OAuth 的供应商（如某些官方 SDK），而 TaoToken 走的是 API Key 鉴权。解决办法：在 Dify 里选 OpenAI 供应商而不是 OAuth 类供应商，鉴权方式选 API Key。如果你在 Claude Code 或 Cline 里配置，也要注意 Base URL、Key、Model ID 三件套齐全，缺一个都会报鉴权错。
排障顺序建议：先用 curl 打 TaoToken 确认 Key 和 endpoint；再用 curl 打 Dify 确认应用发布；最后在 Dify 界面里测。这样能把问题定位到具体一层，不用来回猜。
6. 语义一致 CTA：把店小二接到你的业务里
店小二跑通后，下一步是把它接到真实业务。如果你只是验证模型对话效果，可以直接在 Dify 的「探索」里打开应用，或者用模型对话页面快速试不同 Prompt。如果你要长期做编码类 Agent、或者把店小二扩展成多轮售后 Agent，建议用 Coding Plan，它更适合持续调用和额度管理。
需要创建 Key、查看调用额度，走 API Keys 页面；需要看接入细节和参数说明，走接入文档。这两个入口都在官网能找到。Dify 这边发布后，你可以选「嵌入网站」把气泡挂到自己的店铺页，也可以走 API 自己写前端。我自己的做法是先用 curl 把对话接口跑通，再写一个简单页面调 Dify 的/v1/chat-messages，这样出问题能快速定位是 Dify 还是前端。
最后提醒一个实际坑：店小二的 Prompt 里如果写了“给赔偿”，模型真的会答应赔偿。第 3 节加的“客户如果要弥补损失，你婉言拒绝，不要给任何赔偿”这句约束很关键。模型本身不接触真实世界，它只是按 Prompt 生成文本，所以边界必须由你写死。把订单号询问、赔偿拒绝、语气要求这三条写进 Prompt，店小二才算能用。
