工作流

工作流是用自然语言聊天搭建的可复用 Minara 自动化。Agent 根据你 的提示起草工作流定义（步骤、触发器、通知渠道），你在聊天面板里 实时看着它构建，画布在草稿通过校验时更新。

工作流可以：

• 监控价格（BTC、AAPL、EUR/USD……），跨越阈值时提醒。
• 监控钱包、Polymarket 交易者、或链上事件，行为符合规则时通知你。
• 跑每日 / 每周 / cron 调度的投资组合简报。
• 下单（标准的"预览再确认"两步流程，绝不会有静默的资金变动）。

搭建一个工作流

两个入口：

• 着陆页表单。粘贴一段自然语言描述，提交后 agent 起草工作 流并在成功后保存。
• 工作流详情聊天面板。打开一个已有工作流，描述你想要的改 动（"在告警之后加一个邮件 send_message"、"把每小时改成每 天"），agent 重写定义。

两种方式都会在聊天界面实时流式展示工作日志。你能看到每个步骤 的原始 JSON 在模型生成时逐字出现，等步骤的必填字段全部到位后 立刻折叠成规范的卡片。只有当 agent 的草稿通过校验，画布才会 变化。

Agent 犯错时会发生什么

工作流写作子 agent 每次请求最多跑 3 轮。如果第一轮草稿有 断链（next 指向不存在的步骤）、缺必填字段（tool_call 没有 tool）、或条件表达式无法解析，结构校验器会捕捉到，聊天面板 把出错的草稿折叠成 Attempt 1 · fixed K issues 摘要，下 方打开一个新的 Attempt 2 ▪ ●●● building… 区段。

折叠的草稿不会被删。展开它能看到 agent 尝试了什么、以及导致 失败的结构化错误列表。你可以审计这次失误，但它不会污染当前视 图。

重试期间永远不会发生的三件事：

1. 画布绝不会从出错的草稿更新。 画布的真相来自 workflow.commit 事件，只有通过校验的那一轮才会触发。中间 的 workflow.patch 事件只是预览；画布会忽略它们。
2. 被丢弃的草稿不会以卡片形式进入聊天面板。 子 agent 在服 务端缓冲每轮的事件，校验失败就丢掉缓冲。只有通过校验那一 轮的卡片会进入聊天历史。
3. 保存下来的工作流定义永远不会是损坏的形状。 如果 3 轮都 失败，网关发出回滚事件并跳过持久化；你已有的定义保持原样。

画布上方的工具栏会反映当前阶段：第一轮时 Drafting…，进入 重试时 Retrying, attempt N of 3…，校验通过保存时 Saving…。聊天没结束之前 Run / Schedule / Publish 都保持禁 用。

编辑已有工作流

Refine 流程会保留你的现有参数。Agent 只动你消息里要求改动的 字段。未改动的步骤上的 token 地址、webhook ID、自定义参数值、 条件表达式都按原样穿过。如果你只是要改通知渠道， tool_call 步骤里的地址不会被顺手改掉。

如果你的请求缺一个 agent 构建可运行工作流必需的参数（你没指 定的链、你还没连接的 provider），它会返回一句简短的助手消息 问你缺什么，而不是猜。不会有静默的零地址占位符，也不会有 "你没说我就默认用 ETH" 的意外。

流中刷新

在 refine 流式输出过程中刷新聊天面板，会重新连接到正在进行的 会话，并回放已经落地的事件。已折叠的草稿区段以你之前看到的样 式重新载入；工作日志骨架图会在聊天历史加载完成的那一刻清掉， 就算底层的 refine 还在某一轮中间。

顺序执行模型

每个工作流都按顺序运行。没有数组形式的 next，没有原生 fan-out，没有并行分支。如果你让 agent "告警之后同时发 Telegram 和邮件"，它会串行：notify_tg → notify_email。实 际上两个连续的 send_message 之间的延迟在亚秒级，从用户视角 看和并行没区别。

这是有意为之。fan-out 语义会给监控工作流引入双触发的 bug （价格监控 webhook 在波动期间触发两次，如果工作流有并行分支 就会触发两次 buy）。顺序模型 + 资金动作步骤上的持仓检查， 保证了失败模式的简单可控。