# Gaia · 可视化 AI 工作流编辑器
**可视化构建 AI 工作流，基于 [flowgram.ai](https://github.com/bytedance/flowgram.ai) 驱动。**
[](https://github.com/boommanpro/gaia-workflow-engine/stargazers)
[](https://opensource.org/licenses/MIT)
[](https://github.com/boommanpro/gaia-workflow-engine/releases)
[](https://boommanpro.github.io/gaia-workflow-engine/)
**[English](./README.en.md)** · **[简体中文](./README.md)**
---
一个现代化的可视化规则引擎平台，用于编排复杂的 AI 工作流。在无限画布上设计、测试和部署 AI 流程——无需编写代码。结合 [flowgram.ai](https://flowgram.ai) 的能力与 Java 服务端，提供生产级工作流管理。
## 功能特性
- **AI Agent 侧栏对话** — 对话式生成工作流：CreatePlan 分步规划、Canvas 自动创建节点/连线、HTTP/Query 查询工作流、实时预览 token 与计划进度；会话可重命名、可审查。
- **Agent 配置中心** — 模型参数（Host/Key/Temperature/Max Tokens）、默认执行引擎切换（内置 AgentScope / 火山方舟托管）、系统提示词与知识库、工具定义目录。
- **执行追踪（对标 OpenWorkBuddy）** — 管理端 `/manage/traces`：统计卡（跑完/出过错/还在跑/中断/累计 Token）+ 任务列表 + 单趟任务详情（7 格指标条、模型 chips、逐步可折叠时间线、完整提示词与最终回复）；数据由事件日志 + LLM 调用账本 + 工具指标合成（`AgentTraceService`）。
- **可视化画布** — 无限缩放画布，支持拖拽节点。通过循环、分支和条件逻辑设计复杂的工作流。
- **AI 节点类型** — 内置 LLM 调用、代码执行、HTTP 请求、字符串格式化和变量管理节点。
- **实时预览** — 测试单个节点或整个工作流，实时查看输入输出和执行历史。
- **版本管理** — 每次保存创建一个版本。在版本间切换、追踪变更、一键回滚。
- **模板系统** — 创建可复用的工作流模板。一键从模板创建新工作流。
- **可扩展插件** — 小地图、自动布局、吸附线、节点面板等。
- **多条件节点** — 同步官方 flowgram.ai，支持复杂分支逻辑。
## 截图
### 工作台与工作流
| 页面 | 预览 |
|------|------|
| **首页** — 国际化产品介绍页 |  |
| **在线演示** — 可交互工作流画布（可拖拽、可新增节点、不可运行） |  |
| **文档** — 快速开始、环境准备、部署方案 |  |
| **编辑器** — 可视化工作流编辑器，含版本管理 |  |
| **管理后台 · 工作流** — 工作流管理控制台 |  |
| **管理后台 · 模板** — 模板管理控制台 |  |
| **发布日志** — 版本历史时间线 |  |
### AI Agent
| 页面 | 预览 |
|------|------|
| **AI Agent 对话** — 侧边栏对话式生成工作流，CreatePlan 分步规划 + 步骤执行卡片 |  |
| **调试信息面板** — 原始请求/响应、SSE Event、Context 详情、Raw JSON，点击消息跳转定位 |  |
| **Agent 配置中心 · 模型** — API Host/Key、模型参数、Embedding 向量检索（BGE） |  |
| **Agent 配置中心 · 提示词** — 默认系统提示词 + 工具集定义（navigate/query/manage/canvas） |  |
| **Agent 执行工作流** — 在画布上自动创建节点与连线，逐步测试并执行 |  |
## 快速开始
### 环境准备
| 要求 | 版本 |
|------------|---------|
| Node.js | >= 18 |
| Java | >= 17 |
| Maven | 3.x |
| Git | 任意 |
### 前端运行
```bash
git clone https://github.com/boommanpro/gaia-workflow-engine.git
cd gaia-workflow-engine/apps/console
npm install
npm run dev
```
访问