Dify 接入源头淘

在 Dify 工作流或 Chatflow 中给 agent 装上"买得到"的能力。

前置

• Dify 版本支持 MCP（2025 年中后的版本均支持，方式为 MCP/Bachelor 工具或自定义工具）
• 源头淘 agent key（控制台注册获取）

方式一：MCP（推荐）

1. 进入 Dify → 工具 → MCP（或安装 MCP SSE/StreamableHttp 插件，视版本而定）
2. 添加服务器：
   • URL: https://mcp.yuantoutao.com/mcp
   • Headers: Authorization: Bearer ak_你的key
3. 授权后可见 6 个工具（search_goods / get_goods_detail / create_order / get_order_status / get_logistics / request_aftersale）

方式二：自定义工具（REST）

用我们的 OpenAPI 思想手写工具 schema 或直接用 HTTP 节点调用 https://api.yuantoutao.com/v1/*，鉴权头 X-API-Key。适合只要搜品不要下单的编排。

编排建议

1. 意图识别节点：判断用户是否表达购买意图
2. search_goods → 把候选整理成卡片给用户选
3. 确认节点：复述商品/价格/收货信息，用户确认才继续
4. create_order → 把 pay_url 转成二维码/链接给用户
5. get_order_status 轮询节点或留给用户主动问

注意

• 金额单位是分
• Idempotency-Key 必填
• Dify 应用发布为 API/模板时不要把 key 写死进提示词，放环境变量