flowsea 文档

5 分钟快速上手

1. 访问 https://flowsea-app.hxu92521.workers.dev/(后续切换到自己域名)
2. 用邮箱注册 → 自动创建你的 workspace
3. 点首页推荐的 「Shopify 新订单 → Gmail + Sheets」 模板
4. 授权连接你的 Shopify / Gmail / Google Sheets 账号
5. 点 「开启工作流」,以后新订单全自动跑

建立第一个工作流(不用模板)

从零搭工作流的步骤:

1. 点 新建工作流
2. 选触发器(eg. Shopify 新订单 / Webhook / Schedule)
3. 授权对应账号
4. 添加步骤(eg. Gmail 发邮件)
5. 每个步骤的字段用 {{trigger.email}} 这种语法引用上一步
6. 点 测试运行,确认无误后开启

使用模板

模板是预建好的工作流,你只需:① 一键导入到你的 workspace ② 修改少数变量(API key 等)③ 开启。每个模板带 5-10 分钟视频教程。

浏览全部 100+ 模板:/templates

OAuth 连接 SaaS(授权流程)

每个 SaaS 第一次用时,系统会引导你授权:

1. 点该步骤的 连接 →
2. 跳到 SaaS 官方授权页(eg. Google / Stripe)
3. 授权 flowsea 读 / 写权限
4. 跳回 flowsea,显示 ✅ 已连接

连接管理:左侧菜单 连接 → 看所有授权,可解绑或重新授权。

使用国产 LLM(DeepSeek / Kimi / 通义)

立即可用方案:不用等 flowsea 中文化版本,在当前 Activepieces 用 HTTP 节点 直接调国产 LLM,几分钟搞定。

方案 A:HTTP 节点直调(立即可用)

1. 添加 HTTP 节点 → Method 选 POST

2. 按 LLM 选 URL:

• DeepSeek: https://api.deepseek.com/v1/chat/completions
• Kimi: https://api.moonshot.cn/v1/chat/completions
• 通义: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

3. Headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

4. Body(JSON):

{
  "model": "deepseek-chat",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant"},
    {"role": "user", "content": "{{trigger.email_body}}"}
  ],
  "max_tokens": 2000
}

5. 返回结果用 {{steps.http.body.choices[0].message.content}} 引用

方案 B:OpenAI 节点改 baseUrl(部分版本支持)

DeepSeek/Kimi/通义 都兼容 OpenAI API 格式。在 OpenAI 节点连接配置里把 baseUrl 改为对应 endpoint 即可(部分 Activepieces 版本不支持自定义 baseUrl)。

方案 C:flowsea 原生 piece(M2+ fork 后)

flowsea 计划在 fork Activepieces 后内置 DeepSeek / Kimi / 通义 三个原生 piece(代码已写好,见 GitHub 私有 repo server-config/pieces/)。届时直接选节点 + 填 API key,不用写 HTTP 请求。

API key 哪里申请

用代码节点(高级)

预建节点不够用?用 Code 节点 写 JavaScript / Python:

// JavaScript code node 示例
const orders = inputs.shopifyOrders;
const total = orders.reduce((sum, o) => sum + o.total_price, 0);
return { totalRevenue: total };

定时触发(Schedule)

用 Schedule 触发器替代手动:

• 每天 9 点
• 每周一 10 点
• 每 5 分钟
• cron 表达式自定义

常见错误

"Connection expired"

OAuth 过期了。去 连接管理 重新授权。

"Rate limit exceeded"

调用 SaaS API 频率过高。在节点设置加 延迟(eg. 每次调用之间停 1 秒)。

"Out of execution quota"

本月执行次数用完了。免费版 1000 次/月,升级套餐或等下个月重置。加客服微信升级

性能优化

• 把多个 HTTP 请求合并成一个 batch 节点
• 大数据量用 Loop 节点分批跑
• 避免每次工作流都跑 LLM,用 KV 缓存
• Webhook 触发比 Schedule 拉更省执行次数