SuperAPI AI 工具集

write-flow

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:在 Windmill 中创建与迭代流程(flow)。核心要求是由 AI 代理自己执行 wmill flow new <path> 生成目录与最简 flow.yaml,不要手工创建文件夹和 flow.yaml,也不要让用户自己去跑命令。需先向用户确认 path(如 f/folder/my_flow)和 summary,缺则一次性询问,不得猜测。可加 --description 保存更长说明。

主要能力与结构规则:flow.yaml 的 value.modules 仅放普通顺序步骤;预处理模块与失败处理模块须分别写成 value.preprocessor_module、value.failure_module(id 固定为 preprocessor、failure),不能塞进 modules。preprocessor_module 与 failure_module 只支持 script 或 rawscript,前者不能引用 results.*,后者可用 error.message、error.step_id、error.name、error.stack。模块 id 全流程唯一、用下划线。rawscript 内容用 !inline path/to/script.ts,文件名不带 .inline_script.。步骤间可用 flow_input.property、results.step_id、results.step_id.property 传值,只能引用已执行步骤。

AI 代理模块:aiagent 的 provider 是对象 {kind, resource, model},需配 input_transforms(如 user_message、system_prompt、output_type)。工具条目 tool_type 可为 flowmodule、mcp、websearch;flowmodule 工具的 summary 即代理调用的工具名,须匹配 ^[a-zA-Z0-9_]+$ 且避开保留名(do、bg、ctx、state、if、else、for、delete、while、new、in、failure、preprocessor、as、Input、Result、Trigger),description 写用途说明。聊天流程设 chat_input_enabled: true,需必填 user_message 字符串输入;memory 保留历史,streaming 逐字输出,user_attachments 对应 s3 对象数组输入;运行时需 memory_id 查询参数,新 UUID 开新会话。

预览、运行与部署:本地迭代用 wmill flow preview <flow_path>,可加 --remote 用已部署脚本,或 --step <step_id> 只跑单步(branchone/branchall/forloopflow/whileloopflow、identity、AI 代理步骤本身不能单独测)。已部署版本用 wmill flow run <path>。wmill generate-metadata 只生成本地 .lock 与哈希、不部署,建议先 --dry-run 查看变化。仅 wmill sync push 或 git push 属于部署,须用户明确要求才执行。preview 安全可自行运行;打开可视化预览与运行命令前应以一句话征求用户同意。资源输入用 "$res:<path>",变量用 "$var:<path>"。

限制:资料未提供价格、平台支持范围与具体步骤示例之外的细节。