扣子中调试Python插件需三步：先在插件编辑页点击「调试」并填入符合input_schema的JSON输入；运行后若报KeyError或TypeError，须核对字段名大小写与下划线；输出必须为字典格式JSON，字符串、列表或None会被静默丢弃。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在扣子中调试Python插件代码
当你的扣子智能体调用Python插件后返回空结果、报错或逻辑异常，必须进入真实运行环境验证代码行为，不能只靠本地IDE模拟。
第一步：进入插件编辑页 → 点击右上角「调试」按钮 → 在弹出面板中填写测试输入JSON（格式必须与插件定义的input_schema完全一致）。
第二步：点击「运行」，观察右侧输出区。若出现KeyError或TypeError，说明你引用了未传入的字段或类型不匹配——【务必检查input_schema中声明的字段名是否与代码里dict取值的key完全一致，包括大小写和下划线】。
第三步：如果输出正常但智能体仍无响应，检查插件返回值是否为合法JSON对象。扣子只接受字典结构（如{"result": "success"}），返回字符串、列表或None都会被静默丢弃。
用自然语言生成可直接部署的Python插件代码
你不需要记住语法细节，只要把业务逻辑说清楚，扣子就能生成可用的插件骨架。
方法一：在插件编辑页点击「AI生成」→ 输入类似这样的描述：“从用户消息中提取手机号和邮箱，用正则匹配，手机号格式为11位数字，邮箱含@符号和域名，返回包含mobile和email两个字段的字典，没匹配到就留空字符串”。
方法二：在工作流中添加「代码」节点 → 选择「使用AI生成」→ 描述处理目标，例如：“把输入的订单ID列表，逐个调用/api/order/status接口查询状态，合并返回所有status字段为数组”。系统会自动生成带requests调用、异常捕获和JSON解析的完整代码。
生成的代码默认不带认证头，若需对接私有API，【必须手动在headers字典中加入'Authorization'字段，否则请求必然401】。
将调试通过的代码一键同步到工作流节点
当你在一个独立插件中完成调试并确认逻辑正确，可以立刻复用到工作流中，无需复制粘贴。
① 打开目标工作流画布 → 在节点面板搜索栏输入插件名 → 拖拽该插件到画布；
② 点击新添加的插件节点 → 在右侧配置区展开「高级设置」→ 勾选「使用最新调试版本」；
③ 保存工作流 → 点击「试运行」，此时执行的就是你刚刚调试通过的那版代码；
这一步跳过了手动粘贴、格式校验、引号转义等易错环节，尤其适合含多层嵌套JSON或正则表达式的复杂插件。
