Zapier Workflows Create 是一个面向 Zapier 平台的技能,用于从自然语言描述创建完整的持久化工作流,并通过 Zapier SDK 的实验性 Code Workflows 命令进行测试和部署。该技能基于 @zapier/zapier-durable 和 Zapier SDK CLI,要求使用公开的 SDK CLI 路径,不使用 zapier-sdk-code-substrate。
用途 该技能适用于用户希望构建 Zapier 工作流的场景。它从用户的自然语言请求中提取工作流的结构,包括步骤与顺序、涉及的应用、步骤间传递的数据、手动输入字段或触发输入字段、条件逻辑、等待/回调/人工审批门,以及起始模式。在发现阶段之前,技能会向用户总结拟议的工作流,并针对缺失的细节(如目标频道、文件夹、收件人,或搜索无结果时是否停止)提出聚焦的澄清问题。在用户同意工作流形态之前,不会生成代码。
主要能力 技能能够通过 Zapier SDK CLI 发现应用、连接、动作、触发器和字段,支持列出应用、连接、动作、动作输入字段、动作输入字段选项,以及实验性的触发器发现命令。对于 AI 步骤,技能要求使用 "AI by Zapier"(应用键 AICLIAPI),并选择其中的模型;如果用户指定了提供商或模型,则设置相应的 model_id,否则使用默认模型。它运行在 Zapier 内置的 AI 凭据上,无需第三方账户,并按正常 Zapier 任务计费。技能还支持为每个选定的连接分配简短的 snake_case 连接别名,并跟踪别名到连接 ID 的映射。
使用方式 使用前需运行 workflows-doctor 兼容性检查。如果 workflows-doctor 未安装或无法加载,需先运行 workflows-install 或从 zapier/agent-skills 安装 workflows-doctor。如果 workflows-doctor 报告 SDK/技能漂移,需遵循其刷新说明,停止当前技能调用,必要时重新加载代理工作区,并请用户重新运行原始请求。
前置条件包括验证 zapier-sdk 的版本、获取配置文件、查看实验性帮助,以及 create-workflow、publish-workflow-version、run-durable、list-triggers、trigger-workflow 等命令的帮助。用户还需在 https://zapier.com/app/assets/connections 配置应用连接。
工作流分为多个阶段:阶段1理解意图并分类起始模式(trigger 或 manual,必须明确选择);阶段2发现应用、连接、动作、触发器和字段;阶段3确认构建计划;阶段4生成工作流项目,创建包含 package.json 和 workflow.ts 的目录。workflow.ts 需从 @zapier/zapier-durable 导入 defineDurable,从 @zapier/zapier-sdk 导入 createZapierSdk,并在模块级别创建 SDK 客户端。
依赖版本方面,@zapier/zapier-durable 和 @zapier/zapier-sdk 可使用 latest,平台会在服务端解析为通过24小时门槛的最新版本。其他依赖需指定精确版本,例如 zod 使用 4.3.6。范围版本(如 ^1.2.3、~1.2)会被拒绝。生成的 workflow.ts 导入的每个包都必须出现在 --dependencies 中。
适用场景 适用于需要从自然语言构建 Zapier 工作流的用户,包括定时触发、事件驱动触发或手动按需运行的工作流。支持涉及多个应用、条件逻辑、等待和人工审批的复杂流程。对于 AI 步骤,推荐使用 "AI by Zapier",除非用户明确要求独立的提供商应用或需要 "AI by Zapier" 不具备的能力。
限制 技能要求用户必须明确起始模式,不能因为未命名触发器就默认手动。发布触发器时,selected_api 必须使用版本固定的实现标识符(如 GoogleSheetsAPI@2.3.0),不能使用裸应用键或显示名称,否则触发器声明会在发布时静默失败。params 中字段的值类型必须匹配,ARRAY 字段必须是 JSON 数组,STRING 字段必须是普通字符串。对于 "Webhooks by Zapier" 和其他具有 catch-hook 触发器的应用,需通过发现确认其动作键、认证和参数要求,不能一概而论。技能不编造应用版本,如果发现未暴露实现/版本绑定,则省略 --app-versions。