展开本页目录
开始前准备什么
- Activepieces0.92.3及具体MCP pieceVersion；客户端需支持相应远程MCP/OAuth。平台key与apizt key不可混用；MCP认证、模型工具调用、业务规则三层分别测。虚构7日规则只为教材，不是法条或真实店铺承诺。
- 只在独立练习目录与自己的测试账号操作；使用准确模型ID，真实密钥不写入教材。
- 阅读虚构政策和四单边界
- 建立MCP Tool触发参数
- 让Code返回三态与规则ID
- 用Reply to MCP Client返回工具结果
- 客户端先发现工具再发起调用
- 回读参数、规则与缺项追问
- 记录费用并停在资格核对
原创输入、任务提示、字段教材、源码参考、人工基准和实际本地输出；无需模型即可核对。
包含七步原生操作、版本、来源和目标平台待执行项。
本站手写参考或人工基准的实际渲染，不是目标平台或模型输出。
1. 阅读虚构政策和四单边界
固定今天为2026-10-15，签收第7天可进入eligible，超过7天、定制品及缺日期分别处理。policy.json只用于练习，不能对真实消费者作法律或售后承诺。
2. 建立MCP Tool触发参数
Activepieces添加MCP Tool，填写工具名与用途，定义order_id、delivered_date、customized。缺日期用null，不用空字符串伪造一个今天日期。
3. 让Code返回三态与规则ID
用reference.py中的独立规则参考实现本地Code逻辑，返回eligible/ineligible/needs_info及rule_id。模型负责理解自然提问，不能覆盖Code判定或补造订单事实。
4. 用Reply to MCP Client返回工具结果
将Code输出映射到Reply to MCP Client。MCP Server管理工具与暴露业务flow不是一回事；在自己的部署按当前版本将该业务工具提供给客户端。
5. 客户端先发现工具再发起调用
Settings → MCP Server启用后复制server URL，客户端按OAuth授权。先直接测试四种输入；认证失败、工具未发现、规则错误分别排查，不把LLM正常聊天当MCP已连通。
6. 回读参数、规则与缺项追问
实际客户端应保留工具调用输入/输出，R04返回needs_info后询问签收日期。reference.html是本地规则运行结果表，没有模拟真实客户端UI或退款状态。
7. 记录费用并停在资格核对
保留flow导出、MCP pieceVersion和四次实际记录。ap_run_action及工具触发flow可能有平台credits，模型调用另算；本题不访问真实客户、不退款、不发送消息。
怎样确认已经完成
- 四单分别命中第7天、超期、定制、缺日期的既定分支。
- 返回eligible/ineligible/needs_info及rule_id，缺日期不补造。
- 直接MCP输入/输出可回读，不退款、不发送消息，离线参考不冒充平台运行。
常见问题
让聊天AI按店铺规则查能不能退？
把模型参数提取与确定性资格核对分开，缺日期必须返回needs_info。 按上面七步在自己的工具执行；本页下载包提供可核对的输入和参考。
不用写MCP服务器也能做自己的工具？
实际客户端应保留工具调用输入/输出，R04返回needs_info后询问签收日期。reference.html是本地规则运行结果表，没有模拟真实客户端UI或退款状态。
Activepieces MCP 教程 的练习包能直接导入吗？
node-fields.json是逐字段操作教材，不能冒充平台原生工作流导出。按实际版本在工具里配置并保存自己的原生文件；Recipe YAML和单文件HTML等明确命名的材料见README。