🐕 定时器等待狗 - 使用说明

让工作流自动排队执行的智能助手！
每分钟自动检查任务，完成后自动触发下一步
🔗 获取插件

🎯这个插件是干什么的？

想象你有一个忠实的小狗助手：

  • 📋 你给它一个任务清单
  • ⏰ 它每分钟检查一次任务进度
  • ✅ 发现任务完成后，自动执行下一个任务
  • 🔄 完全不需要你手动操作

🎬经典使用场景

📹 AI视频制作流程自动化

1 工作流1：制作素材，提交图片生成视频任务
2 工作流2：检查视频生成进度（等待狗会反复执行）
3 工作流3：视频完成后自动进行剪辑合成

等待狗的作用：自动重复执行工作流2，一旦检测到视频生成完成，立即启动工作流3！

⚙️参数设置说明

🔴 必填参数（不填不能用）

参数名 说明 示例
workflow_id 必填 要循环检查的工作流ID 从工作流URL中获取
input 必填 传给工作流的参数值 通常是table_id
coze_token 必填 你的授权令牌 从扣子平台获取

🟡 可选参数（可填可不填）

参数名 说明 默认值
callback_workflow_id 可选 任务完成后要执行的下一个工作流 无
max_cnt 可选 最多检查多少次 300次
callback_key 可选 检查什么条件算完成 done参数为true
api_token 可选 用于在网页查看任务状态 无
input_data 可选 多参数输入时使用 无

🔄参数传递流程说明

重要提醒：这是最容易出错的地方！请仔细阅读参数传递规则

📊 参数传递链条

1 等待狗 → 检查工作流：
等待狗的 input 参数 → 传递给检查工作流的 input 参数
2 检查工作流 → 回调工作流：
检查工作流的所有输出参数 → 自动传递给回调工作流的同名输入参数

🎯 关键配置要点

工作流 参数要求 说明
检查工作流 输入参数必须叫 input 接收等待狗传来的参数值
检查工作流 输出参数包含 done 用于判断任务是否完成
回调工作流 输入参数名要与检查工作流输出对应 自动接收检查工作流的输出

💡 实际案例演示

等待狗配置：
input: "table_123"
检查工作流：
输入参数：input (接收到 "table_123")
输出参数：done: true, video_url: "xxx.mp4", task_id: "456"
回调工作流：
输入参数：video_url, task_id (自动接收检查工作流的输出)
注意：参数名必须完全匹配！
调试技巧：在检查工作流中添加日志输出，确认参数传递是否正确

📋使用步骤

1 准备好你的工作流，并确保已发布
2 获取工作流ID（从URL中复制）
3 获取coze_token（从扣子平台申请）
4 检查参数传递配置（重要！）
5 配置等待狗插件参数
6 启动等待狗，坐等自动化完成！

⚠️重要注意事项

需要付费版本：免费版API调用次数有限制，建议升级到个人进阶版
工作流必须先发布：未发布的工作流无法通过API调用
检查频率：每1分钟检查一次，不是实时的
最大运行时间：最多1440次检查（约24小时）

🔍如何获取工作流ID？

打开你的工作流页面，URL格式如下：

https://www.coze.cn/work_flow?space_id=7391771569926127635&workflow_id=xxxxx

红色部分的 xxxxx 就是你的工作流ID

🔗相关链接

❓常见问题

Q: 为什么我的工作流调用失败？
A: 检查工作流是否已发布，coze_token是否有效，权限是否正确设置
Q: 可以同时运行多个等待狗吗？
A: 可以，但要注意API调用次数限制
Q: 如何知道任务是否在正常运行？
A: 填写api_token参数，然后访问任务状态页面查看
Q: 回调工作流没有被触发，怎么办？
A: 检查以下几点：
1. 检查工作流的输出参数是否包含 done: true
2. 回调工作流的输入参数名是否与检查工作流的输出参数名完全匹配
3. 检查工作流是否正确设置了输入参数 input

🎉 总结

定时器等待狗 = 自动化任务调度器
让你的工作流像流水线一样自动运行！