Swamp 自动化调度完整指南：Schedule 定时、Webhook 触发与手动运行 3 种触发方式详解

【免费下载链接】swampStinemates, Watson, Adam, Mahir, Paul项目地址https://gitcode.com/gh_mirrors/swamp3/swamp点击查看免费下载Swamp 是一个帮你把 AI agent 的重复劳动沉淀为可复用 workflow 的开源自动化框架。这篇文章面向新手讲透 Swamp 自动化的 3 种触发方式swamp workflow run手动运行、cron 定时Schedule和 Webhook 事件触发并给出暂停/恢复定时、配置触发参数等常用操作让你的 workflow 该跑就跑、该停就停。3 种触发方式总览在 Swamp 中一个 workflow 由若干 job 和 step 组成每次执行都会生成一条可审计的运行记录Workflow Run并标记triggerSourceapi、schedule或webhook。3 种触发方式对比如下触发方式适用场景核心命令/配置典型例子手动运行临时执行、调试swamp workflow run手动触发一次 CVE 扫描Schedule 定时周期性任务workflow YAML 中的trigger.schedule每天凌晨 3 点跑巡检Webhook 触发外部事件驱动swamp serve --webhook收到 Linear 事件即处理 三种方式最终走的是同一条执行链路运行数据、审批、审计完全一致区别只在于谁在什么时机按下启动键。方式一手动运行 workflow最直接的触发方式适合调试和一次性任务# 基础运行 swamp workflow run my-workflow # 传入输入参数keyvalue 形式 swamp workflow run scan-cves --input projectmy-app # 通过运行中的 swamp serve 触发 swamp workflow run my-workflow --server http://localhost:8787手动运行由你本人作为发起人initiatedBy输入通过--input逐个提供适合需要临场指定参数的场景。相关实现见 src/cli/commands/workflow_run.ts。方式二Schedule 定时触发cron这是 Swamp 自动化调度的主力。在 workflow YAML 的trigger块里声明 cron 表达式即可name: nightly-gc trigger: schedule: 0 3,12 * * * # 每天 3 点和 12 点各跑一次 jobs: # ...cron 表达式规则速查采用 croner 语法标准 5 段分、时、日、月、星期6 段时秒在最前支持daily之类的别名表达式在解析 workflow 时即校验写错会直接报错swamp serve 的调度行为swamp serve启动时会注册所有带schedule的 workflow几个关键特性值得注意热加载watcher 监听 workflows 目录增删改 schedule 无需重启防重叠同一 workflow 上一轮还没跑完下一次触发会跳过并告警不补跑serve 停机期间错过的触发不会补发重启后等下一个自然 cron 点可关闭--no-schedule一键禁用定时执行给定时运行注入输入参数定时触发没有--input标志需要输入值时用trigger.inputs提供基线输入trigger: schedule: * * * * * inputs: projectId: a6b254a2-0b57-4d0f-bf8b-fef767ab119e参数合并优先级为调用方输入 trigger.inputs 输入 schema 默认值。完整说明见 design/primitives/workflows.md。不改 workflow 文件的触发覆盖Trigger Override扩展Extension内置的 workflow 是只读的改不了 YAML。Swamp 提供.swamp/serve.yaml的triggers覆盖机制并配了专门的 CLI# 设置覆盖schedule 为替换语义可附带固定输入 swamp workflow trigger set scan-cves --schedule 0 3 * * * --input channel#security # 查看生效的触发配置内置 覆盖合并结果 swamp workflow trigger get scan-cves # 删除覆盖 swamp workflow trigger remove daily-report优先级规则serve.yaml 覆盖 workflow YAML 内置 trigger。命令实现见 src/cli/commands/workflow_trigger_set.ts。一键暂停 / 恢复 / 查看定时任务排查故障时想临时掐掉某个定时任务不用改文件# 故障期间暂停可注明原因和自动恢复时间 swamp workflow schedule pause nightly-gc --reason stalling serve, see #3518 swamp workflow schedule pause nightly-gc --until 2h # 恢复 swamp workflow schedule resume nightly-gc # 列出所有定时任务cron、下次触发时间、暂停状态 swamp workflow schedule list暂停只影响定时触发手动和 Webhook 触发照常运行。实现见 src/cli/commands/workflow_schedule_pause.ts。方式三Webhook 事件触发让外部系统一有风吹草动就跑你的 workflow。通过swamp serve注册一条 POST 路由并绑定工作流swamp serve --webhook /hooks/linear:triage-issue:my-secret:linear参数格式为route:workflow:secret[:scheme[:header[:prefix]]]也可以写进serve.yaml的webhooks[]列表。内置签名校验方案包括github、jira、linear、stripe、slack和通用genericheader prefix方案其他平台可加载 webhook 扩展类型如swamp/telegram。从请求体里提取输入Webhook 运行可用webhook命名空间读取已校验的请求内容把 payload 字段映射成 workflow 输入trigger: inputs: identifier: ${{ webhook.body.data.issue.identifier }} eventType: ${{ webhook.headers[x-linear-event] }}可用的字段webhook.bodyJSON 解析后的请求体、webhook.headers小写化 header、webhook.route匹配到的路由。Webhook 的安全与可靠性✅签名校验先行校验失败直接拒绝hook 逻辑只在验证后运行✅密钥多种来源secret 支持envVAR、file/path、vaultvault:key引用✅崩溃可重放已验证的请求先落为 pending run 再执行进程崩溃后下次启动自动重放✅独立身份每次运行以内置service:webhook身份执行并独立鉴权配合访问控制即可精确限定webhook 允许做什么调度器与 Webhook 服务的完整设计见 design/primitives/serve.md调度核心在 src/libswamp/workflows/scheduled_execution.tsWebhook 服务在 src/serve/webhook.ts。3 种方式怎么选调试、一次性操作→swamp workflow run灵活传参每天/每周固定巡检、报告→trigger.schedule配合swamp workflow schedule pause/resume/list管理被外部事件驱动issue 来了、支付成了、告警响了→ Webhook天然实时三者可自由组合同一个 workflow 既可以被定时触发也可以挂 Webhook 路由还能随时手动补跑一次。 掌握这 3 种触发方式你就把 Swamp 的自动化能力用满了——把重复的事交给 workflow把注意力留给真正重要的判断。更多用法可阅读 design/primitives/workflows.md 中 Workflow Triggers 一节。赞分享【免费下载链接】swampStinemates, Watson, Adam, Mahir, Paul项目地址https://gitcode.com/gh_mirrors/swamp3/swamp点击查看免费下载相关推荐Quoroom任务调度完全指南cron定时、一次性、按需与Webhook触发4种执行方式Quoroom任务调度完全指南cron定时、一次性、按需与Webhook触发4种执行方式 Quoroom 是一个开源的、以赚钱为目标的 AI 蜂群智能sSpacetimeDB 调度表Schedule Tables完整指南用 scheduled 列触发定时 Reducer 与 ProcedureSpacetimeDB 调度表Schedule Tables完整指南用 scheduled 列触发定时 Reducer 与 Procedure 本篇指南以数据库关系型数据库后端实时分析视频字幕不同步怎么办卡卡字幕助手 VideoCaptioner 同步校准完整指南视频字幕不同步怎么办卡卡字幕助手 VideoCaptioner 同步校准完整指南 播放到第 5 分钟字幕比台词快了半拍拖到片尾错位越来越明显。或者反过来音视频AI 应用语音上一篇WeChatInterceptMac微信防撤回终极解决方案下一篇OpenBot Hiring Scorecard 技能实战用结构化面试记分卡把招聘评估锚定在证据上创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考