aiagent/工作流模板和导入导出功能说明.md

工作流模板和导入导出功能说明

✅ 已完成

已实现工作流模板功能、导入导出功能和执行历史优化。

功能特性

1. 工作流模板功能

预设模板

系统提供4个预设模板：

1. 简单LLM工作流 (simple_llm)

   • 开始 → LLM → 结束
   • 适合简单的LLM调用场景

2. 条件判断LLM工作流 (conditional_llm)

   • 开始 → 条件判断 → [True分支LLM / False分支LLM] → 结束
   • 适合根据条件调用不同LLM的场景

3. 数据转换+LLM工作流 (data_transform_llm)

   • 开始 → 数据转换 → LLM → 结束
   • 适合需要先转换数据再处理场景

4. 多LLM链式工作流 (multi_llm_chain)

   • 开始 → LLM1 → LLM2 → LLM3 → 结束
   • 适合需要多步LLM处理的场景

API端点

• GET /api/v1/workflows/templates - 获取模板列表
• GET /api/v1/workflows/templates/{template_id} - 获取模板详情
• POST /api/v1/workflows/templates/{template_id}/create - 从模板创建工作流

2. 工作流导入导出功能

导出工作流

API端点: GET /api/v1/workflows/{workflow_id}/export

响应格式:

{
  "id": "workflow-id",
  "name": "工作流名称",
  "description": "工作流描述",
  "nodes": [...],
  "edges": [...],
  "version": 1,
  "status": "active",
  "exported_at": "2024-01-17T01:00:00"
}

导入工作流

API端点: POST /api/v1/workflows/import

请求格式:

{
  "name": "导入的工作流",
  "description": "工作流描述",
  "nodes": [...],
  "edges": [...]
}

特性:

• 自动重新生成节点ID（避免ID冲突）
• 自动更新边的源节点和目标节点ID
• 自动验证工作流结构
• 验证失败时返回详细错误信息

3. 执行历史优化

分页功能

• skip: 跳过记录数（默认0）
• limit: 每页记录数（默认100，最大100）

筛选功能

• workflow_id: 按工作流ID筛选
• status: 按状态筛选（pending, running, completed, failed）

搜索功能

• search: 搜索关键词
• 搜索范围：执行ID、工作流ID、任务ID

API端点

GET /api/v1/executions?skip=0&limit=20&workflow_id=xxx&status=completed&search=keyword

使用示例

1. 获取模板列表

curl -X GET "http://localhost:8037/api/v1/workflows/templates" \
  -H "Authorization: Bearer {token}"

响应:

[
  {
    "id": "simple_llm",
    "name": "简单LLM工作流",
    "description": "一个简单的LLM调用工作流..."
  },
  ...
]

2. 从模板创建工作流

curl -X POST "http://localhost:8037/api/v1/workflows/templates/simple_llm/create?name=我的工作流" \
  -H "Authorization: Bearer {token}"

3. 导出工作流

curl -X GET "http://localhost:8037/api/v1/workflows/{workflow_id}/export" \
  -H "Authorization: Bearer {token}" \
  -o workflow.json

4. 导入工作流

curl -X POST "http://localhost:8037/api/v1/workflows/import" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d @workflow.json

5. 获取执行历史（带筛选和搜索）

curl -X GET "http://localhost:8037/api/v1/executions?skip=0&limit=20&status=completed&search=test" \
  -H "Authorization: Bearer {token}"

前端集成建议

模板选择界面

1. 显示模板列表（卡片式布局）
2. 点击模板查看详情
3. 一键从模板创建工作流

导入导出功能

1. 导出：

   • 在工作流详情页添加"导出"按钮
   • 点击后下载JSON文件

2. 导入：

   • 在工作流列表页添加"导入"按钮
   • 选择JSON文件上传
   • 显示导入结果

执行历史优化

1. 分页组件：使用Element Plus的Pagination组件
2. 筛选器：下拉选择状态、工作流
3. 搜索框：实时搜索
4. 表格：显示筛选和搜索后的结果

优势

1. 快速创建：使用模板快速创建工作流
2. 工作流复用：通过导入导出复用工作流
3. 高效查询：执行历史支持分页、筛选、搜索
4. 数据安全：导入时自动重新生成ID，避免冲突

后续计划

• 前端模板选择界面
• 前端导入导出功能
• 执行历史前端优化
• 模板市场（用户分享模板）
• 工作流版本对比

---

状态: ✅ 后端已完成 时间: 2024年