FlowGram 工作流开发框架

FlowGram 工作流

字节跳动出品 —— 用 FlowGram 搭建你自己的 AI 工作流平台。

这是什么？适合谁？

FlowGram 是字节跳动开源的可扩展工作流开发框架，内置画布、表单、变量、节点等组件，帮助开发者快速构建类似 n8n、Dify 的 AI 工作流平台。MIT 开源，GitHub 8.2K+ stars。

适合谁？一是需要自建工作流平台的团队；二是需要高度定制化工作流引擎的企业；三是想学习工作流引擎设计的开发者。不适合：只想使用现成工作流工具的用户（直接使用 n8n/Dify）。

准备工作

• 安装：npm install @flowgram/core
• 环境：Node.js 18+
• 前置知识：TypeScript/React 基础

5 步核心流程

第 1 步：安装

npm install @flowgram/core @flowgram/canvas

第 2 步：创建画布

import { FlowGram } from '@flowgram/core';
const flowgram = new FlowGram({ container: '#app' });

第 3 步：添加节点

flowgram.addNode({ type: 'llm', config: { model: 'gpt-4o' } });
flowgram.addNode({ type: 'http', config: { url: 'https://api.example.com' } });

第 4 步：连接节点

通过拖拽或代码连接节点，构建工作流。

第 5 步：执行工作流

const result = await flowgram.execute();
console.log(result);

常见踩坑

踩坑 1：React 版本不兼容

• 症状：画布渲染异常
• 原因：FlowGram 依赖特定 React 版本
• 解决：检查 peerDependencies，确保 React 版本匹配

踩坑 2：自定义节点复杂

• 症状：自定义节点开发困难
• 原因：节点开发需要理解 FlowGram 内部架构
• 解决：参考官方示例和文档

参考链接

• FlowGram GitHub
• FlowGram 文档