From 86fe398908def43a2a3cc3805e50b9fbae6b1d20 Mon Sep 17 00:00:00 2001 From: renjianbo <18691577328@163.com> Date: Tue, 20 Jan 2026 18:06:33 +0800 Subject: [PATCH] =?UTF-8?q?=E9=8F=87=E5=AD=98=E6=9F=8A=E9=8F=82=E5=9B=A8?= =?UTF-8?q?=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .obsidian/workspace.json | 62 +- ...pstore.appclaim.signature.verification.apk | Bin 0 -> 1227 bytes docs/Obsidian笔记体系/Daily/2026-01-20.md | 233 ++ .../aiapply/# 工作流和Agent平台架构方案分析.md | 1399 ++++++++ .../saars开发/aiapply/Agent和模板节点的区别.md | 64 + .../saars开发/aiapply/android应用agent.md | 89 + .../saars开发/aiapply/内容生成助手Agent.md | 71 + .../aiapply/工作流和Agent平台提示词目录.md | 1241 +++++++ .../Projects/saars开发/aiapply/工作流测试工具.md | 2 + .../工作流(Workflow)vs Agent(智能体)的区别.md | 226 ++ .../智能需求分析与解决方案生成器_使用说明.md | 539 +++ .../Projects/saars开发/aiapply/未命名 1.md | 1720 +++------ .../Projects/saars开发/aiapply/未命名 2.md | 2739 +++++++++++++++ .../Projects/saars开发/aiapply/未命名 3.md | 43 + .../Projects/saars开发/aiapply/未命名 4.md | 23 + .../Projects/saars开发/aiapply/未命名 5.md | 84 + .../Projects/saars开发/aiapply/未命名 6.md | 57 + .../Projects/saars开发/aiapply/未命名 7.md | 970 ++++++ .../Projects/saars开发/aiapply/未命名.md | 3084 ++++++++++++++++- .../aiapply/电商系统用户订单处理流程设计方案.md | 97 + .../节点配置中的温度和最大Token数是什么意思?.md | 115 + .../saars开发/aiapply/项目低代码智能体功能扩展.md | 183 + .../Projects/知你-调测/知你--调测.md | 4 + mkdocs.yml | 18 + 24 files changed, 11749 insertions(+), 1314 deletions(-) create mode 100644 com.xiaomi.appstore.appclaim.signature.verification.apk create mode 100644 docs/Obsidian笔记体系/Daily/2026-01-20.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/# 工作流和Agent平台架构方案分析.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/Agent和模板节点的区别.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/android应用agent.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/内容生成助手Agent.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流和Agent平台提示词目录.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流测试工具.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流(Workflow)vs Agent(智能体)的区别.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/智能需求分析与解决方案生成器_使用说明.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 2.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 3.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 4.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 5.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 6.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 7.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/节点配置中的温度和最大Token数是什么意思?.md create mode 100644 docs/Obsidian笔记体系/Projects/saars开发/aiapply/项目低代码智能体功能扩展.md diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 0041d58..9e3414b 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -27,12 +27,12 @@ "state": { "type": "markdown", "state": { - "file": "docs/技术面试问题回答.md", + "file": "docs/Obsidian笔记体系/Daily/2026-01-20.md", "mode": "source", "source": false }, "icon": "lucide-file", - "title": "技术面试问题回答" + "title": "2026-01-20" } } ], @@ -68,7 +68,7 @@ "state": { "type": "search", "state": { - "query": "", + "query": "签名", "matchingCase": false, "explainSearch": false, "collapseAll": false, @@ -200,41 +200,41 @@ }, "active": "25c9f7051aac05b3", "lastOpenFiles": [ - "docs/android面试/系统原理/PMS常见面试题.md", - "docs/android面试/系统原理/DPMS常见面试题.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 7.md", + "docs/Obsidian笔记体系/Daily/2026-01-20.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/节点配置中的温度和最大Token数是什么意思?.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流和Agent平台提示词目录.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流测试工具.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流(Workflow)vs Agent(智能体)的区别.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/# 工作流和Agent平台架构方案分析.md", + "docs/cursor/cursor.md", + "docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md", + "com.xiaomi.appstore.appclaim.signature.verification.apk", + "docs/Obsidian笔记体系/Areas/07-系统安全/权限管理框架.md", + "docs/Obsidian笔记体系/Areas/04-资源与包管理/动态加载与热修复原理.md", + "docs/Google开发文档体系/最佳实践/安全最佳实践.md", + "docs/Obsidian笔记体系/Daily/2026-01-13.md", + "docs/Obsidian笔记体系/Daily/2026-01-14.md", + "docs/Obsidian笔记体系/Daily/2026-01-15.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 2.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/android应用agent.md", + "docs/git/git设置用户名和邮箱.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 6.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 5.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/内容生成助手Agent.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/智能需求分析与解决方案生成器_使用说明.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/Agent和模板节点的区别.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md", + "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 4.md", "docs/android面试/系统原理/DPMS常见面试题", "docs/DPMS常见面试题", - "docs/android面试/系统原理/AMS面试.md", "ams常见面试题.txt", - "docs/android面试/系统原理/WMS面试.md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 1.md", - "docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md", "docs/Obsidian笔记体系/Projects/saars开发/aiapply", - "docs/dify/管理员账户.md", - "docs/dify/用户注册及添加成员.md", - "docs/dify/密码输入错误次数超过限制时的机制.md", - "docs/dify/使用dify,可以生成一个专项事务助手吗,比如公司正规化事务助手.md", - "docs/dify/作为安卓高级开发工程师,除了项目管理,你完全可以在技术专项、团队效能和个人成长三大领域构建更懂你的专属助手.md", - "docs/Obsidian笔记体系/Areas/09-调试与工具链/Systrace_Perfetto全解读.md", - "docs/技术面试问题回答.md", - "docs/Google开发文档体系/视频和教程/技术会议.md", - "docs/Google开发文档体系/视频和教程/官方视频教程.md", - "docs/Google开发文档体系/视频和教程/在线课程.md", - "docs/Google开发文档体系/核心主题/用户界面.md", - "docs/Google开发文档体系/核心主题/测试.md", - "docs/Google开发文档体系/核心主题/数据存储.md", - "docs/Google开发文档体系/核心主题/性能优化.md", - "docs/Google开发文档体系/核心主题/应用架构.md", - "docs/Google开发文档体系/核心主题/安全与隐私.md", - "docs/Google开发文档体系/核心主题/应用基础.md", - "docs/Google开发文档体系/核心主题/后台任务.md", - "docs/Google开发文档体系/核心主题/Material_Design.md", - "docs/Google开发文档体系/核心主题/Jetpack组件.md", "docs/Google开发文档体系/视频和教程", "docs/Google开发文档体系/核心主题", "docs/Google开发文档体系/示例代码", "docs/Google开发文档体系/最佳实践", - "docs/Google开发文档体系/工具和资源", - "docs/Google开发文档体系/入门指南" + "docs/Google开发文档体系/工具和资源" ] } \ No newline at end of file diff --git a/com.xiaomi.appstore.appclaim.signature.verification.apk b/com.xiaomi.appstore.appclaim.signature.verification.apk new file mode 100644 index 0000000000000000000000000000000000000000..95d4f31b8cb8d0578f36585a041f2d259f633cec GIT binary patch literal 1227 zcmV;+1T_0lO9KQH00ICA002NC0K*K7`@!fO2d(QpUrjfy; zED&GeAK~aA4{v&$5svZu*6 zz1U1I!gY>pu-;-GAw7;#p-!8SRuRYId74(sY;8-fvHf9Z_EtULvR~(|<1QB2Ug!GW z(UFF16Y8DEM{*{B`$2|nU_2EB6GWB>i8O+s%K97PTjD$7d*WAOBOL^rM47nH{*SB? z63rp@aA`v?O}dB`c@5TZN@U(`arorUVW20(jz*4SYD-=8&z(Y z^=mPgn^NwG{{1)HfX1;be|ws7jB6YzCyta8$B1%ihclXK%{A+3nK>3%A9VN$og;AO z;J*bpra2sQ^aedYt2fkz-f`7C?&uxrpf}uw-U-z^;piRdpf}Qm-lXbHI(nlW^v1f- zn^L_gM{hhq?~$&xjmxJZs^VY=j3*Ne0{(bN53q0Pw zl`jBLO928G0~7!P00;m8Kp_Cb49+k^1ONco3;+NV000000000003ZOifdBvi06}hK pa&Kv5O<`_nW@U49E_iKhP)h{{000000RRC2K>z>%bOZnZ001Z#N0$Hq literal 0 HcmV?d00001 diff --git a/docs/Obsidian笔记体系/Daily/2026-01-20.md b/docs/Obsidian笔记体系/Daily/2026-01-20.md new file mode 100644 index 0000000..651e373 --- /dev/null +++ b/docs/Obsidian笔记体系/Daily/2026-01-20.md @@ -0,0 +1,233 @@ +## 基本信息 +- **日期**: 2026-01-20 +- **星期**: 星期二 +- **天气**: 雪 +- **心情**: 良好 + +## 今日计划 + +### 工作安排 +- [ ] 智能体平台 +- [ ] + +### 学习计划 +- [ ] ### 高优先级(建议优先开发) + +#### 1. 监控和告警前端界面 + +- 后端已完成(告警规则API、告警服务、告警日志API) + +- 前端待开发: + +- 系统监控面板(系统资源、执行统计、实时看板) + +- 告警规则管理页面(列表、创建/编辑、启用/禁用) + +- 告警日志页面(历史列表、详情查看、通知配置) + +- 预计工作量:1-2周 + +#### 2. 用户体验优化 + +- 工作流编辑器: + +- 节点对齐和自动布局 + +- 工作流模板快速应用 + +- 节点搜索和筛选 + +- Agent使用体验: + +- Agent快速测试功能 + +- Agent使用统计和分析 + +- 预计工作量:1-2周 + +### 中优先级(按需开发) + +#### 3. 性能优化 + +- 工作流执行性能优化(并发执行、缓存) + +- 前端性能优化(懒加载、虚拟滚动) + +- 数据库查询优化 + +- 预计工作量:1-2周 + +#### 4. 生产环境部署配置 + +- Docker/K8s配置 + +- Prometheus + Grafana监控 + +- ELK日志聚合 + +- CI/CD流程 + +- 预计工作量:2-3周 + +### 低优先级(长期规划) + +#### 5. 多租户支持 + +- 租户隔离和管理 + +- 资源配额管理 + +- 预计工作量:3-4周 + +#### 6. 插件系统 + +- 插件注册机制 + +- 自定义节点插件开发框架 + +- 插件市场 + +- 预计工作量:4-6周 + +## 项目完成度 + +- 核心功能:100%(工作流、Agent、执行引擎等) + +- 监控告警前端:0%(后端已完成,前端待开发) + +- 用户体验优化:60%(基础功能完成,高级功能待开发) + +- 高级功能:0%(多租户、插件系统) + +- 部署运维:30%(开发环境完成,生产环境待完善) + +整体完成度:约 85-90% + +## 近期开发建议 + +接下来1-2个月的重点: + +1. 完成监控和告警前端界面(提升可观测性) + +2. 优化用户体验(提升使用体验) + +3. 完善生产环境部署配置(准备上线) + +核心功能已基本完成,系统可正常使用。建议优先完善监控告警前端和用户体验优化,再推进生产环境部署配置。 + + +### 其他计划 +- [ ] 其他事项1 + +## 工作记录 + +### 已完成 +- ✅ 知你--会员功能开发 + - 时间: HH:MM - HH:MM + - 内容: + - 收获: + +- ✅ 知你--聊天会话界面跑马灯温馨提示 + - 时间: HH:MM - HH:MM + - 内容: + - 收获: +### 进行中 +- 🔄 进行中事项1 + - 开始时间: HH:MM + - 当前进度: + - 遇到的问题: + - 下一步计划: + - 继续知你--会员功能开发 + +### 待处理 +- ⏳ 待处理事项1 + - 计划时间: HH:MM + - 优先级: 高/中/低 + +## 学习记录 + +### 技术学习 +- **学习内容**: +- **学习时间**: HH:MM - HH:MM +- **学习方式**: 阅读/实践/视频 +- **关键收获**: +- **相关链接**: [[相关文档]] + +### 源码阅读 +- **阅读模块**: +- **阅读时间**: HH:MM - HH:MM +- **关键理解**: +- **疑问**: +- **相关链接**: [[相关源码]] + +### 问题解决 +- **问题描述**: +- **解决过程**: +- **解决方案**: +- **经验总结**: +- **相关链接**: [[相关文档]] + +## 会议记录 + +### 会议1 +- **时间**: HH:MM - HH:MM +- **主题**: +- **参与人**: +- **关键内容**: +- **行动项**: +- **相关链接**: [[会议记录]] + +## 思考与总结 + +### 今日收获 +1. 收获1 +2. 收获2 +3. 收获3 + +### 今日反思 +- 做得好的地方: +- 需要改进的地方: +- 改进计划: + +### 明日计划 +1. 计划1 +2. 计划2 +3. 计划3 + +## 技术笔记 + +### 技术点1 +- **内容**: +- **代码示例**: +```java +// 代码示例 +``` + +- **关键理解**: +- **相关链接**: [[相关文档]] + +### 技术点2 +- **内容**: +- **关键理解**: + +## 问题与疑问 + +### 问题1 +- **问题描述**: +- **思考**: +- **待解决**: + +### 问题2 +- **问题描述**: +- **思考**: + +## 相关链接 + +- [[相关项目]] +- [[相关文档]] +- [[相关笔记]] + +## 备注 + +- 备注1 +- 备注2 diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/# 工作流和Agent平台架构方案分析.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/# 工作流和Agent平台架构方案分析.md new file mode 100644 index 0000000..8d0ad7c --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/# 工作流和Agent平台架构方案分析.md @@ -0,0 +1,1399 @@ +# 工作流和Agent平台架构方案分析 + + + +## 📊 当前架构评估 + + + +### 当前技术栈 + +``` + +前端: Next.js 14 + React 18 + TypeScript + +后端: Next.js API Routes + MySQL + +数据库: MySQL (腾讯云) + +状态管理: Zustand + +编辑器: Monaco Editor + +``` + + + +### 当前架构的优势 ✅ + + + +1. **开发效率高** + +   - 全栈 TypeScript,类型共享 + +   - 前后端同构,减少上下文切换 + +   - 快速迭代,适合 MVP 阶段 + + + +2. **部署简单** + +   - 单一部署单元 + +   - Vercel/Netlify 一键部署 + +   - 运维成本低 + + + +3. **SEO 友好** + +   - Next.js SSR/SSG + +   - 首屏加载快 + + + +### 当前架构的局限性 ⚠️ + + + +1. **工作流执行瓶颈** + +   - Next.js API Routes 有超时限制(通常 10-60 秒) + +   - 工作流可能执行数分钟,容易超时 + +   - 无法处理长时间运行的任务 + + + +2. **Python AI 生态集成不便** + +   - LangChain、LlamaIndex 等主要是 Python + +   - 需要额外封装或 API 调用 + +   - 无法充分利用 Python AI 工具链 + + + +3. **异步任务处理弱** + +   - 缺少任务队列机制 + +   - 无法实现任务优先级 + +   - 难以处理并发执行 + + + +4. **扩展性受限** + +   - 前后端耦合,无法独立扩展 + +   - 工作流引擎和前端共享资源 + +   - 难以针对不同组件优化 + + + +--- + + + +## 🎯 工作流和Agent平台的核心需求 + + + +### 1. 长时间运行任务 + +- 工作流可能执行数分钟甚至更久 + +- 需要异步任务队列(Celery + Redis) + +- 需要实时状态推送(WebSocket) + + + +### 2. Python AI 生态集成 + +- LangChain(Agent 框架) + +- LlamaIndex(RAG) + +- AutoGPT、BabyAGI + +- 向量数据库(Chroma、Pinecone) + + + +### 3. 复杂业务逻辑 + +- 工作流引擎需要复杂状态管理 + +- 条件分支、循环、错误重试 + +- 更适合用 Python 实现 + + + +### 4. 高并发处理 + +- 多个工作流并行执行 + +- 需要任务队列和负载均衡 + +- 后端需要独立扩展 + + + +--- + + + +## 🏗️ 架构方案对比 + + + +### 方案 A: 保持当前架构 + 优化 ⭐⭐⭐ + + + +**技术栈**: + +- 前端: Next.js 14 + React(保持不变) + +- 后端: Next.js API Routes + BullMQ + Redis + +- 工作流引擎: Node.js(TypeScript) + +- 实时通信: WebSocket (Socket.io) + + + +**优势**: + +- ✅ 改动最小,快速上线 + +- ✅ 保持类型安全 + +- ✅ 部署简单 + + + +**劣势**: + +- ❌ Python AI 生态集成困难 + +- ❌ Node.js 工作流引擎能力有限 + +- ❌ 长期扩展性受限 + + + +**适用场景**: 短期方案,快速验证 + + + +--- + + + +### 方案 B: Vue 3 + Python FastAPI(推荐)⭐⭐⭐⭐⭐ + + + +**技术栈**: + +``` + +前端: + +  - Vue 3 + TypeScript + Vite + +  - Pinia (状态管理) + +  - Vue Flow (工作流可视化) + +  - Element Plus / Ant Design Vue + +  - Socket.io Client (实时通信) + + + +后端: + +  - Python FastAPI (API 服务) + +  - Celery + Redis (任务队列) + +  - PostgreSQL (主数据库) + +  - Redis (缓存/队列) + +  - WebSocket (FastAPI) + + + +工作流引擎: + +  - Python (独立服务) + +  - LangChain (Agent 框架) + +  - LlamaIndex (RAG) + +  - ChromaDB (向量数据库) + + + +基础设施: + +  - Docker + Docker Compose + +  - Nginx (反向代理) + +  - Prometheus + Grafana (监控) + +``` + + + +**优势**: + +- ✅ **Python AI 生态完整** + +  - LangChain、LlamaIndex 直接使用 + +  - 向量数据库集成方便 + +  - 模型微调和训练支持好 + + + +- ✅ **工作流引擎强大** + +  - Python 异步编程成熟(asyncio) + +  - Celery 任务队列完善 + +  - 支持复杂工作流逻辑 + + + +- ✅ **前后端独立扩展** + +  - 前端可以部署到 CDN + +  - 后端可以水平扩展 + +  - 适合高并发场景 + + + +- ✅ **开发体验好** + +  - Vue 3 Composition API 灵活 + +  - FastAPI 自动生成 API 文档 + +  - Python 开发效率高 + + + +**劣势**: + +- ❌ 需要维护两套代码 + +- ❌ 接口定义需要额外工作 + +- ❌ 部署复杂度增加 + + + +**推荐指数**: ⭐⭐⭐⭐⭐(最适合 Agent 平台) + + + +--- + + + +### 方案 C: Next.js + Python 微服务(平衡方案)⭐⭐⭐⭐ + + + +**技术栈**: + +``` + +前端: + +  - Next.js 14 + React (保留) + +  - tRPC (类型安全 API) + +  - React Flow (工作流可视化) + + + +API 网关: + +  - Next.js API Routes + + + +工作流服务: + +  - Python FastAPI (独立服务) + +  - Celery + Redis (任务队列) + +  - gRPC / REST (服务间通信) + + + +数据库: + +  - PostgreSQL (主数据库) + +  - Redis (缓存/队列) + +``` + + + +**架构图**: + +``` + +┌─────────────────┐ + +│  Next.js 前端   │ + +│  (React + TS)   │ + +└────────┬────────┘ + +         │ HTTP/tRPC + +┌────────▼─────────────┐ + +│  Next.js API Gateway │ + +└────────┬─────────────┘ + +         │ gRPC/REST + +    ┌────┴────┐ + +    │         │ + +┌───▼───┐ ┌──▼────────┐ + +│业务API│ │工作流引擎 │ + +│Next.js│ │Python    │ + +└───┬───┘ └──┬────────┘ + +    │        │ + +    └───┬────┘ + +        │ + +┌───────▼────────┐ + +│ Celery + Redis │ + +└───────┬────────┘ + +        │ + +┌───────▼────────┐ + +│  PostgreSQL    │ + +└────────────────┘ + +``` + + + +**优势**: + +- ✅ 保留前端优势(SSR、SEO) + +- ✅ Python 工作流引擎强大 + +- ✅ 渐进式迁移,风险低 + +- ✅ 类型安全(tRPC) + + + +**劣势**: + +- ❌ 架构复杂度中等 + +- ❌ 需要服务间通信 + +- ❌ 部署需要协调多个服务 + + + +**推荐指数**: ⭐⭐⭐⭐(平衡方案) + + + +--- + + + +### 方案 D: 现代化微服务架构(长期最佳)⭐⭐⭐⭐⭐ + + + +**技术栈**: + +``` + +前端: + +  - Vue 3 + Nuxt 3 (或 Next.js 14) + +  - TypeScript + +  - Vue Flow / React Flow + + + +API 层: + +  - tRPC (类型安全) + +  - GraphQL (可选) + + + +工作流引擎: + +  - Python FastAPI (独立服务) + +  - Celery + Redis (任务队列) + +  - LangChain (Agent 框架) + + + +Agent 服务: + +  - Python FastAPI + +  - LangChain Agents + +  - LlamaIndex (RAG) + +  - ChromaDB (向量数据库) + + + +基础设施: + +  - PostgreSQL (主数据库) + +  - Redis (缓存/队列) + +  - RabbitMQ / Kafka (消息队列) + +  - Docker + Kubernetes + +  - Prometheus + Grafana (监控) + +``` + + + +**优势**: + +- ✅ 最佳实践组合 + +- ✅ 高可扩展性 + +- ✅ 各服务独立扩展 + +- ✅ 支持高并发 + + + +**劣势**: + +- ❌ 架构复杂度高 + +- ❌ 运维成本高 + +- ❌ 需要专业团队 + + + +**推荐指数**: ⭐⭐⭐⭐⭐(长期最佳方案) + + + +--- + + + +## 💡 具体建议 + + + +### 对于工作流和Agent平台 + + + +**强烈推荐**: **Vue 3 + Python FastAPI** 或 **Next.js + Python 微服务** + + + +### 推荐理由 + + + +#### 1. Python AI 生态不可替代 + +``` + +LangChain: Agent 框架,工具调用,记忆管理 + +LlamaIndex: RAG 系统,知识库构建 + +AutoGPT: 自主 Agent + +BabyAGI: 任务规划 Agent + +ChromaDB: 向量数据库 + +Pinecone: 云向量数据库 + +Weaviate: 向量搜索引擎 + +``` + + + +#### 2. 工作流引擎更适合 Python + +```python + +# Python 异步编程示例 + +async def execute_workflow(workflow): + +    async with asyncio.TaskGroup() as tg: + +        tasks = [tg.create_task(execute_node(node)) + +                 for node in workflow.nodes] + +    return await gather_results(tasks) + + + +# Celery 任务队列 + +@celery.task + +def execute_workflow_task(workflow_id, input_data): + +    # 长时间运行的任务 + +    result = workflow_engine.execute(workflow_id, input_data) + +    return result + +``` + + + +#### 3. 前后端分离更灵活 + +- 前端可以独立优化和部署 + +- 后端可以水平扩展 + +- 适合高并发场景 + + + +--- + + + +## 🚀 迁移路径建议 + + + +### 阶段 1: 短期优化(1-2个月) + + + +**目标**: 在现有架构基础上优化 + + + +**行动**: + +1. ✅ 添加任务队列(BullMQ + Redis) + +   ```typescript + +   // 工作流执行改为异步任务 + +   import { Queue } from 'bullmq'; + +   const workflowQueue = new Queue('workflow', { + +     connection: redis + +   }); + +   // 执行工作流 + +   const job = await workflowQueue.add('execute', { + +     workflowId, + +     input + +   }); + +   ``` + + + +2. ✅ 添加 WebSocket 支持 + +   ```typescript + +   // 实时推送执行状态 + +   import { Server } from 'socket.io'; + +   io.on('connection', (socket) => { + +     socket.on('workflow:subscribe', (executionId) => { + +       // 订阅工作流执行状态 + +     }); + +   }); + +   ``` + + + +3. ✅ 优化工作流引擎 + +   - 支持超时处理 + +   - 添加重试机制 + +   - 错误恢复 + + + +**优点**: 改动小,快速上线 + + + +--- + + + +### 阶段 2: 中期迁移(3-6个月) + + + +**目标**: 将工作流引擎迁移到 Python + + + +**行动**: + +1. ✅ 创建 Python 工作流服务 + +   ```python + +   # FastAPI 工作流服务 + +   from fastapi import FastAPI + +   from celery import Celery + +   app = FastAPI() + +   celery_app = Celery('workflow', broker='redis://localhost:6379') + +   @app.post("/workflows/{id}/execute") + +   async def execute_workflow(id: str, input_data: dict): + +       task = execute_workflow_task.delay(id, input_data) + +       return {"task_id": task.id} + +   @celery_app.task + +   def execute_workflow_task(workflow_id: str, input_data: dict): + +       # 长时间运行的工作流执行 + +       engine = WorkflowEngine(workflow_id) + +       return engine.execute(input_data) + +   ``` + + + +2. ✅ Next.js 前端调用 Python 服务 + +   ```typescript + +   // Next.js API Route 作为代理 + +   export async function POST(req: Request) { + +     const response = await fetch('http://python-service/workflows/execute', { + +       method: 'POST', + +       body: JSON.stringify(data) + +     }); + +     return response; + +   } + +   ``` + + + +3. ✅ 使用 Celery 处理异步任务 + +4. ✅ WebSocket 实时通信 + + + +**优点**: 平衡性能和开发效率 + + + +--- + + + +### 阶段 3: 完全前后端分离(6-12个月) + + + +**目标**: 前端迁移到 Vue 3(可选) + + + +**行动**: + +1. ✅ 评估是否需要完全前后端分离 + +2. ✅ 如果选择 Vue,逐步迁移前端 + +3. ✅ 完善微服务架构 + +4. ✅ 添加监控和日志系统 + + + +**优点**: 最佳实践,高可扩展性 + + + +--- + + + +## 📊 详细技术栈对比 + + + +### Vue 3 + Python FastAPI 方案 + + + +#### 前端技术栈 + +```yaml + +框架: Vue 3 + TypeScript + +构建工具: Vite + +状态管理: Pinia + +UI组件: Element Plus / Ant Design Vue + +工作流可视化: Vue Flow + +HTTP客户端: Axios + +WebSocket: Socket.io Client + +路由: Vue Router + +表单验证: VeeValidate + +``` + + + +#### 后端技术栈 + +```yaml + +API框架: FastAPI + +任务队列: Celery + +缓存/队列: Redis + +数据库: PostgreSQL + +ORM: SQLAlchemy + +数据验证: Pydantic + +Agent框架: LangChain + +RAG框架: LlamaIndex + +向量数据库: ChromaDB + +WebSocket: FastAPI WebSocket + +API文档: Swagger/OpenAPI + +``` + + + +#### 部署架构 + +```yaml + +容器化: Docker + Docker Compose + +反向代理: Nginx + +进程管理: Supervisor / systemd + +监控: Prometheus + Grafana + +日志: ELK Stack (可选) + +CI/CD: GitHub Actions / GitLab CI + +``` + + + +--- + + + +### Next.js + Python 微服务方案 + + + +#### 前端技术栈(保持不变) + +```yaml + +框架: Next.js 14 + React 18 + +类型: TypeScript + +样式: Tailwind CSS + +状态管理: Zustand + +工作流可视化: React Flow + +API客户端: tRPC (类型安全) + +``` + + + +#### 后端技术栈 + +```yaml + +API网关: Next.js API Routes + +工作流服务: Python FastAPI + +任务队列: Celery + Redis + +数据库: PostgreSQL + +服务通信: gRPC / REST + +``` + + + +--- + + + +## 🎯 最终推荐 + + + +### 对于工作流和Agent平台 + + + +**首选方案**: **Vue 3 + Python FastAPI** + + + +**理由**: + +1. **Python AI 生态完整** - LangChain、LlamaIndex 等工具主要是 Python + +2. **工作流引擎强大** - Python 异步编程和 Celery 任务队列成熟 + +3. **前后端独立扩展** - 适合高并发和复杂业务场景 + +4. **开发体验好** - Vue 3 和 FastAPI 都是现代化框架 + + + +**备选方案**: **Next.js + Python 微服务** + + + +**理由**: + +1. 保留现有前端优势 + +2. 渐进式迁移,风险低 + +3. 类型安全(tRPC) + + + +--- + + + +## 📋 实施计划 + + + +### 第一步:评估和规划(1周) + +- [ ] 评估当前系统复杂度 + +- [ ] 确定迁移范围 + +- [ ] 制定详细迁移计划 + + + +### 第二步:搭建 Python 服务(2-3周) + +- [ ] 搭建 FastAPI 项目结构 + +- [ ] 集成 Celery + Redis + +- [ ] 实现基础工作流引擎 + +- [ ] 集成 LangChain + + + +### 第三步:迁移工作流功能(3-4周) + +- [ ] 将工作流执行迁移到 Python + +- [ ] Next.js 前端调用 Python 服务 + +- [ ] 实现 WebSocket 实时通信 + +- [ ] 测试和优化 + + + +### 第四步:完善功能(2-3周) + +- [ ] 添加 Agent 功能 + +- [ ] 集成向量数据库 + +- [ ] 完善监控和日志 + +- [ ] 性能优化 + + + +### 第五步:前端迁移(可选,4-6周) + +- [ ] 评估是否需要迁移到 Vue + +- [ ] 如果迁移,逐步替换前端 + +- [ ] 保持功能一致性 + + + +--- + + + +## 🔧 技术实现示例 + + + +### Python 工作流引擎示例 + + + +```python + +# workflow_engine.py + +from fastapi import FastAPI + +from celery import Celery + +from langchain.agents import initialize_agent + +from langchain.llms import OpenAI + + + +app = FastAPI() + +celery_app = Celery('workflow', broker='redis://localhost:6379') + + + +class WorkflowEngine: + +    def __init__(self, workflow_id: str): + +        self.workflow_id = workflow_id + +        self.llm = OpenAI(temperature=0.7) + +        self.agent = initialize_agent( + +            tools=[],  # 工具列表 + +            llm=self.llm, + +            agent="zero-shot-react-description" + +        ) + +    async def execute_node(self, node: dict, input_data: dict): + +        if node['type'] == 'template': + +            # 调用 AI 模型 + +            prompt = self.build_prompt(node, input_data) + +            result = await self.llm.agenerate([prompt]) + +            return result + +        elif node['type'] == 'agent': + +            # 执行 Agent + +            result = await self.agent.arun(node['task']) + +            return result + +        # ... 其他节点类型 + +    async def execute(self, input_data: dict): + +        workflow = self.load_workflow() + +        results = {} + +        for node in workflow['nodes']: + +            result = await self.execute_node(node, input_data) + +            results[node['id']] = result + +            input_data = result  # 数据流转 + +        return results + + + +@celery_app.task + +def execute_workflow_task(workflow_id: str, input_data: dict): + +    engine = WorkflowEngine(workflow_id) + +    return asyncio.run(engine.execute(input_data)) + + + +@app.post("/workflows/{id}/execute") + +async def execute_workflow(id: str, input_data: dict): + +    task = execute_workflow_task.delay(id, input_data) + +    return {"task_id": task.id, "status": "pending"} + + + +@app.get("/workflows/executions/{task_id}") + +async def get_execution_status(task_id: str): + +    task = celery_app.AsyncResult(task_id) + +    return { + +        "task_id": task_id, + +        "status": task.status, + +        "result": task.result if task.ready() else None + +    } + +``` + + + +### Vue 3 前端示例 + + + +```vue + + + + + + + + + +``` + + + +--- + + + +## 📈 性能对比 + + + +| 指标 | 当前架构 | Vue + Python | Next.js + Python | + +|------|---------|--------------|------------------| + +| 工作流执行 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | + +| AI 生态集成 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | + +| 开发效率 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | + +| 扩展性 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | + +| 部署复杂度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | + +| 类型安全 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | + +| 长期维护 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | + + + +--- + + + +## 🎯 总结 + + + +### 对于工作流和Agent平台 + + + +**强烈推荐**: **Vue 3 + Python FastAPI** + + + +**核心原因**: + +1. Python 在 AI 领域的生态优势不可替代 + +2. 工作流引擎用 Python 实现更合适 + +3. 前后端分离便于独立扩展和优化 + +4. 长期可维护性和扩展性更好 + + + +**如果希望保留现有前端**: + +- 选择 **Next.js + Python 微服务** 方案 + +- 渐进式迁移,风险较低 + +- 保留 SSR 和 SEO 优势 + + + +--- + + + +## 📚 参考资源 + + + +### Python 工作流和 Agent + +- [LangChain 官方文档](https://python.langchain.com/) + +- [LlamaIndex 文档](https://www.llamaindex.ai/) + +- [FastAPI 最佳实践](https://fastapi.tiangolo.com/) + +- [Celery 任务队列](https://docs.celeryq.dev/) + + + +### Vue 3 前端 + +- [Vue 3 官方文档](https://vuejs.org/) + +- [Vue Flow 文档](https://vueflow.dev/) + +- [Pinia 状态管理](https://pinia.vuejs.org/) + + + +### \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/Agent和模板节点的区别.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/Agent和模板节点的区别.md new file mode 100644 index 0000000..2474427 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/Agent和模板节点的区别.md @@ -0,0 +1,64 @@ +### 1. Agent(智能体) + +- 整个工作流/智能体的概念 + +- 包含多个节点和它们之间的连接关系 + +- 有完整的输入输出流程 + +### 2. 模板节点(Template Node) + +- 工作流中的一个节点类型 + +- 用于生成文本或内容 + +- 需要配置提示词(Prompt)来定义其行为 + + + + +## 模板节点实施建议 + +### 阶段一:基础功能(推荐先做) + +1. 添加 template 节点到节点类型列表 + +2. 创建模板管理页面(CRUD) + +3. 模板选择器(创建节点时选择模板) + +4. 数据库表:node_templates + +### 阶段二:增强功能 + +1. 模板分类和标签 + +2. 模板搜索和筛选 + +3. 模板导入/导出 + +4. 模板版本管理 + +### 阶段三:高级功能 + +1. 模板市场 + +2. 模板评分系统 + +3. 模板使用统计 + +4. 模板推荐 + +## 总结 + +建议实现模板管理功能,原因: + +- 提升用户体验和效率 + +- 支持标准化与知识复用 + +- 增强团队协作 + +- 为后续模板市场打基础 + +优先级:高。这是提升平台易用性的重要功能。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/android应用agent.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/android应用agent.md new file mode 100644 index 0000000..53f7909 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/android应用agent.md @@ -0,0 +1,89 @@ +## 项目结构 + +androidExampleDemo/ + +├── app/ + +│   ├── src/main/ + +│   │   ├── java/com/example/agentclient/ + +│   │   │   ├── MainActivity.java          # 主Activity,包含UI和业务逻辑 + +│   │   │   ├── models/                    # 数据模型 + +│   │   │   │   ├── Agent.java + +│   │   │   │   ├── AgentExecutionRequest.java + +│   │   │   │   ├── ExecutionResponse.java + +│   │   │   │   ├── ExecutionStatusResponse.java + +│   │   │   │   └── TokenResponse.java + +│   │   │   └── utils/ + +│   │   │       └── ApiClient.java         # API客户端配置 + +│   │   ├── res/ + +│   │   │   ├── layout/activity_main.xml   # 主界面布局 + +│   │   │   ├── values/strings.xml + +│   │   │   └── xml/network_security_config.xml + +│   │   └── AndroidManifest.xml + +│   └── build.gradle + +├── build.gradle + +├── settings.gradle + +└── README.md + +## 主要功能 + +1. 自动登录:启动时使用配置的用户名和密码登录 + +2. Agent 查找:通过名称查找“情感分析Agent”并获取其ID + +3. 发送消息:输入文本后发送给Agent进行分析 + +4. 轮询结果:自动轮询执行状态,完成后显示结果 + +5. 实时状态:显示当前执行节点和状态 + +## 配置说明 + +在 MainActivity.java 中修改以下配置: + +private static final String USERNAME = "admin"; + +private static final String PASSWORD = "123456"; + +private static final String AGENT_NAME = "情感分析Agent"; + +在 ApiClient.java 中修改服务器地址: + +private static final String BASE_URL = "http://your-server-ip:8037"; + +## 使用步骤 + +1. 使用 Android Studio 打开项目 + +2. 同步 Gradle 依赖 + +3. 修改配置(服务器地址、用户名、密码、Agent名称) + +4. 运行到 Android 设备或模拟器 + +5. 应用会自动登录并查找Agent + +6. 输入文本后点击“发送”按钮 + +7. 等待Agent处理并查看结果 + +项目已就绪,可直接在 Android Studio 中打开使用。所有代码使用 Java 编写,符合 Android 开发规范。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/内容生成助手Agent.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/内容生成助手Agent.md new file mode 100644 index 0000000..783b4a6 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/内容生成助手Agent.md @@ -0,0 +1,71 @@ +### Agent 信息 + +- 名称:内容生成助手 + +- ID:cc5653b9-49e8-46bd-900f-78ab8e546e7e + +- 状态:已发布(published) + +- 节点数量:11 个 + +- 连接数量:13 条 + +### 工作流结构 + +开始 → 需求分析 → 数据准备 → 内容类型判断 → [文章生成 | 文案生成 | 脚本生成 | 通用生成] → 内容整合 → 内容优化 → 结束 + +### 节点说明 + +1. 开始节点:接收用户输入(主题、类型、要求等) + +2. 需求分析节点:分析用户需求,提取内容类型、主题、风格等关键信息 + +3. 数据准备节点:整合需求分析结果和原始查询 + +4. 内容类型判断节点:根据内容类型进行分支处理 + +5. 文章生成节点:生成结构完整的文章内容 + +6. 文案生成节点:生成营销文案、广告文案等 + +7. 脚本生成节点:生成视频/音频脚本 + +8. 通用内容生成节点:处理其他类型的内容生成需求 + +9. 内容整合节点:整合生成的内容和需求信息 + +10. 内容优化节点:优化和润色内容,确保质量 + +11. 结束节点:返回最终优化后的内容 + +### 使用示例 + +- 输入:帮我写一篇关于人工智能发展趋势的博客文章,2000字左右,风格轻松易懂 + +- 输入:生成一个产品推广的营销文案,面向年轻白领群体 + +- 输入:写一个5分钟的产品介绍视频脚本 + +### 功能特点 + +1. 智能需求分析:自动提取内容类型、主题、风格等关键信息 + +2. 多类型支持:支持文章、文案、脚本等多种内容类型 + +3. 条件分支:根据内容类型自动选择最合适的生成节点 + +4. 内容优化:自动优化和润色生成的内容 + +5. 纯文本输出:最终输出为纯文本 Markdown 格式,适合人机交互 + +### 测试方法 + +1. 在 Agent 管理页面找到“内容生成助手” + +2. 点击测试或运行 + +3. 输入内容生成需求 + +4. 查看生成结果 + +Agent 已配置完成,可正常使用。如需调整,请告知。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流和Agent平台提示词目录.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流和Agent平台提示词目录.md new file mode 100644 index 0000000..39daff9 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流和Agent平台提示词目录.md @@ -0,0 +1,1241 @@ +# 工作流和Agent平台提示词目录 + +## 📋 目录结构 + +本目录基于现代化全栈架构(Next.js/Vue + Python FastAPI + Celery + Redis)设计,涵盖工作流和Agent平台的核心功能场景。 + +--- + +## 一、工作流引擎相关提示词 + +### 1.1 工作流设计助手 + +#### WF-001: 工作流架构设计专家 +**分类**: workflow-design +**用途**: 帮助用户设计工作流架构 +**角色**: +你是一位资深的工作流架构设计专家,拥有丰富的业务流程自动化和智能体系统设计经验。你熟悉各种工作流模式,包括顺序执行、并行处理、条件分支、循环迭代等。 + +**任务**: +请根据以下需求设计一个工作流架构: +- 业务场景:{{businessScenario}} +- 主要目标:{{mainGoal}} +- 输入数据:{{inputData}} +- 预期输出:{{expectedOutput}} +- 特殊要求:{{specialRequirements}} + +**变量**: +- businessScenario (text, required): 业务场景描述 +- mainGoal (text, required): 主要目标 +- inputData (text, required): 输入数据类型和格式 +- expectedOutput (text, required): 预期输出格式 +- specialRequirements (text, optional): 特殊要求(性能、安全、合规等) + +**输出格式**: markdown +**约束**: +- 提供清晰的工作流节点设计 +- 说明节点间的数据流转 +- 考虑错误处理和异常情况 +- 提供性能优化建议 + +--- + +#### WF-002: 工作流节点类型选择器 +**分类**: workflow-design +**用途**: 帮助选择合适的工作流节点类型 +**角色**: +你是一位工作流节点设计专家,熟悉各种节点类型的特点和适用场景。 + +**任务**: +根据以下需求,推荐最适合的节点类型组合: +- 功能需求:{{functionRequirement}} +- 数据来源:{{dataSource}} +- 处理复杂度:{{complexity}} +- 性能要求:{{performanceRequirement}} + +**变量**: +- functionRequirement (text, required): 功能需求描述 +- dataSource (text, required): 数据来源(API、数据库、文件等) +- complexity (select, required): 处理复杂度(简单/中等/复杂) +- performanceRequirement (text, optional): 性能要求 + +**输出格式**: json +**约束**: +- 推荐节点类型(start、template、condition、data、tool、end) +- 说明每个节点的作用 +- 提供节点配置建议 + +--- + +#### WF-003: 工作流执行优化专家 +**分类**: workflow-optimization +**用途**: 优化工作流执行性能 +**角色**: +你是一位工作流性能优化专家,擅长分析工作流瓶颈并提供优化方案。 + +**任务**: +分析以下工作流设计,提供性能优化建议: +- 工作流结构:{{workflowStructure}} +- 当前性能指标:{{currentMetrics}} +- 性能瓶颈:{{bottlenecks}} +- 优化目标:{{optimizationGoal}} + +**变量**: +- workflowStructure (text, required): 工作流结构描述或JSON +- currentMetrics (text, required): 当前性能指标(执行时间、资源使用等) +- bottlenecks (text, optional): 已知的性能瓶颈 +- optimizationGoal (text, required): 优化目标(速度、资源、成本等) + +**输出格式**: markdown +**约束**: +- 识别性能瓶颈点 +- 提供具体的优化方案 +- 评估优化效果 +- 考虑成本和收益 + +--- + +### 1.2 工作流节点配置 + +#### WF-004: 模板节点配置助手 +**分类**: workflow-node-config +**用途**: 帮助配置模板节点参数 +**角色**: +你是一位AI模型配置专家,熟悉各种AI模型的参数调优和提示词工程。 + +**任务**: +为以下场景推荐最佳的模板节点配置: +- 使用场景:{{useCase}} +- 模板类型:{{templateType}} +- 数据特点:{{dataCharacteristics}} +- 质量要求:{{qualityRequirement}} + +**变量**: +- useCase (text, required): 使用场景描述 +- templateType (text, required): 模板类型(文本生成、数据分析、代码生成等) +- dataCharacteristics (text, required): 数据特点(结构化、非结构化、多模态等) +- qualityRequirement (text, required): 质量要求(准确性、速度、成本等) + +**输出格式**: json +**约束**: +- 推荐AI模型(GPT-4、Claude、DeepSeek等) +- 设置Temperature、MaxTokens等参数 +- 提供提示词优化建议 + +--- + +#### WF-005: 条件节点表达式生成器 +**分类**: workflow-node-config +**用途**: 生成条件节点的表达式 +**角色**: +你是一位逻辑表达式设计专家,擅长将业务逻辑转换为可执行的表达式。 + +**任务**: +根据以下业务逻辑,生成条件表达式: +- 业务规则:{{businessRule}} +- 判断条件:{{judgmentCondition}} +- 数据字段:{{dataFields}} +- 逻辑关系:{{logicalRelation}} + +**变量**: +- businessRule (text, required): 业务规则描述 +- judgmentCondition (text, required): 判断条件(大于、等于、包含等) +- dataFields (text, required): 涉及的数据字段 +- logicalRelation (select, optional): 逻辑关系(AND、OR、NOT) + +**输出格式**: plain-text +**约束**: +- 生成JavaScript兼容的表达式 +- 使用${变量名}格式引用数据 +- 考虑边界情况 +- 提供表达式说明 + +--- + +#### WF-006: 数据节点映射规则生成器 +**分类**: workflow-node-config +**用途**: 生成数据映射规则 +**角色**: +你是一位数据转换专家,擅长设计数据映射和转换规则。 + +**任务**: +根据以下需求,生成数据映射规则: +- 输入数据结构:{{inputStructure}} +- 输出数据结构:{{outputStructure}} +- 字段对应关系:{{fieldMapping}} +- 转换规则:{{transformationRules}} + +**变量**: +- inputStructure (text, required): 输入数据结构(JSON格式) +- outputStructure (text, required): 输出数据结构(JSON格式) +- fieldMapping (text, optional): 字段对应关系 +- transformationRules (text, optional): 特殊转换规则 + +**输出格式**: json +**约束**: +- 生成完整的映射规则JSON +- 支持嵌套路径 +- 处理缺失字段 +- 提供默认值建议 + +--- + +## 二、Agent平台相关提示词 + +### 2.1 Agent设计 + +#### AG-001: Agent角色定义专家 +**分类**: agent-design +**用途**: 帮助定义Agent的角色和能力 +**角色**: +你是一位Agent系统设计专家,熟悉各种Agent架构和角色设计模式。 + +**任务**: +为以下场景设计Agent角色: +- Agent名称:{{agentName}} +- 主要职责:{{mainResponsibilities}} +- 专业领域:{{expertiseDomain}} +- 交互方式:{{interactionMode}} +- 能力边界:{{capabilityBoundary}} + +**变量**: +- agentName (text, required): Agent名称 +- mainResponsibilities (text, required): 主要职责 +- expertiseDomain (text, required): 专业领域 +- interactionMode (select, required): 交互方式(对话、任务执行、数据分析等) +- capabilityBoundary (text, required): 能力边界和限制 + +**输出格式**: markdown +**约束**: +- 定义清晰的Agent身份 +- 说明核心能力 +- 明确能力边界 +- 提供使用场景示例 + +--- + +#### AG-002: Agent工具链设计器 +**分类**: agent-design +**用途**: 设计Agent的工具链 +**角色**: +你是一位工具集成专家,熟悉各种API、数据库、文件处理等工具的使用。 + +**任务**: +为以下Agent设计工具链: +- Agent类型:{{agentType}} +- 核心功能:{{coreFunctions}} +- 数据需求:{{dataRequirements}} +- 外部服务:{{externalServices}} + +**变量**: +- agentType (text, required): Agent类型(研究型、执行型、分析型等) +- coreFunctions (text, required): 核心功能列表 +- dataRequirements (text, required): 数据需求(读取、写入、查询等) +- externalServices (text, optional): 需要集成的外部服务 + +**输出格式**: json +**约束**: +- 列出必需的工具 +- 说明每个工具的用途 +- 提供工具配置建议 +- 考虑工具间的依赖关系 + +--- + +#### AG-003: Agent工作流编排器 +**分类**: agent-orchestration +**用途**: 编排多个Agent的协作流程 +**角色**: +你是一位多Agent系统架构师,擅长设计Agent间的协作模式。 + +**任务**: +设计一个多Agent协作工作流: +- 参与Agent:{{participatingAgents}} +- 协作目标:{{collaborationGoal}} +- 数据流转:{{dataFlow}} +- 协调机制:{{coordinationMechanism}} + +**变量**: +- participatingAgents (text, required): 参与的Agent列表和角色 +- collaborationGoal (text, required): 协作目标 +- dataFlow (text, required): 数据流转路径 +- coordinationMechanism (select, required): 协调机制(顺序、并行、主从、对等) + +**输出格式**: markdown +**约束**: +- 设计清晰的协作流程 +- 定义Agent间的接口 +- 考虑冲突解决机制 +- 提供错误处理方案 + +--- + +### 2.2 Agent执行 + +#### AG-004: Agent任务分解器 +**分类**: agent-execution +**用途**: 将复杂任务分解为Agent可执行的子任务 +**角色**: +你是一位任务规划专家,擅长将复杂任务分解为可执行的步骤。 + +**任务**: +将以下复杂任务分解为Agent可执行的子任务: +- 主任务:{{mainTask}} +- 任务复杂度:{{taskComplexity}} +- 可用资源:{{availableResources}} +- 时间限制:{{timeLimit}} + +**变量**: +- mainTask (text, required): 主任务描述 +- taskComplexity (select, required): 任务复杂度(简单/中等/复杂) +- availableResources (text, required): 可用资源(工具、数据、API等) +- timeLimit (text, optional): 时间限制 + +**输出格式**: json +**约束**: +- 分解为清晰的子任务 +- 定义任务间的依赖关系 +- 估计每个任务的执行时间 +- 标识关键路径 + +--- + +#### AG-005: Agent决策助手 +**分类**: agent-execution +**用途**: 帮助Agent做出决策 +**角色**: +你是一位决策分析专家,擅长基于多因素进行决策分析。 + +**任务**: +基于以下信息,为Agent提供决策建议: +- 决策场景:{{decisionScenario}} +- 可选方案:{{options}} +- 评估标准:{{evaluationCriteria}} +- 约束条件:{{constraints}} + +**变量**: +- decisionScenario (text, required): 决策场景描述 +- options (text, required): 可选方案列表 +- evaluationCriteria (text, required): 评估标准 +- constraints (text, optional): 约束条件 + +**输出格式**: json +**约束**: +- 分析每个方案的优缺点 +- 给出推荐方案 +- 说明推荐理由 +- 提供风险评估 + +--- + +#### AG-006: Agent错误恢复策略生成器 +**分类**: agent-execution +**用途**: 生成Agent错误恢复策略 +**角色**: +你是一位系统可靠性专家,擅长设计错误处理和恢复机制。 + +**任务**: +为以下Agent设计错误恢复策略: +- Agent类型:{{agentType}} +- 常见错误:{{commonErrors}} +- 错误影响:{{errorImpact}} +- 恢复目标:{{recoveryGoal}} + +**变量**: +- agentType (text, required): Agent类型 +- commonErrors (text, required): 常见错误类型 +- errorImpact (text, required): 错误影响范围 +- recoveryGoal (text, required): 恢复目标(快速恢复、数据一致性等) + +**输出格式**: markdown +**约束**: +- 针对每种错误提供恢复策略 +- 定义重试机制 +- 提供降级方案 +- 考虑数据一致性 + +--- + +## 三、平台功能相关提示词 + +### 3.1 用户引导 + +#### PL-001: 工作流创建向导 +**分类**: platform-guide +**用途**: 引导用户创建工作流 +**角色**: +你是一位友好的平台助手,擅长用简单易懂的方式引导用户。 + +**任务**: +为新用户提供工作流创建指导: +- 用户目标:{{userGoal}} +- 用户经验:{{userExperience}} +- 业务场景:{{businessScenario}} + +**变量**: +- userGoal (text, required): 用户想要实现的目标 +- userExperience (select, required): 用户经验(新手/中级/高级) +- businessScenario (text, required): 业务场景描述 + +**输出格式**: markdown +**约束**: +- 使用友好的语言 +- 提供分步骤指导 +- 包含示例说明 +- 提供常见问题解答 + +--- + +#### PL-002: Agent配置助手 +**分类**: platform-guide +**用途**: 帮助用户配置Agent +**角色**: +你是一位Agent配置专家,熟悉各种Agent配置参数。 + +**任务**: +指导用户配置Agent: +- Agent用途:{{agentPurpose}} +- 使用场景:{{useCase}} +- 技术背景:{{technicalBackground}} + +**变量**: +- agentPurpose (text, required): Agent用途 +- useCase (text, required): 使用场景 +- technicalBackground (select, required): 技术背景(非技术/初级/中级/高级) + +**输出格式**: markdown +**约束**: +- 提供配置步骤 +- 解释每个参数的作用 +- 提供推荐配置 +- 包含最佳实践 + +--- + +### 3.2 代码生成 + +#### PL-003: Python工作流引擎代码生成器 +**分类**: code-generation +**用途**: 生成Python工作流引擎代码 +**角色**: +你是一位Python开发专家,熟悉FastAPI、Celery、异步编程等。 + +**任务**: +根据以下工作流设计,生成Python工作流引擎代码: +- 工作流定义:{{workflowDefinition}} +- 节点类型:{{nodeTypes}} +- 执行模式:{{executionMode}} +- 框架要求:{{frameworkRequirements}} + +**变量**: +- workflowDefinition (text, required): 工作流定义(JSON格式) +- nodeTypes (text, required): 节点类型列表 +- executionMode (select, required): 执行模式(同步/异步/混合) +- frameworkRequirements (text, optional): 框架要求(FastAPI、Celery等) + +**输出格式**: plain-text +**约束**: +- 使用FastAPI框架 +- 集成Celery任务队列 +- 支持异步执行 +- 包含错误处理 +- 提供API文档 + +--- + +#### PL-004: 前端工作流编辑器代码生成器 +**分类**: code-generation +**用途**: 生成前端工作流编辑器代码 +**角色**: +你是一位前端开发专家,熟悉React、Vue、工作流可视化库。 + +**任务**: +生成工作流可视化编辑器代码: +- 前端框架:{{frontendFramework}} +- 可视化库:{{visualizationLibrary}} +- 功能需求:{{featureRequirements}} +- UI风格:{{uiStyle}} + +**变量**: +- frontendFramework (select, required): 前端框架(React/Vue) +- visualizationLibrary (select, required): 可视化库(React Flow/Vue Flow) +- featureRequirements (text, required): 功能需求(拖拽、连线、配置等) +- uiStyle (text, optional): UI风格要求 + +**输出格式**: plain-text +**约束**: +- 使用推荐的框架和库 +- 实现拖拽式编辑 +- 支持节点配置 +- 响应式设计 +- 包含类型定义 + +--- + +#### PL-005: API接口代码生成器 +**分类**: code-generation +**用途**: 生成RESTful API接口代码 +**角色**: +你是一位API设计专家,熟悉RESTful API设计和OpenAPI规范。 + +**任务**: +生成以下功能的API接口代码: +- API功能:{{apiFunction}} +- 数据模型:{{dataModel}} +- 认证方式:{{authentication}} +- 框架:{{framework}} + +**变量**: +- apiFunction (text, required): API功能描述 +- dataModel (text, required): 数据模型(JSON格式) +- authentication (select, required): 认证方式(JWT、OAuth、API Key等) +- framework (select, required): 框架(FastAPI、Express、Next.js等) + +**输出格式**: plain-text +**约束**: +- 遵循RESTful规范 +- 包含请求验证 +- 提供错误处理 +- 生成OpenAPI文档 +- 包含单元测试示例 + +--- + +### 3.3 数据分析 + +#### PL-006: 工作流执行分析器 +**分类**: data-analysis +**用途**: 分析工作流执行数据 +**角色**: +你是一位数据分析专家,擅长从执行数据中提取洞察。 + +**任务**: +分析以下工作流执行数据: +- 执行记录:{{executionRecords}} +- 分析维度:{{analysisDimensions}} +- 关注指标:{{keyMetrics}} + +**变量**: +- executionRecords (text, required): 执行记录(JSON格式) +- analysisDimensions (text, required): 分析维度(性能、成功率、错误等) +- keyMetrics (text, required): 关注的指标 + +**输出格式**: markdown +**约束**: +- 提供数据可视化建议 +- 识别异常模式 +- 给出优化建议 +- 包含趋势分析 + +--- + +#### PL-007: Agent性能评估器 +**分类**: data-analysis +**用途**: 评估Agent性能 +**角色**: +你是一位AI系统评估专家,熟悉各种性能评估指标。 + +**任务**: +评估以下Agent的性能: +- Agent配置:{{agentConfig}} +- 执行数据:{{executionData}} +- 评估标准:{{evaluationCriteria}} + +**变量**: +- agentConfig (text, required): Agent配置信息 +- executionData (text, required): 执行数据(响应时间、成功率等) +- evaluationCriteria (text, required): 评估标准 + +**输出格式**: json +**约束**: +- 计算关键性能指标 +- 对比基准值 +- 识别性能瓶颈 +- 提供改进建议 + +--- + +## 四、场景化提示词模板 + +### 4.1 内容生成场景 + +#### SC-001: 多步骤内容生成工作流 +**分类**: content-generation +**用途**: 生成多步骤内容创作工作流 +**角色**: +你是一位内容创作专家,熟悉内容生成的完整流程。 + +**任务**: +设计一个多步骤内容生成工作流: +- 内容类型:{{contentType}} +- 生成步骤:{{generationSteps}} +- 质量要求:{{qualityRequirement}} + +**变量**: +- contentType (text, required): 内容类型(文章、视频脚本、营销文案等) +- generationSteps (text, required): 生成步骤(大纲、初稿、优化、润色等) +- qualityRequirement (text, required): 质量要求 + +**输出格式**: markdown +**约束**: +- 设计清晰的步骤流程 +- 定义每个步骤的输入输出 +- 提供质量检查点 + +--- + +#### SC-002: 智能内容审核工作流 +**分类**: content-moderation +**用途**: 设计内容审核工作流 +**角色**: +你是一位内容审核专家,熟悉各种审核标准和流程。 + +**任务**: +设计内容审核工作流: +- 审核类型:{{moderationType}} +- 审核标准:{{moderationStandards}} +- 处理流程:{{handlingProcess}} + +**变量**: +- moderationType (text, required): 审核类型(文本、图片、视频等) +- moderationStandards (text, required): 审核标准 +- handlingProcess (text, required): 处理流程(通过/拒绝/人工审核) + +**输出格式**: markdown +**约束**: +- 定义审核规则 +- 设计分级审核机制 +- 提供人工审核触发条件 + +--- + +### 4.2 数据处理场景 + +#### SC-003: 数据清洗和转换工作流 +**分类**: data-processing +**用途**: 设计数据清洗工作流 +**角色**: +你是一位数据处理专家,熟悉数据清洗和转换技术。 + +**任务**: +设计数据清洗和转换工作流: +- 数据来源:{{dataSource}} +- 数据质量:{{dataQuality}} +- 目标格式:{{targetFormat}} + +**变量**: +- dataSource (text, required): 数据来源和格式 +- dataQuality (text, required): 数据质量问题 +- targetFormat (text, required): 目标数据格式 + +**输出格式**: markdown +**约束**: +- 定义清洗规则 +- 设计转换步骤 +- 提供质量验证 + +--- + +#### SC-004: 实时数据分析工作流 +**分类**: data-analysis +**用途**: 设计实时数据分析工作流 +**角色**: +你是一位实时数据分析专家,熟悉流式数据处理。 + +**任务**: +设计实时数据分析工作流: +- 数据流:{{dataStream}} +- 分析目标:{{analysisGoal}} +- 实时性要求:{{realtimeRequirement}} + +**变量**: +- dataStream (text, required): 数据流描述 +- analysisGoal (text, required): 分析目标 +- realtimeRequirement (text, required): 实时性要求(延迟、吞吐量) + +**输出格式**: markdown +**约束**: +- 设计流式处理架构 +- 定义分析指标 +- 提供告警机制 + +--- + +### 4.3 智能客服场景 + +#### SC-005: 智能客服Agent +**分类**: customer-service +**用途**: 设计智能客服Agent +**角色**: +你是一位智能客服系统专家,熟悉对话系统和客户服务流程。 + +**任务**: +设计智能客服Agent: +- 服务领域:{{serviceDomain}} +- 常见问题:{{commonQuestions}} +- 服务标准:{{serviceStandards}} + +**变量**: +- serviceDomain (text, required): 服务领域 +- commonQuestions (text, required): 常见问题类型 +- serviceStandards (text, required): 服务标准(响应时间、解决率等) + +**输出格式**: markdown +**约束**: +- 设计对话流程 +- 定义知识库结构 +- 提供转人工机制 + +--- + +#### SC-006: 多轮对话工作流 +**分类**: conversation +**用途**: 设计多轮对话工作流 +**角色**: +你是一位对话系统专家,熟悉多轮对话设计。 + +**任务**: +设计多轮对话工作流: +- 对话目标:{{conversationGoal}} +- 对话轮次:{{conversationTurns}} +- 上下文管理:{{contextManagement}} + +**变量**: +- conversationGoal (text, required): 对话目标 +- conversationTurns (text, required): 预期对话轮次 +- contextManagement (text, required): 上下文管理需求 + +**输出格式**: markdown +**约束**: +- 设计对话状态机 +- 定义上下文存储策略 +- 提供对话恢复机制 + +--- + +### 4.4 自动化任务场景 + +#### SC-007: 定时任务Agent +**分类**: automation +**用途**: 设计定时任务Agent +**角色**: +你是一位自动化专家,熟悉定时任务和调度系统。 + +**任务**: +设计定时任务Agent: +- 任务类型:{{taskType}} +- 执行频率:{{executionFrequency}} +- 依赖关系:{{dependencies}} + +**变量**: +- taskType (text, required): 任务类型 +- executionFrequency (text, required): 执行频率(每天、每周、自定义) +- dependencies (text, optional): 任务依赖关系 + +**输出格式**: markdown +**约束**: +- 设计调度策略 +- 定义重试机制 +- 提供监控告警 + +--- + +#### SC-008: 事件驱动工作流 +**分类**: event-driven +**用途**: 设计事件驱动工作流 +**角色**: +你是一位事件驱动架构专家,熟悉事件处理和消息队列。 + +**任务**: +设计事件驱动工作流: +- 事件类型:{{eventTypes}} +- 事件源:{{eventSources}} +- 处理逻辑:{{processingLogic}} + +**变量**: +- eventTypes (text, required): 事件类型列表 +- eventSources (text, required): 事件源(API、数据库、消息队列等) +- processingLogic (text, required): 处理逻辑 + +**输出格式**: markdown +**约束**: +- 设计事件处理流程 +- 定义事件路由规则 +- 提供事件重放机制 + +--- + +## 五、系统集成提示词 + +### 5.1 API集成 + +#### SI-001: 第三方API集成设计器 +**分类**: system-integration +**用途**: 设计第三方API集成方案 +**角色**: +你是一位API集成专家,熟悉各种API集成模式和最佳实践。 + +**任务**: +设计第三方API集成方案: +- API类型:{{apiType}} +- 集成目标:{{integrationGoal}} +- 认证方式:{{authentication}} +- 错误处理:{{errorHandling}} + +**变量**: +- apiType (text, required): API类型(REST、GraphQL、gRPC等) +- integrationGoal (text, required): 集成目标 +- authentication (text, required): 认证方式 +- errorHandling (text, required): 错误处理策略 + +**输出格式**: markdown +**约束**: +- 设计集成架构 +- 定义接口规范 +- 提供错误处理方案 +- 包含重试和降级策略 + +--- + +#### SI-002: 数据库集成设计器 +**分类**: system-integration +**用途**: 设计数据库集成方案 +**角色**: +你是一位数据库专家,熟悉各种数据库的集成方式。 + +**任务**: +设计数据库集成方案: +- 数据库类型:{{databaseType}} +- 操作类型:{{operationType}} +- 性能要求:{{performanceRequirement}} +- 数据一致性:{{dataConsistency}} + +**变量**: +- databaseType (select, required): 数据库类型(PostgreSQL、MySQL、MongoDB、Redis等) +- operationType (text, required): 操作类型(读取、写入、查询、事务等) +- performanceRequirement (text, required): 性能要求 +- dataConsistency (text, required): 数据一致性要求 + +**输出格式**: markdown +**约束**: +- 设计数据访问层 +- 定义连接池配置 +- 提供事务处理方案 +- 包含缓存策略 + +--- + +### 5.2 消息队列集成 + +#### SI-003: 消息队列工作流设计器 +**分类**: system-integration +**用途**: 设计基于消息队列的工作流 +**角色**: +你是一位消息队列专家,熟悉RabbitMQ、Kafka、Redis等消息中间件。 + +**任务**: +设计基于消息队列的工作流: +- 消息队列:{{messageQueue}} +- 消息类型:{{messageTypes}} +- 处理模式:{{processingPattern}} +- 可靠性要求:{{reliabilityRequirement}} + +**变量**: +- messageQueue (select, required): 消息队列(RabbitMQ、Kafka、Redis Streams等) +- messageTypes (text, required): 消息类型 +- processingPattern (select, required): 处理模式(发布订阅、点对点、流处理) +- reliabilityRequirement (text, required): 可靠性要求(至少一次、恰好一次、最多一次) + +**输出格式**: markdown +**约束**: +- 设计消息路由规则 +- 定义消息格式 +- 提供消息确认机制 +- 包含死信队列处理 + +--- + +## 六、测试和调试提示词 + +### 6.1 工作流测试 + +#### TE-001: 工作流测试用例生成器 +**分类**: testing +**用途**: 生成工作流测试用例 +**角色**: +你是一位测试专家,熟悉工作流测试方法。 + +**任务**: +为以下工作流生成测试用例: +- 工作流定义:{{workflowDefinition}} +- 测试类型:{{testType}} +- 覆盖目标:{{coverageGoal}} + +**变量**: +- workflowDefinition (text, required): 工作流定义 +- testType (select, required): 测试类型(单元测试、集成测试、端到端测试) +- coverageGoal (text, required): 覆盖目标(节点覆盖、路径覆盖、条件覆盖) + +**输出格式**: json +**约束**: +- 生成完整的测试用例 +- 包含正常流程和异常流程 +- 提供测试数据 +- 定义预期结果 + +--- + +#### TE-002: Agent行为测试生成器 +**分类**: testing +**用途**: 生成Agent行为测试用例 +**角色**: +你是一位AI系统测试专家,熟悉Agent行为测试。 + +**任务**: +生成Agent行为测试用例: +- Agent配置:{{agentConfig}} +- 测试场景:{{testScenarios}} +- 评估标准:{{evaluationCriteria}} + +**变量**: +- agentConfig (text, required): Agent配置 +- testScenarios (text, required): 测试场景 +- evaluationCriteria (text, required): 评估标准 + +**输出格式**: json +**约束**: +- 设计多样化测试场景 +- 包含边界情况 +- 提供评估指标 +- 定义通过标准 + +--- + +### 6.2 性能测试 + +#### TE-003: 工作流性能测试方案 +**分类**: performance-testing +**用途**: 设计工作流性能测试方案 +**角色**: +你是一位性能测试专家,熟悉负载测试和压力测试。 + +**任务**: +设计工作流性能测试方案: +- 工作流复杂度:{{workflowComplexity}} +- 性能目标:{{performanceTargets}} +- 测试环境:{{testEnvironment}} + +**变量**: +- workflowComplexity (select, required): 工作流复杂度(简单/中等/复杂) +- performanceTargets (text, required): 性能目标(响应时间、吞吐量、并发数) +- testEnvironment (text, required): 测试环境描述 + +**输出格式**: markdown +**约束**: +- 设计测试场景 +- 定义性能指标 +- 提供测试工具建议 +- 包含结果分析方法 + +--- + +## 七、部署和运维提示词 + +### 7.1 部署配置 + +#### DE-001: 容器化部署配置生成器 +**分类**: deployment +**用途**: 生成Docker容器化配置 +**角色**: +你是一位DevOps专家,熟悉容器化部署和编排。 + +**任务**: +生成容器化部署配置: +- 服务类型:{{serviceType}} +- 依赖服务:{{dependencies}} +- 资源配置:{{resourceRequirements}} +- 环境变量:{{environmentVariables}} + +**变量**: +- serviceType (text, required): 服务类型(前端、后端、工作流引擎等) +- dependencies (text, required): 依赖服务(数据库、Redis、消息队列等) +- resourceRequirements (text, required): 资源配置(CPU、内存、存储) +- environmentVariables (text, required): 环境变量配置 + +**输出格式**: plain-text +**约束**: +- 生成Dockerfile +- 提供docker-compose.yml +- 包含健康检查 +- 提供部署脚本 + +--- + +#### DE-002: Kubernetes部署配置生成器 +**分类**: deployment +**用途**: 生成Kubernetes部署配置 +**角色**: +你是一位Kubernetes专家,熟悉K8s部署和编排。 + +**任务**: +生成Kubernetes部署配置: +- 应用架构:{{applicationArchitecture}} +- 副本数量:{{replicaCount}} +- 服务发现:{{serviceDiscovery}} +- 配置管理:{{configManagement}} + +**变量**: +- applicationArchitecture (text, required): 应用架构描述 +- replicaCount (text, required): 副本数量配置 +- serviceDiscovery (text, required): 服务发现需求 +- configManagement (text, required): 配置管理方式 + +**输出格式**: yaml +**约束**: +- 生成Deployment配置 +- 提供Service配置 +- 包含ConfigMap和Secret +- 定义资源限制 + +--- + +### 7.2 监控和告警 + +#### DE-003: 监控指标设计器 +**分类**: monitoring +**用途**: 设计系统监控指标 +**角色**: +你是一位监控专家,熟悉各种监控指标和告警策略。 + +**任务**: +设计系统监控指标: +- 系统组件:{{systemComponents}} +- 关键指标:{{keyMetrics}} +- 告警阈值:{{alertThresholds}} + +**变量**: +- systemComponents (text, required): 系统组件列表 +- keyMetrics (text, required): 关键指标(CPU、内存、响应时间、错误率等) +- alertThresholds (text, required): 告警阈值配置 + +**输出格式**: json +**约束**: +- 定义完整的监控指标 +- 设置合理的告警阈值 +- 提供告警规则 +- 包含仪表板配置建议 + +--- + +## 八、安全和合规提示词 + +### 8.1 安全设计 + +#### SE-001: 工作流安全审计器 +**分类**: security +**用途**: 审计工作流安全性 +**角色**: +你是一位安全专家,熟悉系统安全最佳实践。 + +**任务**: +审计工作流安全性: +- 工作流定义:{{workflowDefinition}} +- 数据敏感性:{{dataSensitivity}} +- 合规要求:{{complianceRequirements}} + +**变量**: +- workflowDefinition (text, required): 工作流定义 +- dataSensitivity (text, required): 数据敏感性级别 +- complianceRequirements (text, optional): 合规要求(GDPR、HIPAA等) + +**输出格式**: markdown +**约束**: +- 识别安全风险 +- 提供安全加固建议 +- 定义访问控制策略 +- 包含数据加密方案 + +--- + +#### SE-002: API安全配置生成器 +**分类**: security +**用途**: 生成API安全配置 +**角色**: +你是一位API安全专家,熟悉各种API安全机制。 + +**任务**: +生成API安全配置: +- API类型:{{apiType}} +- 认证方式:{{authentication}} +- 授权策略:{{authorizationPolicy}} +- 数据保护:{{dataProtection}} + +**变量**: +- apiType (text, required): API类型 +- authentication (select, required): 认证方式(JWT、OAuth2、API Key等) +- authorizationPolicy (text, required): 授权策略 +- dataProtection (text, required): 数据保护要求 + +**输出格式**: markdown +**约束**: +- 设计认证流程 +- 定义授权规则 +- 提供加密方案 +- 包含安全最佳实践 + +--- + +## 九、文档和教程提示词 + +### 9.1 用户文档 + +#### DO-001: 工作流使用教程生成器 +**分类**: documentation +**用途**: 生成工作流使用教程 +**角色**: +你是一位技术文档专家,擅长编写清晰易懂的教程。 + +**任务**: +生成工作流使用教程: +- 目标用户:{{targetUser}} +- 功能范围:{{featureScope}} +- 难度级别:{{difficultyLevel}} + +**变量**: +- targetUser (select, required): 目标用户(新手/中级/高级) +- featureScope (text, required): 功能范围 +- difficultyLevel (select, required): 难度级别(入门/中级/高级) + +**输出格式**: markdown +**约束**: +- 使用清晰的步骤说明 +- 包含截图或示例 +- 提供常见问题解答 +- 添加最佳实践 + +--- + +#### DO-002: API文档生成器 +**分类**: documentation +**用途**: 生成API文档 +**角色**: +你是一位API文档专家,熟悉OpenAPI规范和文档编写。 + +**任务**: +生成API文档: +- API定义:{{apiDefinition}} +- 文档风格:{{documentationStyle}} +- 示例需求:{{exampleRequirements}} + +**变量**: +- apiDefinition (text, required): API定义(OpenAPI格式) +- documentationStyle (select, required): 文档风格(简洁/详细/交互式) +- exampleRequirements (text, required): 示例需求 + +**输出格式**: markdown +**约束**: +- 遵循OpenAPI规范 +- 提供完整的接口说明 +- 包含请求响应示例 +- 添加错误码说明 + +--- + +## 十、优化和调优提示词 + +### 10.1 性能优化 + +#### OP-001: 工作流性能优化专家 +**分类**: optimization +**用途**: 优化工作流性能 +**角色**: +你是一位性能优化专家,擅长识别和解决性能瓶颈。 + +**任务**: +优化工作流性能: +- 当前性能:{{currentPerformance}} +- 性能瓶颈:{{performanceBottlenecks}} +- 优化目标:{{optimizationGoals}} + +**变量**: +- currentPerformance (text, required): 当前性能指标 +- performanceBottlenecks (text, required): 性能瓶颈分析 +- optimizationGoals (text, required): 优化目标 + +**输出格式**: markdown +**约束**: +- 识别性能瓶颈 +- 提供优化方案 +- 评估优化效果 +- 考虑成本收益 + +--- + +#### OP-002: Agent响应速度优化器 +**分类**: optimization +**用途**: 优化Agent响应速度 +**角色**: +你是一位AI系统优化专家,熟悉Agent性能优化。 + +**任务**: +优化Agent响应速度: +- Agent配置:{{agentConfig}} +- 当前延迟:{{currentLatency}} +- 目标延迟:{{targetLatency}} + +**变量**: +- agentConfig (text, required): Agent配置 +- currentLatency (text, required): 当前延迟 +- targetLatency (text, required): 目标延迟 + +**输出格式**: markdown +**约束**: +- 分析延迟来源 +- 提供优化策略 +- 包含缓存方案 +- 考虑模型选择 + +--- + +## 📝 使用说明 + +### 提示词模板结构 +每个提示词模板包含以下部分: +1. **模板编号**: 唯一标识符(如WF-001) +2. **分类**: 模板所属分类 +3. **用途**: 模板的使用场景 +4. **角色**: AI扮演的角色定义 +5. **任务**: 具体的任务描述 +6. **变量**: 模板变量定义 +7. **输出格式**: 期望的输出格式 +8. **约束**: 输出约束条件 + +### 变量类型说明 +- **text**: 文本输入 +- **select**: 下拉选择(需提供选项) +- **number**: 数字输入 +- **boolean**: 布尔值 +- **date**: 日期选择 + +### 分类体系 +- **workflow-***: 工作流相关 +- **agent-***: Agent相关 +- **platform-***: 平台功能相关 +- **scenario-***: 场景化模板 +- **system-integration-***: 系统集成 +- **testing-***: 测试相关 +- **deployment-***: 部署相关 +- **security-***: 安全相关 +- **documentation-***: 文档相关 +- **optimization-***: 优化相关 + +--- + +## 🎯 快速索引 + +### 按功能分类 +- **工作流设计**: WF-001, WF-002, WF-003 +- **节点配置**: WF-004, WF-005, WF-006 +- **Agent设计**: AG-001, AG-002, AG-003 +- **Agent执行**: AG-004, AG-005, AG-006 +- **代码生成**: PL-003, PL-004, PL-005 diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流测试工具.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流测试工具.md new file mode 100644 index 0000000..51edff3 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流测试工具.md @@ -0,0 +1,2 @@ +支持通过 Agent 名称测试工作流的工具 +cd /home/renjianbo/aiagent && python3 test_workflow_tool.py -a "内容生成助手" -i "生成一个导出androidlog的脚本" \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流(Workflow)vs Agent(智能体)的区别.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流(Workflow)vs Agent(智能体)的区别.md new file mode 100644 index 0000000..a1bc5f6 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/工作流(Workflow)vs Agent(智能体)的区别.md @@ -0,0 +1,226 @@ +查看项目中工作流和 Agent 的定义与实现,以便准确说明它们的区别。 + +查看 Agent 和 Workflow 的执行逻辑,以明确它们的区别: + +基于代码,说明工作流和 Agent 的区别: + +## 工作流(Workflow)vs Agent(智能体)的区别 + +### 1. 概念层面 + +工作流(Workflow) + +- 定义:可复用的自动化流程模板 + +- 特点:技术导向,关注“如何执行” + +- 用途:流程编排、任务自动化、数据处理管道 + +Agent(智能体) + +- 定义:面向业务场景的智能应用 + +- 特点:业务导向,关注“解决什么问题” + +- 用途:智能助手、专业服务、业务应用 + +### 2. 数据模型层面 + +从代码结构看: + +workflow.pyLines 12-18 + +class Workflow(Base): + +    """工作流表""" + +    __tablename__ = "workflows" + +    id = Column(CHAR(36), primary_key=True, default=lambda: str(uuid.uuid4()), comment="工作流ID") + +    name = Column(String(100), nullable=False, comment="工作流名称") + +    description = Column(Text, comment="描述") + +    nodes = Column(JSON, nullable=False, comment="节点配置") + +    edges = Column(JSON, nullable=False, comment="边配置") + +agent.pyLines 11-18 + +class Agent(Base): + +    """智能体表""" + +    __tablename__ = "agents" + +    id = Column(CHAR(36), primary_key=True, default=lambda: str(uuid.uuid4()), comment="智能体ID") + +    name = Column(String(100), nullable=False, comment="智能体名称") + +    description = Column(Text, comment="描述") + +    workflow_config = Column(JSON, nullable=False, comment="工作流配置") + +区别: + +- Workflow:直接存储 nodes 和 edges + +- Agent:存储 workflow_config(包含 nodes 和 edges) + +### 3. 执行层面 + +从执行代码看,Agent 执行时会提取 workflow_config 并调用工作流引擎: + +executions.pyLines 96-137 + +    elif execution_data.agent_id: + +        agent = db.query(Agent).filter(Agent.id == execution_data.agent_id).first() + +        if not agent: + +            raise HTTPException(status_code=404, detail="智能体不存在") + +        # 检查权限:只有已发布的Agent可以执行,或者所有者可以测试 + +        if agent.status not in ["published", "running"] and agent.user_id != current_user.id: + +            raise HTTPException(status_code=403, detail="Agent未发布或无权执行") + +        # 验证工作流配置 + +        if not agent.workflow_config or "nodes" not in agent.workflow_config or "edges" not in agent.workflow_config: + +            raise HTTPException(status_code=400, detail="Agent工作流配置无效") + +        # 创建执行记录 + +        execution = Execution( + +            agent_id=execution_data.agent_id, + +            input_data=execution_data.input_data, + +            status="pending" + +        ) + +        db.add(execution) + +        db.commit() + +        db.refresh(execution) + +        # 异步执行Agent工作流 + +        workflow_data = { + +            'nodes': agent.workflow_config.get('nodes', []), + +            'edges': agent.workflow_config.get('edges', []) + +        } + +        # 调试:检查节点数据是否包含 api_key + +        logger.debug(f"[rjb] Agent工作流数据: nodes数量={len(workflow_data['nodes'])}") + +        for node in workflow_data['nodes']: + +            if node.get('type') == 'llm': + +                node_data = node.get('data', {}) + +                logger.debug(f"[rjb] LLM节点: node_id={node.get('id')}, data keys={list(node_data.keys())}, api_key={'已配置' if node_data.get('api_key') else '未配置'}") + +        task = execute_workflow_task.delay( + +            str(execution.id), + +            f"agent_{agent.id}",  # 使用agent ID作为workflow_id标识 + +            workflow_data, + +            execution_data.input_data + +        ) + +结论:Agent 和 Workflow 使用同一个执行引擎(WorkflowEngine),但 Agent 是工作流的业务封装。 + +### 4. 使用场景对比 + +|特性|工作流(Workflow)|Agent(智能体)| +|---|---|---| +|定位|技术工具|业务应用| +|使用者|开发者、技术人员|业务用户、最终用户| +|关注点|流程逻辑、节点配置|业务目标、用户体验| +|发布状态|通常用于内部测试|需要发布后才能使用| +|权限控制|相对简单|更严格的权限管理| +|使用方式|直接调用执行|通过 Agent 接口调用| + +### 5. 实际应用示例 + +工作流示例: + +- "数据处理工作流":清洗 → 转换 → 存储 + +- "API 调用工作流":请求 → 验证 → 响应 + +- "文件处理工作流":上传 → 解析 → 分析 + +Agent 示例: + +- "智能客服 Agent":理解问题 → 查询知识库 → 生成回答 + +- "内容创作 Agent":分析需求 → 生成大纲 → 撰写内容 + +- "数据分析 Agent":收集数据 → 分析 → 生成报告 + +### 6. 关系总结 + +Agent(智能体) + +    ↓ 包含 + +workflow_config(工作流配置) + +    ↓ 包含 + +nodes + edges(节点和连接) + +    ↓ 执行 + +WorkflowEngine(工作流引擎) + +简单理解: + +- 工作流 = 可执行的流程模板 + +- Agent = 包装了工作流的业务应用 + +类比: + +- 工作流 = 函数/方法(可复用逻辑) + +- Agent = 应用程序(面向用户的完整应用) + +### 7. 选择建议 + +使用工作流: + +- 需要可复用的流程模板 + +- 技术性任务自动化 + +- 作为其他系统的组件 + +使用 Agent: + +- 面向最终用户的智能应用 + +- 需要发布和权限管理 + +- 业务场景的完整解决方案 + +总结:Agent 是工作流的业务封装,底层执行相同,但定位和使用方式不同。工作流偏技术,Agent 偏业务。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/智能需求分析与解决方案生成器_使用说明.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/智能需求分析与解决方案生成器_使用说明.md new file mode 100644 index 0000000..da13a4f --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/智能需求分析与解决方案生成器_使用说明.md @@ -0,0 +1,539 @@ +# 智能需求分析与解决方案生成器 - 使用说明 + + + +## 📋 Agent 基本信息 + + + +- **名称**: 智能需求分析与解决方案生成器 + +- **状态**: 已发布(可直接使用) + +- **节点数量**: 8个节点 + +- **连接数量**: 8条连接 + +- **Agent ID**: `9195f8df-3340-46a0-b761-b955a57acc6c` + + + +## 🎯 功能概述 + + + +这是一个智能的多节点Agent,能够: + +1. **自动理解用户需求** - 分析用户输入,提取关键信息 + +2. **智能需求分类** - 根据需求类型自动分类(技术方案/业务流程/数据分析等) + +3. **专业方案生成** - 调用专业模板或LLM生成针对性解决方案 + +4. **方案整合优化** - 整合各分支结果,优化输出格式 + +5. **专业文档输出** - 生成结构化的Markdown文档 + + + +## 🔄 工作流结构 + + + +``` + +开始节点 + +  ↓ + +需求理解与分析节点(LLM) + +  ↓ + +需求分类节点(条件判断) + +  ├─→ [技术方案分支] → 技术方案设计节点(Template/LLM) + +  └─→ [业务流程分支] → 业务流程设计节点(Template/LLM) + +         ↓                    ↓ + +         └────→ 方案整合节点(Transform) + +                    ↓ + +           输出优化与格式化节点(LLM) + +                    ↓ + +                结束节点 + +``` + + + +## 📊 节点详细说明 + + + +### 1. 开始节点(start-1) + +- **功能**: 接收用户输入 + +- **输入格式**: JSON格式 + +- **输出**: 将用户输入传递给需求理解节点 + + + +### 2. 需求理解与分析节点(llm-requirement-analysis) + +- **类型**: LLM节点 + +- **模型**: DeepSeek Chat + +- **功能**: + +  - 分析用户需求 + +  - 提取关键信息 + +  - 识别需求类型、复杂度、领域等 + +- **输出格式**: JSON + +  ```json + +  { + +    "requirement_type": "技术方案|业务流程|数据分析|工作流设计|其他", + +    "key_points": ["关键点1", "关键点2", ...], + +    "complexity": "简单|中等|复杂", + +    "domain": "领域(如:电商、金融、教育等)", + +    "summary": "需求摘要" + +  } + +  ``` + + + +### 3. 需求分类节点(condition-classify) + +- **类型**: 条件节点 + +- **功能**: 根据需求类型进行分支 + +- **判断条件**: + +  - 如果需求类型是"技术方案"或"API集成" → 走技术方案分支 + +  - 否则 → 走业务流程分支 + + + +### 4. 技术方案设计节点 + +- **类型**: Template节点(优先)或LLM节点(备用) + +- **功能**: 生成技术方案 + +- **输出内容**: + +  - 技术选型建议 + +  - 架构设计 + +  - 实施步骤 + +  - 风险评估 + +  - 最佳实践建议 + + + +### 5. 业务流程设计节点 + +- **类型**: Template节点(优先)或LLM节点(备用) + +- **功能**: 生成业务流程方案 + +- **输出内容**: + +  - 流程概述 + +  - 关键步骤 + +  - 角色与职责 + +  - 流程优化建议 + +  - 实施路线图 + + + +### 6. 方案整合节点(transform-integration) + +- **类型**: Transform节点 + +- **功能**: 整合各分支的结果 + +- **模式**: 合并模式 + +- **输出**: 包含解决方案、需求分析、时间戳的整合数据 + + + +### 7. 输出优化与格式化节点(llm-optimization) + +- **类型**: LLM节点 + +- **模型**: DeepSeek Chat + +- **功能**: + +  - 优化文档结构 + +  - 补充关键细节 + +  - 添加实施建议 + +  - 统一格式 + +- **输出**: 完整的Markdown文档 + + + +### 8. 结束节点(end-1) + +- **功能**: 返回最终结果 + + + +## 🚀 使用方法 + + + +### 方法一:通过Agent管理界面测试 + + + +1. **进入Agent管理页面** + +   - 在左侧菜单选择"Agent管理" + +   - 找到"智能需求分析与解决方案生成器" + + + +2. **测试Agent** + +   - 点击Agent名称进入详情页 + +   - 点击"测试"按钮 + +   - 在输入框中输入你的需求 + + + +3. **输入示例**: + +   ```json + +   { + +     "query": "我需要设计一个电商系统的用户订单处理流程,包括下单、支付、发货、售后等环节" + +   } + +   ``` + +   或者简单输入: + +   ```json + +   { + +     "query": "设计一个微服务架构的在线教育平台" + +   } + +   ``` + + + +4. **查看结果** + +   - 等待Agent执行完成(通常需要30-60秒) + +   - 查看生成的解决方案文档 + + + +### 方法二:通过API调用 + + + +```bash + +POST /api/v1/executions + +Content-Type: application/json + +Authorization: Bearer + + + +{ + +  "agent_id": "9195f8df-3340-46a0-b761-b955a57acc6c", + +  "input_data": { + +    "query": "你的需求描述" + +  } + +} + +``` + + + +## 💡 使用场景示例 + + + +### 场景1:技术方案设计 + +**输入**: + +``` + +设计一个高并发的实时推荐系统,需要支持千万级用户,毫秒级响应 + +``` + + + +**输出**: + +- 技术选型(Redis、Kafka、Spark等) + +- 架构设计图 + +- 实施步骤 + +- 性能优化建议 + + + +### 场景2:业务流程优化 + +**输入**: + +``` + +优化我们公司的客户服务流程,提高客户满意度 + +``` + + + +**输出**: + +- 当前流程分析 + +- 优化建议 + +- 新流程设计 + +- 实施路线图 + + + +### 场景3:系统架构设计 + +**输入**: + +``` + +设计一个微服务架构的电商平台,包括用户、商品、订单、支付等模块 + +``` + + + +**输出**: + +- 微服务拆分方案 + +- 服务间通信设计 + +- 数据一致性方案 + +- 部署架构 + + + +## ⚙️ 配置说明 + + + +### 节点配置参数 + + + +- **LLM节点温度**: 0.5-0.7(平衡创造性和准确性) + +- **最大Token数**: 2000-3000(确保输出完整) + +- **模型**: DeepSeek Chat(默认) + + + +### 自定义配置 + + + +如果需要修改Agent配置: + +1. 进入Agent管理页面 + +2. 点击"设计"按钮 + +3. 在可视化编辑器中修改节点配置 + +4. 保存并发布 + + + +## 📝 输出格式 + + + +Agent最终输出为结构化的Markdown文档,包含: + + + +1. **需求摘要** + +2. **需求分析结果** + +   - 需求类型 + +   - 关键点 + +   - 复杂度评估 + +   - 领域识别 + +3. **解决方案** + +   - 详细方案内容 + +   - 实施建议 + +   - 最佳实践 + +4. **附录** + +   - 相关资源 + +   - 注意事项 + + + +## 🔍 注意事项 + + + +1. **输入格式**: 建议使用JSON格式,包含`query`字段 + +2. **执行时间**: 复杂需求可能需要60-120秒 + +3. **Token限制**: 如果输出被截断,可以增加`max_tokens`参数 + +4. **需求描述**: 越详细的需求描述,生成的方案越准确 + + + +## 🛠️ 故障排查 + + + +### 问题1:Agent执行超时 + +**解决方案**: + +- 检查网络连接 + +- 确认LLM服务正常 + +- 简化需求描述 + + + +### 问题2:输出不完整 + +**解决方案**: + +- 增加`max_tokens`参数 + +- 分段处理复杂需求 + + + +### 问题3:分类不准确 + +**解决方案**: + +- 在需求描述中明确说明需求类型 + +- 例如:"我需要一个技术方案..."或"请帮我设计业务流程..." + + + +## 📈 性能优化建议 + + + +1. **缓存机制**: 对于相似需求,可以复用之前的分析结果 + +2. **并行处理**: 对于多个独立需求,可以并行执行 + +3. **模板优化**: 根据使用频率优化模板选择逻辑 + + + +## 🔄 更新日志 + + + +- **v1.0** (2026-01-19): 初始版本 + +  - 支持需求理解和分类 + +  - 支持技术方案和业务流程生成 + +  - 支持输出优化和格式化 + + + +## 📞 技术支持 + + + +如有问题或建议,请联系系统管理员或查看系统日志。 + + + +--- + + + +**最后更新**: 2026-01-19 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 1.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 1.md index 39daff9..756860f 100644 --- a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 1.md +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 1.md @@ -1,1241 +1,579 @@ -# 工作流和Agent平台提示词目录 +# 开发低代码智能体平台 - 完整开发提示词 -## 📋 目录结构 +## 📋 项目概述 -本目录基于现代化全栈架构(Next.js/Vue + Python FastAPI + Celery + Redis)设计,涵盖工作流和Agent平台的核心功能场景。 +你是一位资深的全栈开发专家,负责开发一个**工作流和Agent低代码智能体平台**。该平台需要支持可视化工作流设计、智能Agent配置、低代码开发等功能。 --- -## 一、工作流引擎相关提示词 +## 🏗️ 技术架构 -### 1.1 工作流设计助手 +### 核心技术栈 -#### WF-001: 工作流架构设计专家 -**分类**: workflow-design -**用途**: 帮助用户设计工作流架构 -**角色**: -你是一位资深的工作流架构设计专家,拥有丰富的业务流程自动化和智能体系统设计经验。你熟悉各种工作流模式,包括顺序执行、并行处理、条件分支、循环迭代等。 +**前端技术栈**: +- 框架: Vue 3 + TypeScript + Vite +- 状态管理: Pinia +- UI组件库: Element Plus / Ant Design Vue +- 工作流可视化: Vue Flow +- HTTP客户端: Axios +- WebSocket: Socket.io Client +- 路由: Vue Router +- 表单验证: VeeValidate +- 代码编辑器: Monaco Editor -**任务**: -请根据以下需求设计一个工作流架构: -- 业务场景:{{businessScenario}} -- 主要目标:{{mainGoal}} -- 输入数据:{{inputData}} -- 预期输出:{{expectedOutput}} -- 特殊要求:{{specialRequirements}} +**后端技术栈**: +- API框架: Python FastAPI +- 任务队列: Celery + Redis +- 缓存/队列: Redis +- 数据库: PostgreSQL +- ORM: SQLAlchemy +- 数据验证: Pydantic +- Agent框架: LangChain +- RAG框架: LlamaIndex +- 向量数据库: ChromaDB +- WebSocket: FastAPI WebSocket +- API文档: Swagger/OpenAPI -**变量**: -- businessScenario (text, required): 业务场景描述 -- mainGoal (text, required): 主要目标 -- inputData (text, required): 输入数据类型和格式 -- expectedOutput (text, required): 预期输出格式 -- specialRequirements (text, optional): 特殊要求(性能、安全、合规等) - -**输出格式**: markdown -**约束**: -- 提供清晰的工作流节点设计 -- 说明节点间的数据流转 -- 考虑错误处理和异常情况 -- 提供性能优化建议 +**基础设施**: +- 容器化: Docker + Docker Compose +- 反向代理: Nginx +- 进程管理: Supervisor / systemd +- 监控: Prometheus + Grafana +- 日志: ELK Stack (可选) +- CI/CD: GitHub Actions / GitLab CI --- -#### WF-002: 工作流节点类型选择器 -**分类**: workflow-design -**用途**: 帮助选择合适的工作流节点类型 -**角色**: -你是一位工作流节点设计专家,熟悉各种节点类型的特点和适用场景。 +## 🎯 核心功能需求 -**任务**: -根据以下需求,推荐最适合的节点类型组合: -- 功能需求:{{functionRequirement}} -- 数据来源:{{dataSource}} -- 处理复杂度:{{complexity}} -- 性能要求:{{performanceRequirement}} +### 1. 低代码工作流设计器 -**变量**: -- functionRequirement (text, required): 功能需求描述 -- dataSource (text, required): 数据来源(API、数据库、文件等) -- complexity (select, required): 处理复杂度(简单/中等/复杂) -- performanceRequirement (text, optional): 性能要求 +**功能要求**: +- 可视化拖拽式工作流编辑器 +- 支持多种节点类型(开始、模板、条件、数据、工具、结束) +- 节点间连线配置 +- 节点参数配置面板 +- 工作流预览和验证 +- 工作流版本管理 +- 工作流模板库 -**输出格式**: json -**约束**: -- 推荐节点类型(start、template、condition、data、tool、end) -- 说明每个节点的作用 -- 提供节点配置建议 +**技术实现**: +- 使用 Vue Flow 实现可视化编辑器 +- 支持节点拖拽、连线、删除、复制等操作 +- 节点配置表单动态生成 +- 工作流JSON格式存储 +- 实时验证工作流逻辑 + +### 2. 智能Agent平台 + +**功能要求**: +- Agent角色定义和配置 +- Agent工具链管理 +- Agent工作流编排 +- 多Agent协作支持 +- Agent执行监控 +- Agent性能分析 + +**技术实现**: +- 集成 LangChain Agent框架 +- 支持多种Agent类型(ReAct、Plan-and-Execute等) +- 工具注册和管理系统 +- Agent执行状态实时推送(WebSocket) +- 执行日志和结果存储 + +### 3. 工作流执行引擎 + +**功能要求**: +- 异步任务执行(Celery) +- 实时状态推送(WebSocket) +- 错误处理和重试机制 +- 执行历史记录 +- 性能监控和分析 + +**技术实现**: +- FastAPI提供RESTful API +- Celery处理长时间运行的任务 +- Redis作为消息代理 +- WebSocket推送执行状态 +- PostgreSQL存储执行记录 + +### 4. 低代码开发功能 + +**功能要求**: +- 代码生成器(Python、前端代码) +- 自定义节点开发 +- 模板库管理 +- 组件市场 + +**技术实现**: +- 基于工作流定义生成代码 +- 支持自定义节点插件系统 +- 模板存储和管理 +- 组件导入导出功能 --- -#### WF-003: 工作流执行优化专家 -**分类**: workflow-optimization -**用途**: 优化工作流执行性能 -**角色**: -你是一位工作流性能优化专家,擅长分析工作流瓶颈并提供优化方案。 +## 📐 项目结构设计 -**任务**: -分析以下工作流设计,提供性能优化建议: -- 工作流结构:{{workflowStructure}} -- 当前性能指标:{{currentMetrics}} -- 性能瓶颈:{{bottlenecks}} -- 优化目标:{{optimizationGoal}} +### 前端项目结构 -**变量**: -- workflowStructure (text, required): 工作流结构描述或JSON -- currentMetrics (text, required): 当前性能指标(执行时间、资源使用等) -- bottlenecks (text, optional): 已知的性能瓶颈 -- optimizationGoal (text, required): 优化目标(速度、资源、成本等) +``` +frontend/ +├── src/ +│ ├── api/ # API接口封装 +│ ├── assets/ # 静态资源 +│ ├── components/ # 公共组件 +│ │ ├── WorkflowEditor/ # 工作流编辑器 +│ │ ├── NodePanel/ # 节点配置面板 +│ │ ├── AgentConfig/ # Agent配置组件 +│ │ └── CodeGenerator/ # 代码生成器 +│ ├── composables/ # 组合式函数 +│ ├── layouts/ # 布局组件 +│ ├── router/ # 路由配置 +│ ├── stores/ # Pinia状态管理 +│ │ ├── workflow.ts # 工作流状态 +│ │ ├── agent.ts # Agent状态 +│ │ └── user.ts # 用户状态 +│ ├── types/ # TypeScript类型定义 +│ ├── utils/ # 工具函数 +│ └── views/ # 页面组件 +│ ├── WorkflowDesigner.vue +│ ├── AgentStudio.vue +│ └── CodeGenerator.vue +├── public/ +└── package.json +``` -**输出格式**: markdown -**约束**: -- 识别性能瓶颈点 -- 提供具体的优化方案 -- 评估优化效果 -- 考虑成本和收益 +### 后端项目结构 + +``` +backend/ +├── app/ +│ ├── api/ # API路由 +│ │ ├── workflows.py # 工作流API +│ │ ├── agents.py # Agent API +│ │ └── executions.py # 执行API +│ ├── core/ # 核心功能 +│ │ ├── config.py # 配置 +│ │ ├── security.py # 安全 +│ │ └── database.py # 数据库 +│ ├── models/ # 数据模型 +│ │ ├── workflow.py +│ │ ├── agent.py +│ │ └── execution.py +│ ├── services/ # 业务逻辑 +│ │ ├── workflow_engine.py # 工作流引擎 +│ │ ├── agent_service.py # Agent服务 +│ │ └── code_generator.py # 代码生成 +│ ├── tasks/ # Celery任务 +│ │ ├── workflow_tasks.py +│ │ └── agent_tasks.py +│ ├── websocket/ # WebSocket处理 +│ └── utils/ # 工具函数 +├── tests/ # 测试 +├── alembic/ # 数据库迁移 +├── requirements.txt +└── main.py +``` --- -### 1.2 工作流节点配置 +## 🔧 开发任务清单 -#### WF-004: 模板节点配置助手 -**分类**: workflow-node-config -**用途**: 帮助配置模板节点参数 -**角色**: -你是一位AI模型配置专家,熟悉各种AI模型的参数调优和提示词工程。 +### 阶段一: 项目初始化(1-2周) -**任务**: -为以下场景推荐最佳的模板节点配置: -- 使用场景:{{useCase}} -- 模板类型:{{templateType}} -- 数据特点:{{dataCharacteristics}} -- 质量要求:{{qualityRequirement}} +#### 1.1 前端项目搭建 +- [ ] 使用 Vite 创建 Vue 3 + TypeScript 项目 +- [ ] 配置 ESLint、Prettier +- [ ] 安装核心依赖(Vue Flow、Pinia、Element Plus等) +- [ ] 配置路由和布局 +- [ ] 设置API请求拦截器 +- [ ] 配置WebSocket连接 -**变量**: -- useCase (text, required): 使用场景描述 -- templateType (text, required): 模板类型(文本生成、数据分析、代码生成等) -- dataCharacteristics (text, required): 数据特点(结构化、非结构化、多模态等) -- qualityRequirement (text, required): 质量要求(准确性、速度、成本等) +#### 1.2 后端项目搭建 +- [ ] 创建 FastAPI 项目结构 +- [ ] 配置数据库连接(PostgreSQL) +- [ ] 配置 Redis 连接 +- [ ] 设置 Celery 任务队列 +- [ ] 配置 CORS 和中间件 +- [ ] 设置日志系统 +- [ ] 配置环境变量管理 -**输出格式**: json -**约束**: -- 推荐AI模型(GPT-4、Claude、DeepSeek等) -- 设置Temperature、MaxTokens等参数 -- 提供提示词优化建议 +#### 1.3 数据库设计 +- [ ] 设计工作流表结构 +- [ ] 设计Agent表结构 +- [ ] 设计执行记录表结构 +- [ ] 设计用户和权限表 +- [ ] 创建数据库迁移脚本 + +### 阶段二: 核心功能开发(4-6周) + +#### 2.1 工作流编辑器开发 +- [ ] 实现 Vue Flow 基础编辑器 +- [ ] 实现节点拖拽功能 +- [ ] 实现节点连线功能 +- [ ] 实现节点配置面板 +- [ ] 实现工作流保存和加载 +- [ ] 实现工作流验证逻辑 +- [ ] 实现节点类型扩展机制 + +#### 2.2 工作流引擎开发 +- [ ] 实现工作流执行引擎核心逻辑 +- [ ] 实现节点执行器(模板、条件、数据等) +- [ ] 实现数据流转机制 +- [ ] 实现错误处理和重试 +- [ ] 实现执行状态管理 +- [ ] 集成 Celery 异步任务 + +#### 2.3 Agent平台开发 +- [ ] 实现Agent配置界面 +- [ ] 集成 LangChain Agent框架 +- [ ] 实现工具注册和管理 +- [ ] 实现Agent执行逻辑 +- [ ] 实现多Agent协作机制 +- [ ] 实现Agent监控和分析 + +#### 2.4 实时通信开发 +- [ ] 实现 FastAPI WebSocket +- [ ] 实现前端 WebSocket 客户端 +- [ ] 实现执行状态实时推送 +- [ ] 实现消息队列集成 + +### 阶段三: 低代码功能开发(2-3周) + +#### 3.1 代码生成器开发 +- [ ] 实现Python工作流引擎代码生成 +- [ ] 实现前端组件代码生成 +- [ ] 实现API接口代码生成 +- [ ] 实现代码模板管理 +- [ ] 实现代码预览和下载 + +#### 3.2 模板和组件库 +- [ ] 实现工作流模板库 +- [ ] 实现自定义节点开发 +- [ ] 实现组件导入导出 +- [ ] 实现模板市场功能 + +### 阶段四: 系统集成和优化(2-3周) + +#### 4.1 系统集成 +- [ ] 集成向量数据库(ChromaDB) +- [ ] 集成RAG框架(LlamaIndex) +- [ ] 实现第三方API集成 +- [ ] 实现数据库集成 +- [ ] 实现消息队列集成 + +#### 4.2 性能优化 +- [ ] 优化工作流执行性能 +- [ ] 优化前端渲染性能 +- [ ] 实现缓存机制 +- [ ] 优化数据库查询 +- [ ] 实现负载均衡 + +#### 4.3 监控和日志 +- [ ] 集成 Prometheus 监控 +- [ ] 配置 Grafana 仪表板 +- [ ] 实现日志收集和分析 +- [ ] 实现告警机制 + +### 阶段五: 测试和部署(1-2周) + +#### 5.1 测试 +- [ ] 编写单元测试 +- [ ] 编写集成测试 +- [ ] 编写端到端测试 +- [ ] 性能测试 +- [ ] 安全测试 + +#### 5.2 部署 +- [ ] 编写 Dockerfile +- [ ] 编写 docker-compose.yml +- [ ] 配置 Nginx 反向代理 +- [ ] 配置 CI/CD 流水线 +- [ ] 编写部署文档 --- -#### WF-005: 条件节点表达式生成器 -**分类**: workflow-node-config -**用途**: 生成条件节点的表达式 -**角色**: -你是一位逻辑表达式设计专家,擅长将业务逻辑转换为可执行的表达式。 +## 💻 关键代码实现示例 -**任务**: -根据以下业务逻辑,生成条件表达式: -- 业务规则:{{businessRule}} -- 判断条件:{{judgmentCondition}} -- 数据字段:{{dataFields}} -- 逻辑关系:{{logicalRelation}} +### 1. 工作流执行引擎(Python) -**变量**: -- businessRule (text, required): 业务规则描述 -- judgmentCondition (text, required): 判断条件(大于、等于、包含等) -- dataFields (text, required): 涉及的数据字段 -- logicalRelation (select, optional): 逻辑关系(AND、OR、NOT) +```python +# app/services/workflow_engine.py +from typing import Dict, Any, List +from celery import Task +import asyncio +from langchain.llms import OpenAI +from langchain.agents import initialize_agent -**输出格式**: plain-text -**约束**: -- 生成JavaScript兼容的表达式 -- 使用${变量名}格式引用数据 -- 考虑边界情况 -- 提供表达式说明 +class WorkflowEngine: + def __init__(self, workflow_id: str): + self.workflow_id = workflow_id + self.llm = OpenAI(temperature=0.7) + self.nodes = [] + self.edges = [] + + async def execute_node(self, node: Dict[str, Any], input_data: Dict[str, Any]) -> Dict[str, Any]: + """执行单个节点""" + node_type = node.get('type') + + if node_type == 'template': + # 模板节点:调用AI模型 + prompt = self.build_prompt(node, input_data) + result = await self.llm.agenerate([prompt]) + return {'output': result.generations[0][0].text} + + elif node_type == 'condition': + # 条件节点:判断分支 + condition = node.get('condition') + result = self.evaluate_condition(condition, input_data) + return {'output': result, 'branch': 'true' if result else 'false'} + + elif node_type == 'data': + # 数据节点:数据转换 + mapping = node.get('mapping') + result = self.transform_data(input_data, mapping) + return {'output': result} + + elif node_type == 'agent': + # Agent节点:执行Agent + agent = initialize_agent( + tools=node.get('tools', []), + llm=self.llm, + agent="zero-shot-react-description" + ) + result = await agent.arun(node.get('task')) + return {'output': result} + + else: + raise ValueError(f"Unknown node type: {node_type}") + + async def execute(self, input_data: Dict[str, Any]) -> Dict[str, Any]: + """执行完整工作流""" + workflow = self.load_workflow() + self.nodes = workflow['nodes'] + self.edges = workflow['edges'] + + # 构建执行图 + execution_graph = self.build_execution_graph() + + # 按拓扑顺序执行 + results = {} + node_outputs = {'start': input_data} + + for node_id in execution_graph: + node = self.get_node_by_id(node_id) + node_input = self.get_node_input(node_id, node_outputs) + + result = await self.execute_node(node, node_input) + results[node_id] = result + node_outputs[node_id] = result['output'] + + return results +``` + +### 2. 工作流编辑器(Vue 3) + +```vue + + + + +``` + +### 3. FastAPI工作流API + +```python +# app/api/workflows.py +from fastapi import APIRouter, Depends, WebSocket +from sqlalchemy.orm import Session +from app.core.database import get_db +from app.services.workflow_engine import WorkflowEngine +from app.tasks.workflow_tasks import execute_workflow_task +from app.models.workflow import Workflow + +router = APIRouter(prefix="/api/workflows", tags=["workflows"]) + +@router.post("/") +async def create_workflow(workflow_data: dict, db: Session = Depends(get_db)): + """创建工作流""" + workflow = Workflow(**workflow_data) + db.add(workflow) + db.commit() + return {"id": workflow.id, "status": "created"} + +@router.post("/{workflow_id}/execute") +async def execute_workflow(workflow_id: str, input_data: dict, db: Session = Depends(get_db)): + """执行工作流""" + task = execute_workflow_task.delay(workflow_id, input_data) + return {"task_id": task.id, "status": "pending"} + +@router.get("/executions/{task_id}") +async def get_execution_status(task_id: str): + """获取执行状态""" + from app.core.celery_app import celery_app + task = celery_app.AsyncResult(task_id) + return { + "task_id": task_id, + "status": task.status, + "result": task.result if task.ready() else None + } + +@router.websocket("/executions/{task_id}/ws") +async def websocket_execution_status(websocket: WebSocket, task_id: str): + """WebSocket实时推送执行状态""" + await websocket.accept() + # 实现实时状态推送逻辑 + while True: + status = get_task_status(task_id) + await websocket.send_json(status) + await asyncio.sleep(1) +``` + +### 4. Celery任务定义 + +```python +# app/tasks/workflow_tasks.py +from celery import Task +from app.core.celery_app import celery_app +from app.services.workflow_engine import WorkflowEngine +from app.websocket.manager import WebSocketManager + +@celery_app.task(bind=True) +def execute_workflow_task(self, workflow_id: str, input_data: dict): + """执行工作流任务""" + try: + engine = WorkflowEngine(workflow_id) + + # 更新任务状态 + self.update_state(state='PROGRESS', meta={'progress': 0}) + + # 执行工作流 + result = asyncio.run(engine.execute(input_data)) + + # 通过WebSocket推送结果 + WebSocketManager.broadcast(workflow_id, { + 'status': 'completed', + 'result': result + }) + + return result + except Exception as e: + # 错误处理 + WebSocketManager.broadcast(workflow_id, { + 'status': 'failed', + 'error': str(e) + }) + raise +``` --- -#### WF-006: 数据节点映射规则生成器 -**分类**: workflow-node-config -**用途**: 生成数据映射规则 -**角色**: -你是一位数据转换专家,擅长设计数据映射和转换规则。 +## 🎨 UI/UX设计要点 -**任务**: -根据以下需求,生成数据映射规则: -- 输入数据结构:{{inputStructure}} -- 输出数据结构:{{outputStructure}} -- 字段对应关系:{{fieldMapping}} -- 转换规则:{{transformationRules}} +### 1. 工作流编辑器界面 +- 左侧:节点工具箱(可拖拽的节点类型) +- 中间:画布区域(工作流可视化编辑) +- 右侧:节点配置面板(选中节点时显示) +- 顶部:工具栏(保存、运行、预览等) +- 底部:执行日志和状态栏 -**变量**: -- inputStructure (text, required): 输入数据结构(JSON格式) -- outputStructure (text, required): 输出数据结构(JSON格式) -- fieldMapping (text, optional): 字段对应关系 -- transformationRules (text, optional): 特殊转换规则 +### 2. Agent配置界面 +- Agent基本信息配置 +- 工具链选择和管理 +- 提示词编辑器 +- 参数调优面板 +- 测试和预览功能 -**输出格式**: json -**约束**: -- 生成完整的映射规则JSON -- 支持嵌套路径 -- 处理缺失字段 -- 提供默认值建议 +### 3. 代码生成器界面 +- 代码模板选择 +- 参数配置表单 +- 代码预览(语法高亮) +- 下载和导出功能 --- -## 二、Agent平台相关提示词 +## 🔒 安全和权限 -### 2.1 Agent设计 +### 1. 认证和授权 +- JWT Token认证 +- 基于角色的访问控制(RBAC) +- API接口权限控制 +- 工作流和Agent的访问权限 -#### AG-001: Agent角色定义专家 -**分类**: agent-design -**用途**: 帮助定义Agent的角色和能力 -**角色**: -你是一位Agent系统设计专家,熟悉各种Agent架构和角色设计模式。 +### 2. 数据安全 +- 敏感数据加密存储 +- API请求加密传输(HTTPS) +- 工作流执行日志脱敏 +- 数据备份和恢复机制 -**任务**: -为以下场景设计Agent角色: -- Agent名称:{{agentName}} -- 主要职责:{{mainResponsibilities}} -- 专业领域:{{expertiseDomain}} -- 交互方式:{{interactionMode}} -- 能力边界:{{capabilityBoundary}} - -**变量**: -- agentName (text, required): Agent名称 -- mainResponsibilities (text, required): 主要职责 -- expertiseDomain (text, required): 专业领域 -- interactionMode (select, required): 交互方式(对话、任务执行、数据分析等) -- capabilityBoundary (text, required): 能力边界和限制 - -**输出格式**: markdown -**约束**: -- 定义清晰的Agent身份 -- 说明核心能力 -- 明确能力边界 -- 提供使用场景示例 +### 3. 安全审计 +- 操作日志记录 +- 异常行为检测 +- 安全漏洞扫描 +- 合规性检查 --- -#### AG-002: Agent工具链设计器 -**分类**: agent-design -**用途**: 设计Agent的工具链 -**角色**: -你是一位工具集成专家,熟悉各种API、数据库、文件处理等工具的使用。 +## 📊 性能优化策略 -**任务**: -为以下Agent设计工具链: -- Agent类型:{{agentType}} -- 核心功能:{{coreFunctions}} -- 数据需求:{{dataRequirements}} -- 外部服务:{{externalServices}} - -**变量**: -- agentType (text, required): Agent类型(研究型、执行型、分析型等) -- coreFunctions (text, required): 核心功能列表 -- dataRequirements (text, required): 数据需求(读取、写入、查询等) -- externalServices (text, optional): 需要集成的外部服务 - -**输出格式**: json -**约束**: -- 列出必需的工具 -- 说明每个工具的用途 -- 提供工具配置建议 -- 考虑工具间的依赖关系 - ---- - -#### AG-003: Agent工作流编排器 -**分类**: agent-orchestration -**用途**: 编排多个Agent的协作流程 -**角色**: -你是一位多Agent系统架构师,擅长设计Agent间的协作模式。 - -**任务**: -设计一个多Agent协作工作流: -- 参与Agent:{{participatingAgents}} -- 协作目标:{{collaborationGoal}} -- 数据流转:{{dataFlow}} -- 协调机制:{{coordinationMechanism}} - -**变量**: -- participatingAgents (text, required): 参与的Agent列表和角色 -- collaborationGoal (text, required): 协作目标 -- dataFlow (text, required): 数据流转路径 -- coordinationMechanism (select, required): 协调机制(顺序、并行、主从、对等) - -**输出格式**: markdown -**约束**: -- 设计清晰的协作流程 -- 定义Agent间的接口 -- 考虑冲突解决机制 -- 提供错误处理方案 - ---- - -### 2.2 Agent执行 - -#### AG-004: Agent任务分解器 -**分类**: agent-execution -**用途**: 将复杂任务分解为Agent可执行的子任务 -**角色**: -你是一位任务规划专家,擅长将复杂任务分解为可执行的步骤。 - -**任务**: -将以下复杂任务分解为Agent可执行的子任务: -- 主任务:{{mainTask}} -- 任务复杂度:{{taskComplexity}} -- 可用资源:{{availableResources}} -- 时间限制:{{timeLimit}} - -**变量**: -- mainTask (text, required): 主任务描述 -- taskComplexity (select, required): 任务复杂度(简单/中等/复杂) -- availableResources (text, required): 可用资源(工具、数据、API等) -- timeLimit (text, optional): 时间限制 - -**输出格式**: json -**约束**: -- 分解为清晰的子任务 -- 定义任务间的依赖关系 -- 估计每个任务的执行时间 -- 标识关键路径 - ---- - -#### AG-005: Agent决策助手 -**分类**: agent-execution -**用途**: 帮助Agent做出决策 -**角色**: -你是一位决策分析专家,擅长基于多因素进行决策分析。 - -**任务**: -基于以下信息,为Agent提供决策建议: -- 决策场景:{{decisionScenario}} -- 可选方案:{{options}} -- 评估标准:{{evaluationCriteria}} -- 约束条件:{{constraints}} - -**变量**: -- decisionScenario (text, required): 决策场景描述 -- options (text, required): 可选方案列表 -- evaluationCriteria (text, required): 评估标准 -- constraints (text, optional): 约束条件 - -**输出格式**: json -**约束**: -- 分析每个方案的优缺点 -- 给出推荐方案 -- 说明推荐理由 -- 提供风险评估 - ---- - -#### AG-006: Agent错误恢复策略生成器 -**分类**: agent-execution -**用途**: 生成Agent错误恢复策略 -**角色**: -你是一位系统可靠性专家,擅长设计错误处理和恢复机制。 - -**任务**: -为以下Agent设计错误恢复策略: -- Agent类型:{{agentType}} -- 常见错误:{{commonErrors}} -- 错误影响:{{errorImpact}} -- 恢复目标:{{recoveryGoal}} - -**变量**: -- agentType (text, required): Agent类型 -- commonErrors (text, required): 常见错误类型 -- errorImpact (text, required): 错误影响范围 -- recoveryGoal (text, required): 恢复目标(快速恢复、数据一致性等) - -**输出格式**: markdown -**约束**: -- 针对每种错误提供恢复策略 -- 定义重试机制 -- 提供降级方案 -- 考虑数据一致性 - ---- - -## 三、平台功能相关提示词 - -### 3.1 用户引导 - -#### PL-001: 工作流创建向导 -**分类**: platform-guide -**用途**: 引导用户创建工作流 -**角色**: -你是一位友好的平台助手,擅长用简单易懂的方式引导用户。 - -**任务**: -为新用户提供工作流创建指导: -- 用户目标:{{userGoal}} -- 用户经验:{{userExperience}} -- 业务场景:{{businessScenario}} - -**变量**: -- userGoal (text, required): 用户想要实现的目标 -- userExperience (select, required): 用户经验(新手/中级/高级) -- businessScenario (text, required): 业务场景描述 - -**输出格式**: markdown -**约束**: -- 使用友好的语言 -- 提供分步骤指导 -- 包含示例说明 -- 提供常见问题解答 - ---- - -#### PL-002: Agent配置助手 -**分类**: platform-guide -**用途**: 帮助用户配置Agent -**角色**: -你是一位Agent配置专家,熟悉各种Agent配置参数。 - -**任务**: -指导用户配置Agent: -- Agent用途:{{agentPurpose}} -- 使用场景:{{useCase}} -- 技术背景:{{technicalBackground}} - -**变量**: -- agentPurpose (text, required): Agent用途 -- useCase (text, required): 使用场景 -- technicalBackground (select, required): 技术背景(非技术/初级/中级/高级) - -**输出格式**: markdown -**约束**: -- 提供配置步骤 -- 解释每个参数的作用 -- 提供推荐配置 -- 包含最佳实践 - ---- - -### 3.2 代码生成 - -#### PL-003: Python工作流引擎代码生成器 -**分类**: code-generation -**用途**: 生成Python工作流引擎代码 -**角色**: -你是一位Python开发专家,熟悉FastAPI、Celery、异步编程等。 - -**任务**: -根据以下工作流设计,生成Python工作流引擎代码: -- 工作流定义:{{workflowDefinition}} -- 节点类型:{{nodeTypes}} -- 执行模式:{{executionMode}} -- 框架要求:{{frameworkRequirements}} - -**变量**: -- workflowDefinition (text, required): 工作流定义(JSON格式) -- nodeTypes (text, required): 节点类型列表 -- executionMode (select, required): 执行模式(同步/异步/混合) -- frameworkRequirements (text, optional): 框架要求(FastAPI、Celery等) - -**输出格式**: plain-text -**约束**: -- 使用FastAPI框架 -- 集成Celery任务队列 -- 支持异步执行 -- 包含错误处理 -- 提供API文档 - ---- - -#### PL-004: 前端工作流编辑器代码生成器 -**分类**: code-generation -**用途**: 生成前端工作流编辑器代码 -**角色**: -你是一位前端开发专家,熟悉React、Vue、工作流可视化库。 - -**任务**: -生成工作流可视化编辑器代码: -- 前端框架:{{frontendFramework}} -- 可视化库:{{visualizationLibrary}} -- 功能需求:{{featureRequirements}} -- UI风格:{{uiStyle}} - -**变量**: -- frontendFramework (select, required): 前端框架(React/Vue) -- visualizationLibrary (select, required): 可视化库(React Flow/Vue Flow) -- featureRequirements (text, required): 功能需求(拖拽、连线、配置等) -- uiStyle (text, optional): UI风格要求 - -**输出格式**: plain-text -**约束**: -- 使用推荐的框架和库 -- 实现拖拽式编辑 -- 支持节点配置 -- 响应式设计 -- 包含类型定义 - ---- - -#### PL-005: API接口代码生成器 -**分类**: code-generation -**用途**: 生成RESTful API接口代码 -**角色**: -你是一位API设计专家,熟悉RESTful API设计和OpenAPI规范。 - -**任务**: -生成以下功能的API接口代码: -- API功能:{{apiFunction}} -- 数据模型:{{dataModel}} -- 认证方式:{{authentication}} -- 框架:{{framework}} - -**变量**: -- apiFunction (text, required): API功能描述 -- dataModel (text, required): 数据模型(JSON格式) -- authentication (select, required): 认证方式(JWT、OAuth、API Key等) -- framework (select, required): 框架(FastAPI、Express、Next.js等) - -**输出格式**: plain-text -**约束**: -- 遵循RESTful规范 -- 包含请求验证 -- 提供错误处理 -- 生成OpenAPI文档 -- 包含单元测试示例 - ---- - -### 3.3 数据分析 - -#### PL-006: 工作流执行分析器 -**分类**: data-analysis -**用途**: 分析工作流执行数据 -**角色**: -你是一位数据分析专家,擅长从执行数据中提取洞察。 - -**任务**: -分析以下工作流执行数据: -- 执行记录:{{executionRecords}} -- 分析维度:{{analysisDimensions}} -- 关注指标:{{keyMetrics}} - -**变量**: -- executionRecords (text, required): 执行记录(JSON格式) -- analysisDimensions (text, required): 分析维度(性能、成功率、错误等) -- keyMetrics (text, required): 关注的指标 - -**输出格式**: markdown -**约束**: -- 提供数据可视化建议 -- 识别异常模式 -- 给出优化建议 -- 包含趋势分析 - ---- - -#### PL-007: Agent性能评估器 -**分类**: data-analysis -**用途**: 评估Agent性能 -**角色**: -你是一位AI系统评估专家,熟悉各种性能评估指标。 - -**任务**: -评估以下Agent的性能: -- Agent配置:{{agentConfig}} -- 执行数据:{{executionData}} -- 评估标准:{{evaluationCriteria}} - -**变量**: -- agentConfig (text, required): Agent配置信息 -- executionData (text, required): 执行数据(响应时间、成功率等) -- evaluationCriteria (text, required): 评估标准 - -**输出格式**: json -**约束**: -- 计算关键性能指标 -- 对比基准值 -- 识别性能瓶颈 -- 提供改进建议 - ---- - -## 四、场景化提示词模板 - -### 4.1 内容生成场景 - -#### SC-001: 多步骤内容生成工作流 -**分类**: content-generation -**用途**: 生成多步骤内容创作工作流 -**角色**: -你是一位内容创作专家,熟悉内容生成的完整流程。 - -**任务**: -设计一个多步骤内容生成工作流: -- 内容类型:{{contentType}} -- 生成步骤:{{generationSteps}} -- 质量要求:{{qualityRequirement}} - -**变量**: -- contentType (text, required): 内容类型(文章、视频脚本、营销文案等) -- generationSteps (text, required): 生成步骤(大纲、初稿、优化、润色等) -- qualityRequirement (text, required): 质量要求 - -**输出格式**: markdown -**约束**: -- 设计清晰的步骤流程 -- 定义每个步骤的输入输出 -- 提供质量检查点 - ---- - -#### SC-002: 智能内容审核工作流 -**分类**: content-moderation -**用途**: 设计内容审核工作流 -**角色**: -你是一位内容审核专家,熟悉各种审核标准和流程。 - -**任务**: -设计内容审核工作流: -- 审核类型:{{moderationType}} -- 审核标准:{{moderationStandards}} -- 处理流程:{{handlingProcess}} - -**变量**: -- moderationType (text, required): 审核类型(文本、图片、视频等) -- moderationStandards (text, required): 审核标准 -- handlingProcess (text, required): 处理流程(通过/拒绝/人工审核) - -**输出格式**: markdown -**约束**: -- 定义审核规则 -- 设计分级审核机制 -- 提供人工审核触发条件 - ---- - -### 4.2 数据处理场景 - -#### SC-003: 数据清洗和转换工作流 -**分类**: data-processing -**用途**: 设计数据清洗工作流 -**角色**: -你是一位数据处理专家,熟悉数据清洗和转换技术。 - -**任务**: -设计数据清洗和转换工作流: -- 数据来源:{{dataSource}} -- 数据质量:{{dataQuality}} -- 目标格式:{{targetFormat}} - -**变量**: -- dataSource (text, required): 数据来源和格式 -- dataQuality (text, required): 数据质量问题 -- targetFormat (text, required): 目标数据格式 - -**输出格式**: markdown -**约束**: -- 定义清洗规则 -- 设计转换步骤 -- 提供质量验证 - ---- - -#### SC-004: 实时数据分析工作流 -**分类**: data-analysis -**用途**: 设计实时数据分析工作流 -**角色**: -你是一位实时数据分析专家,熟悉流式数据处理。 - -**任务**: -设计实时数据分析工作流: -- 数据流:{{dataStream}} -- 分析目标:{{analysisGoal}} -- 实时性要求:{{realtimeRequirement}} - -**变量**: -- dataStream (text, required): 数据流描述 -- analysisGoal (text, required): 分析目标 -- realtimeRequirement (text, required): 实时性要求(延迟、吞吐量) - -**输出格式**: markdown -**约束**: -- 设计流式处理架构 -- 定义分析指标 -- 提供告警机制 - ---- - -### 4.3 智能客服场景 - -#### SC-005: 智能客服Agent -**分类**: customer-service -**用途**: 设计智能客服Agent -**角色**: -你是一位智能客服系统专家,熟悉对话系统和客户服务流程。 - -**任务**: -设计智能客服Agent: -- 服务领域:{{serviceDomain}} -- 常见问题:{{commonQuestions}} -- 服务标准:{{serviceStandards}} - -**变量**: -- serviceDomain (text, required): 服务领域 -- commonQuestions (text, required): 常见问题类型 -- serviceStandards (text, required): 服务标准(响应时间、解决率等) - -**输出格式**: markdown -**约束**: -- 设计对话流程 -- 定义知识库结构 -- 提供转人工机制 - ---- - -#### SC-006: 多轮对话工作流 -**分类**: conversation -**用途**: 设计多轮对话工作流 -**角色**: -你是一位对话系统专家,熟悉多轮对话设计。 - -**任务**: -设计多轮对话工作流: -- 对话目标:{{conversationGoal}} -- 对话轮次:{{conversationTurns}} -- 上下文管理:{{contextManagement}} - -**变量**: -- conversationGoal (text, required): 对话目标 -- conversationTurns (text, required): 预期对话轮次 -- contextManagement (text, required): 上下文管理需求 - -**输出格式**: markdown -**约束**: -- 设计对话状态机 -- 定义上下文存储策略 -- 提供对话恢复机制 - ---- - -### 4.4 自动化任务场景 - -#### SC-007: 定时任务Agent -**分类**: automation -**用途**: 设计定时任务Agent -**角色**: -你是一位自动化专家,熟悉定时任务和调度系统。 - -**任务**: -设计定时任务Agent: -- 任务类型:{{taskType}} -- 执行频率:{{executionFrequency}} -- 依赖关系:{{dependencies}} - -**变量**: -- taskType (text, required): 任务类型 -- executionFrequency (text, required): 执行频率(每天、每周、自定义) -- dependencies (text, optional): 任务依赖关系 - -**输出格式**: markdown -**约束**: -- 设计调度策略 -- 定义重试机制 -- 提供监控告警 - ---- - -#### SC-008: 事件驱动工作流 -**分类**: event-driven -**用途**: 设计事件驱动工作流 -**角色**: -你是一位事件驱动架构专家,熟悉事件处理和消息队列。 - -**任务**: -设计事件驱动工作流: -- 事件类型:{{eventTypes}} -- 事件源:{{eventSources}} -- 处理逻辑:{{processingLogic}} - -**变量**: -- eventTypes (text, required): 事件类型列表 -- eventSources (text, required): 事件源(API、数据库、消息队列等) -- processingLogic (text, required): 处理逻辑 - -**输出格式**: markdown -**约束**: -- 设计事件处理流程 -- 定义事件路由规则 -- 提供事件重放机制 - ---- - -## 五、系统集成提示词 - -### 5.1 API集成 - -#### SI-001: 第三方API集成设计器 -**分类**: system-integration -**用途**: 设计第三方API集成方案 -**角色**: -你是一位API集成专家,熟悉各种API集成模式和最佳实践。 - -**任务**: -设计第三方API集成方案: -- API类型:{{apiType}} -- 集成目标:{{integrationGoal}} -- 认证方式:{{authentication}} -- 错误处理:{{errorHandling}} - -**变量**: -- apiType (text, required): API类型(REST、GraphQL、gRPC等) -- integrationGoal (text, required): 集成目标 -- authentication (text, required): 认证方式 -- errorHandling (text, required): 错误处理策略 - -**输出格式**: markdown -**约束**: -- 设计集成架构 -- 定义接口规范 -- 提供错误处理方案 -- 包含重试和降级策略 - ---- - -#### SI-002: 数据库集成设计器 -**分类**: system-integration -**用途**: 设计数据库集成方案 -**角色**: -你是一位数据库专家,熟悉各种数据库的集成方式。 - -**任务**: -设计数据库集成方案: -- 数据库类型:{{databaseType}} -- 操作类型:{{operationType}} -- 性能要求:{{performanceRequirement}} -- 数据一致性:{{dataConsistency}} - -**变量**: -- databaseType (select, required): 数据库类型(PostgreSQL、MySQL、MongoDB、Redis等) -- operationType (text, required): 操作类型(读取、写入、查询、事务等) -- performanceRequirement (text, required): 性能要求 -- dataConsistency (text, required): 数据一致性要求 - -**输出格式**: markdown -**约束**: -- 设计数据访问层 -- 定义连接池配置 -- 提供事务处理方案 -- 包含缓存策略 - ---- - -### 5.2 消息队列集成 - -#### SI-003: 消息队列工作流设计器 -**分类**: system-integration -**用途**: 设计基于消息队列的工作流 -**角色**: -你是一位消息队列专家,熟悉RabbitMQ、Kafka、Redis等消息中间件。 - -**任务**: -设计基于消息队列的工作流: -- 消息队列:{{messageQueue}} -- 消息类型:{{messageTypes}} -- 处理模式:{{processingPattern}} -- 可靠性要求:{{reliabilityRequirement}} - -**变量**: -- messageQueue (select, required): 消息队列(RabbitMQ、Kafka、Redis Streams等) -- messageTypes (text, required): 消息类型 -- processingPattern (select, required): 处理模式(发布订阅、点对点、流处理) -- reliabilityRequirement (text, required): 可靠性要求(至少一次、恰好一次、最多一次) - -**输出格式**: markdown -**约束**: -- 设计消息路由规则 -- 定义消息格式 -- 提供消息确认机制 -- 包含死信队列处理 - ---- - -## 六、测试和调试提示词 - -### 6.1 工作流测试 - -#### TE-001: 工作流测试用例生成器 -**分类**: testing -**用途**: 生成工作流测试用例 -**角色**: -你是一位测试专家,熟悉工作流测试方法。 - -**任务**: -为以下工作流生成测试用例: -- 工作流定义:{{workflowDefinition}} -- 测试类型:{{testType}} -- 覆盖目标:{{coverageGoal}} - -**变量**: -- workflowDefinition (text, required): 工作流定义 -- testType (select, required): 测试类型(单元测试、集成测试、端到端测试) -- coverageGoal (text, required): 覆盖目标(节点覆盖、路径覆盖、条件覆盖) - -**输出格式**: json -**约束**: -- 生成完整的测试用例 -- 包含正常流程和异常流程 -- 提供测试数据 -- 定义预期结果 - ---- - -#### TE-002: Agent行为测试生成器 -**分类**: testing -**用途**: 生成Agent行为测试用例 -**角色**: -你是一位AI系统测试专家,熟悉Agent行为测试。 - -**任务**: -生成Agent行为测试用例: -- Agent配置:{{agentConfig}} -- 测试场景:{{testScenarios}} -- 评估标准:{{evaluationCriteria}} - -**变量**: -- agentConfig (text, required): Agent配置 -- testScenarios (text, required): 测试场景 -- evaluationCriteria (text, required): 评估标准 - -**输出格式**: json -**约束**: -- 设计多样化测试场景 -- 包含边界情况 -- 提供评估指标 -- 定义通过标准 - ---- - -### 6.2 性能测试 - -#### TE-003: 工作流性能测试方案 -**分类**: performance-testing -**用途**: 设计工作流性能测试方案 -**角色**: -你是一位性能测试专家,熟悉负载测试和压力测试。 - -**任务**: -设计工作流性能测试方案: -- 工作流复杂度:{{workflowComplexity}} -- 性能目标:{{performanceTargets}} -- 测试环境:{{testEnvironment}} - -**变量**: -- workflowComplexity (select, required): 工作流复杂度(简单/中等/复杂) -- performanceTargets (text, required): 性能目标(响应时间、吞吐量、并发数) -- testEnvironment (text, required): 测试环境描述 - -**输出格式**: markdown -**约束**: -- 设计测试场景 -- 定义性能指标 -- 提供测试工具建议 -- 包含结果分析方法 - ---- - -## 七、部署和运维提示词 - -### 7.1 部署配置 - -#### DE-001: 容器化部署配置生成器 -**分类**: deployment -**用途**: 生成Docker容器化配置 -**角色**: -你是一位DevOps专家,熟悉容器化部署和编排。 - -**任务**: -生成容器化部署配置: -- 服务类型:{{serviceType}} -- 依赖服务:{{dependencies}} -- 资源配置:{{resourceRequirements}} -- 环境变量:{{environmentVariables}} - -**变量**: -- serviceType (text, required): 服务类型(前端、后端、工作流引擎等) -- dependencies (text, required): 依赖服务(数据库、Redis、消息队列等) -- resourceRequirements (text, required): 资源配置(CPU、内存、存储) -- environmentVariables (text, required): 环境变量配置 - -**输出格式**: plain-text -**约束**: -- 生成Dockerfile -- 提供docker-compose.yml -- 包含健康检查 -- 提供部署脚本 - ---- - -#### DE-002: Kubernetes部署配置生成器 -**分类**: deployment -**用途**: 生成Kubernetes部署配置 -**角色**: -你是一位Kubernetes专家,熟悉K8s部署和编排。 - -**任务**: -生成Kubernetes部署配置: -- 应用架构:{{applicationArchitecture}} -- 副本数量:{{replicaCount}} -- 服务发现:{{serviceDiscovery}} -- 配置管理:{{configManagement}} - -**变量**: -- applicationArchitecture (text, required): 应用架构描述 -- replicaCount (text, required): 副本数量配置 -- serviceDiscovery (text, required): 服务发现需求 -- configManagement (text, required): 配置管理方式 - -**输出格式**: yaml -**约束**: -- 生成Deployment配置 -- 提供Service配置 -- 包含ConfigMap和Secret -- 定义资源限制 - ---- - -### 7.2 监控和告警 - -#### DE-003: 监控指标设计器 -**分类**: monitoring -**用途**: 设计系统监控指标 -**角色**: -你是一位监控专家,熟悉各种监控指标和告警策略。 - -**任务**: -设计系统监控指标: -- 系统组件:{{systemComponents}} -- 关键指标:{{keyMetrics}} -- 告警阈值:{{alertThresholds}} - -**变量**: -- systemComponents (text, required): 系统组件列表 -- keyMetrics (text, required): 关键指标(CPU、内存、响应时间、错误率等) -- alertThresholds (text, required): 告警阈值配置 - -**输出格式**: json -**约束**: -- 定义完整的监控指标 -- 设置合理的告警阈值 -- 提供告警规则 -- 包含仪表板配置建议 - ---- - -## 八、安全和合规提示词 - -### 8.1 安全设计 - -#### SE-001: 工作流安全审计器 -**分类**: security -**用途**: 审计工作流安全性 -**角色**: -你是一位安全专家,熟悉系统安全最佳实践。 - -**任务**: -审计工作流安全性: -- 工作流定义:{{workflowDefinition}} -- 数据敏感性:{{dataSensitivity}} -- 合规要求:{{complianceRequirements}} - -**变量**: -- workflowDefinition (text, required): 工作流定义 -- dataSensitivity (text, required): 数据敏感性级别 -- complianceRequirements (text, optional): 合规要求(GDPR、HIPAA等) - -**输出格式**: markdown -**约束**: -- 识别安全风险 -- 提供安全加固建议 -- 定义访问控制策略 -- 包含数据加密方案 - ---- - -#### SE-002: API安全配置生成器 -**分类**: security -**用途**: 生成API安全配置 -**角色**: -你是一位API安全专家,熟悉各种API安全机制。 - -**任务**: -生成API安全配置: -- API类型:{{apiType}} -- 认证方式:{{authentication}} -- 授权策略:{{authorizationPolicy}} -- 数据保护:{{dataProtection}} - -**变量**: -- apiType (text, required): API类型 -- authentication (select, required): 认证方式(JWT、OAuth2、API Key等) -- authorizationPolicy (text, required): 授权策略 -- dataProtection (text, required): 数据保护要求 - -**输出格式**: markdown -**约束**: -- 设计认证流程 -- 定义授权规则 -- 提供加密方案 -- 包含安全最佳实践 - ---- - -## 九、文档和教程提示词 - -### 9.1 用户文档 - -#### DO-001: 工作流使用教程生成器 -**分类**: documentation -**用途**: 生成工作流使用教程 -**角色**: -你是一位技术文档专家,擅长编写清晰易懂的教程。 - -**任务**: -生成工作流使用教程: -- 目标用户:{{targetUser}} -- 功能范围:{{featureScope}} -- 难度级别:{{difficultyLevel}} - -**变量**: -- targetUser (select, required): 目标用户(新手/中级/高级) -- featureScope (text, required): 功能范围 -- difficultyLevel (select, required): 难度级别(入门/中级/高级) - -**输出格式**: markdown -**约束**: -- 使用清晰的步骤说明 -- 包含截图或示例 -- 提供常见问题解答 -- 添加最佳实践 - ---- - -#### DO-002: API文档生成器 -**分类**: documentation -**用途**: 生成API文档 -**角色**: -你是一位API文档专家,熟悉OpenAPI规范和文档编写。 - -**任务**: -生成API文档: -- API定义:{{apiDefinition}} -- 文档风格:{{documentationStyle}} -- 示例需求:{{exampleRequirements}} - -**变量**: -- apiDefinition (text, required): API定义(OpenAPI格式) -- documentationStyle (select, required): 文档风格(简洁/详细/交互式) -- exampleRequirements (text, required): 示例需求 - -**输出格式**: markdown -**约束**: -- 遵循OpenAPI规范 -- 提供完整的接口说明 -- 包含请求响应示例 -- 添加错误码说明 - ---- - -## 十、优化和调优提示词 - -### 10.1 性能优化 - -#### OP-001: 工作流性能优化专家 -**分类**: optimization -**用途**: 优化工作流性能 -**角色**: -你是一位性能优化专家,擅长识别和解决性能瓶颈。 - -**任务**: -优化工作流性能: -- 当前性能:{{currentPerformance}} -- 性能瓶颈:{{performanceBottlenecks}} -- 优化目标:{{optimizationGoals}} - -**变量**: -- currentPerformance (text, required): 当前性能指标 -- performanceBottlenecks (text, required): 性能瓶颈分析 -- optimizationGoals (text, required): 优化目标 - -**输出格式**: markdown -**约束**: -- 识别性能瓶颈 -- 提供优化方案 -- 评估优化效果 -- 考虑成本收益 - ---- - -#### OP-002: Agent响应速度优化器 -**分类**: optimization -**用途**: 优化Agent响应速度 -**角色**: -你是一位AI系统优化专家,熟悉Agent性能优化。 - -**任务**: -优化Agent响应速度: -- Agent配置:{{agentConfig}} -- 当前延迟:{{currentLatency}} -- 目标延迟:{{targetLatency}} - -**变量**: -- agentConfig (text, required): Agent配置 -- currentLatency (text, required): 当前延迟 -- targetLatency (text, required): 目标延迟 - -**输出格式**: markdown -**约束**: -- 分析延迟来源 -- 提供优化策略 -- 包含缓存方案 -- 考虑模型选择 - ---- - -## 📝 使用说明 - -### 提示词模板结构 -每个提示词模板包含以下部分: -1. **模板编号**: 唯一标识符(如WF-001) -2. **分类**: 模板所属分类 -3. **用途**: 模板的使用场景 -4. **角色**: AI扮演的角色定义 -5. **任务**: 具体的任务描述 -6. **变量**: 模板变量定义 -7. **输出格式**: 期望的输出格式 -8. **约束**: 输出约束条件 - -### 变量类型说明 -- **text**: 文本输入 -- **select**: 下拉选择(需提供选项) -- **number**: 数字输入 -- **boolean**: 布尔值 -- **date**: 日期选择 - -### 分类体系 -- **workflow-***: 工作流相关 -- **agent-***: Agent相关 -- **platform-***: 平台功能相关 -- **scenario-***: 场景化模板 -- **system-integration-***: 系统集成 -- **testing-***: 测试相关 -- **deployment-***: 部署相关 -- **security-***: 安全相关 -- **documentation-***: 文档相关 -- **optimization-***: 优化相关 - ---- - -## 🎯 快速索引 - -### 按功能分类 -- **工作流设计**: WF-001, WF-002, WF-003 -- **节点配置**: WF-004, WF-005, WF-006 -- **Agent设计**: AG-001, AG-002, AG-003 -- **Agent执行**: AG-004, AG-005, AG-006 -- **代码生成**: PL-003, PL-004, PL-005 +### 1. 前端优化 +- 代码分割 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 2.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 2.md new file mode 100644 index 0000000..c8a2913 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 2.md @@ -0,0 +1,2739 @@ +# 开发低代码智能体平台 - 完整开发提示词 + + + +## 📋 项目概述 + + + +你是一位资深的全栈开发专家,负责开发一个**工作流和Agent低代码智能体平台**。该平台需要支持可视化工作流设计、智能Agent配置、低代码开发等功能。 + + + +--- + + + +## 🏗️ 技术架构 + + + +### 核心技术栈 + + + +**前端技术栈**: + +- 框架: Vue 3 + TypeScript + Vite + +- 状态管理: Pinia + +- UI组件库: Element Plus / Ant Design Vue + +- 工作流可视化: Vue Flow + +- HTTP客户端: Axios + +- WebSocket: Socket.io Client + +- 路由: Vue Router + +- 表单验证: VeeValidate + +- 代码编辑器: Monaco Editor + + + +**后端技术栈**: + +- API框架: Python FastAPI + +- 任务队列: Celery + Redis + +- 缓存/队列: Redis + +- 数据库: PostgreSQL + +- ORM: SQLAlchemy + +- 数据验证: Pydantic + +- Agent框架: LangChain + +- RAG框架: LlamaIndex + +- 向量数据库: ChromaDB + +- WebSocket: FastAPI WebSocket + +- API文档: Swagger/OpenAPI + + + +**基础设施**: + +- 容器化: Docker + Docker Compose + +- 反向代理: Nginx + +- 进程管理: Supervisor / systemd + +- 监控: Prometheus + Grafana + +- 日志: ELK Stack (可选) + +- CI/CD: GitHub Actions / GitLab CI + + + +--- + + + +## 🎯 核心功能需求 + + + +### 1. 低代码工作流设计器 + + + +**功能要求**: + +- 可视化拖拽式工作流编辑器 + +- 支持多种节点类型(开始、模板、条件、数据、工具、结束) + +- 节点间连线配置 + +- 节点参数配置面板 + +- 工作流预览和验证 + +- 工作流版本管理 + +- 工作流模板库 + + + +**技术实现**: + +- 使用 Vue Flow 实现可视化编辑器 + +- 支持节点拖拽、连线、删除、复制等操作 + +- 节点配置表单动态生成 + +- 工作流JSON格式存储 + +- 实时验证工作流逻辑 + + + +### 2. 智能Agent平台 + + + +**功能要求**: + +- Agent角色定义和配置 + +- Agent工具链管理 + +- Agent工作流编排 + +- 多Agent协作支持 + +- Agent执行监控 + +- Agent性能分析 + + + +**技术实现**: + +- 集成 LangChain Agent框架 + +- 支持多种Agent类型(ReAct、Plan-and-Execute等) + +- 工具注册和管理系统 + +- Agent执行状态实时推送(WebSocket) + +- 执行日志和结果存储 + + + +### 3. 工作流执行引擎 + + + +**功能要求**: + +- 异步任务执行(Celery) + +- 实时状态推送(WebSocket) + +- 错误处理和重试机制 + +- 执行历史记录 + +- 性能监控和分析 + + + +**技术实现**: + +- FastAPI提供RESTful API + +- Celery处理长时间运行的任务 + +- Redis作为消息代理 + +- WebSocket推送执行状态 + +- PostgreSQL存储执行记录 + + + +### 4. 低代码开发功能 + + + +**功能要求**: + +- 代码生成器(Python、前端代码) + +- 自定义节点开发 + +- 模板库管理 + +- 组件市场 + + + +**技术实现**: + +- 基于工作流定义生成代码 + +- 支持自定义节点插件系统 + +- 模板存储和管理 + +- 组件导入导出功能 + + + +--- + + + +## 📐 项目结构设计 + + + +### 前端项目结构 + + + +``` + +frontend/ + +├── src/ + +│   ├── api/              # API接口封装 + +│   ├── assets/           # 静态资源 + +│   ├── components/       # 公共组件 + +│   │   ├── WorkflowEditor/    # 工作流编辑器 + +│   │   ├── NodePanel/         # 节点配置面板 + +│   │   ├── AgentConfig/       # Agent配置组件 + +│   │   └── CodeGenerator/     # 代码生成器 + +│   ├── composables/      # 组合式函数 + +│   ├── layouts/          # 布局组件 + +│   ├── router/           # 路由配置 + +│   ├── stores/           # Pinia状态管理 + +│   │   ├── workflow.ts   # 工作流状态 + +│   │   ├── agent.ts     # Agent状态 + +│   │   └── user.ts      # 用户状态 + +│   ├── types/            # TypeScript类型定义 + +│   ├── utils/            # 工具函数 + +│   └── views/            # 页面组件 + +│       ├── WorkflowDesigner.vue + +│       ├── AgentStudio.vue + +│       └── CodeGenerator.vue + +├── public/ + +└── package.json + +``` + + + +### 后端项目结构 + + + +``` + +backend/ + +├── app/ + +│   ├── api/              # API路由 + +│   │   ├── workflows.py  # 工作流API + +│   │   ├── agents.py    # Agent API + +│   │   └── executions.py # 执行API + +│   ├── core/             # 核心功能 + +│   │   ├── config.py     # 配置 + +│   │   ├── security.py   # 安全 + +│   │   └── database.py   # 数据库 + +│   ├── models/           # 数据模型 + +│   │   ├── workflow.py + +│   │   ├── agent.py + +│   │   └── execution.py + +│   ├── services/         # 业务逻辑 + +│   │   ├── workflow_engine.py  # 工作流引擎 + +│   │   ├── agent_service.py   # Agent服务 + +│   │   └── code_generator.py  # 代码生成 + +│   ├── tasks/            # Celery任务 + +│   │   ├── workflow_tasks.py + +│   │   └── agent_tasks.py + +│   ├── websocket/        # WebSocket处理 + +│   └── utils/            # 工具函数 + +├── tests/                # 测试 + +├── alembic/              # 数据库迁移 + +├── requirements.txt + +└── main.py + +``` + + + +--- + + + +## 🔧 开发任务清单 + + + +### 阶段一: 项目初始化(1-2周) + + + +#### 1.1 前端项目搭建 + +- [ ] 使用 Vite 创建 Vue 3 + TypeScript 项目 + +- [ ] 配置 ESLint、Prettier + +- [ ] 安装核心依赖(Vue Flow、Pinia、Element Plus等) + +- [ ] 配置路由和布局 + +- [ ] 设置API请求拦截器 + +- [ ] 配置WebSocket连接 + + + +#### 1.2 后端项目搭建 + +- [ ] 创建 FastAPI 项目结构 + +- [ ] 配置数据库连接(PostgreSQL) + +- [ ] 配置 Redis 连接 + +- [ ] 设置 Celery 任务队列 + +- [ ] 配置 CORS 和中间件 + +- [ ] 设置日志系统 + +- [ ] 配置环境变量管理 + + + +#### 1.3 数据库设计 + +- [ ] 设计工作流表结构 + +- [ ] 设计Agent表结构 + +- [ ] 设计执行记录表结构 + +- [ ] 设计用户和权限表 + +- [ ] 创建数据库迁移脚本 + + + +### 阶段二: 核心功能开发(4-6周) + + + +#### 2.1 工作流编辑器开发 + +- [ ] 实现 Vue Flow 基础编辑器 + +- [ ] 实现节点拖拽功能 + +- [ ] 实现节点连线功能 + +- [ ] 实现节点配置面板 + +- [ ] 实现工作流保存和加载 + +- [ ] 实现工作流验证逻辑 + +- [ ] 实现节点类型扩展机制 + + + +#### 2.2 工作流引擎开发 + +- [ ] 实现工作流执行引擎核心逻辑 + +- [ ] 实现节点执行器(模板、条件、数据等) + +- [ ] 实现数据流转机制 + +- [ ] 实现错误处理和重试 + +- [ ] 实现执行状态管理 + +- [ ] 集成 Celery 异步任务 + + + +#### 2.3 Agent平台开发 + +- [ ] 实现Agent配置界面 + +- [ ] 集成 LangChain Agent框架 + +- [ ] 实现工具注册和管理 + +- [ ] 实现Agent执行逻辑 + +- [ ] 实现多Agent协作机制 + +- [ ] 实现Agent监控和分析 + + + +#### 2.4 实时通信开发 + +- [ ] 实现 FastAPI WebSocket + +- [ ] 实现前端 WebSocket 客户端 + +- [ ] 实现执行状态实时推送 + +- [ ] 实现消息队列集成 + + + +### 阶段三: 低代码功能开发(2-3周) + + + +#### 3.1 代码生成器开发 + +- [ ] 实现Python工作流引擎代码生成 + +- [ ] 实现前端组件代码生成 + +- [ ] 实现API接口代码生成 + +- [ ] 实现代码模板管理 + +- [ ] 实现代码预览和下载 + + + +#### 3.2 模板和组件库 + +- [ ] 实现工作流模板库 + +- [ ] 实现自定义节点开发 + +- [ ] 实现组件导入导出 + +- [ ] 实现模板市场功能 + + + +### 阶段四: 系统集成和优化(2-3周) + + + +#### 4.1 系统集成 + +- [ ] 集成向量数据库(ChromaDB) + +- [ ] 集成RAG框架(LlamaIndex) + +- [ ] 实现第三方API集成 + +- [ ] 实现数据库集成 + +- [ ] 实现消息队列集成 + + + +#### 4.2 性能优化 + +- [ ] 优化工作流执行性能 + +- [ ] 优化前端渲染性能 + +- [ ] 实现缓存机制 + +- [ ] 优化数据库查询 + +- [ ] 实现负载均衡 + + + +#### 4.3 监控和日志 + +- [ ] 集成 Prometheus 监控 + +- [ ] 配置 Grafana 仪表板 + +- [ ] 实现日志收集和分析 + +- [ ] 实现告警机制 + + + +### 阶段五: 测试和部署(1-2周) + + + +#### 5.1 测试 + +- [ ] 编写单元测试 + +- [ ] 编写集成测试 + +- [ ] 编写端到端测试 + +- [ ] 性能测试 + +- [ ] 安全测试 + + + +#### 5.2 部署 + +- [ ] 编写 Dockerfile + +- [ ] 编写 docker-compose.yml + +- [ ] 配置 Nginx 反向代理 + +- [ ] 配置 CI/CD 流水线 + +- [ ] 编写部署文档 + + + +--- + + + +## 💻 关键代码实现示例 + + + +### 1. 工作流执行引擎(Python) + + + +```python + +# app/services/workflow_engine.py + +from typing import Dict, Any, List + +from celery import Task + +import asyncio + +from langchain.llms import OpenAI + +from langchain.agents import initialize_agent + + + +class WorkflowEngine: + +    def __init__(self, workflow_id: str): + +        self.workflow_id = workflow_id + +        self.llm = OpenAI(temperature=0.7) + +        self.nodes = [] + +        self.edges = [] + +    async def execute_node(self, node: Dict[str, Any], input_data: Dict[str, Any]) -> Dict[str, Any]: + +        """执行单个节点""" + +        node_type = node.get('type') + +        if node_type == 'template': + +            # 模板节点:调用AI模型 + +            prompt = self.build_prompt(node, input_data) + +            result = await self.llm.agenerate([prompt]) + +            return {'output': result.generations[0][0].text} + +        elif node_type == 'condition': + +            # 条件节点:判断分支 + +            condition = node.get('condition') + +            result = self.evaluate_condition(condition, input_data) + +            return {'output': result, 'branch': 'true' if result else 'false'} + +        elif node_type == 'data': + +            # 数据节点:数据转换 + +            mapping = node.get('mapping') + +            result = self.transform_data(input_data, mapping) + +            return {'output': result} + +        elif node_type == 'agent': + +            # Agent节点:执行Agent + +            agent = initialize_agent( + +                tools=node.get('tools', []), + +                llm=self.llm, + +                agent="zero-shot-react-description" + +            ) + +            result = await agent.arun(node.get('task')) + +            return {'output': result} + +        else: + +            raise ValueError(f"Unknown node type: {node_type}") + +    async def execute(self, input_data: Dict[str, Any]) -> Dict[str, Any]: + +        """执行完整工作流""" + +        workflow = self.load_workflow() + +        self.nodes = workflow['nodes'] + +        self.edges = workflow['edges'] + +        # 构建执行图 + +        execution_graph = self.build_execution_graph() + +        # 按拓扑顺序执行 + +        results = {} + +        node_outputs = {'start': input_data} + +        for node_id in execution_graph: + +            node = self.get_node_by_id(node_id) + +            node_input = self.get_node_input(node_id, node_outputs) + +            result = await self.execute_node(node, node_input) + +            results[node_id] = result + +            node_outputs[node_id] = result['output'] + +        return results + +``` + + + +### 2. 工作流编辑器(Vue 3) + + + +```vue + + + + + + + + + +``` + + + +### 3. FastAPI工作流API + + + +```python + +# app/api/workflows.py + +from fastapi import APIRouter, Depends, WebSocket + +from sqlalchemy.orm import Session + +from app.core.database import get_db + +from app.services.workflow_engine import WorkflowEngine + +from app.tasks.workflow_tasks import execute_workflow_task + +from app.models.workflow import Workflow + + + +router = APIRouter(prefix="/api/workflows", tags=["workflows"]) + + + +@router.post("/") + +async def create_workflow(workflow_data: dict, db: Session = Depends(get_db)): + +    """创建工作流""" + +    workflow = Workflow(**workflow_data) + +    db.add(workflow) + +    db.commit() + +    return {"id": workflow.id, "status": "created"} + + + +@router.post("/{workflow_id}/execute") + +async def execute_workflow(workflow_id: str, input_data: dict, db: Session = Depends(get_db)): + +    """执行工作流""" + +    task = execute_workflow_task.delay(workflow_id, input_data) + +    return {"task_id": task.id, "status": "pending"} + + + +@router.get("/executions/{task_id}") + +async def get_execution_status(task_id: str): + +    """获取执行状态""" + +    from app.core.celery_app import celery_app + +    task = celery_app.AsyncResult(task_id) + +    return { + +        "task_id": task_id, + +        "status": task.status, + +        "result": task.result if task.ready() else None + +    } + + + +@router.websocket("/executions/{task_id}/ws") + +async def websocket_execution_status(websocket: WebSocket, task_id: str): + +    """WebSocket实时推送执行状态""" + +    await websocket.accept() + +    # 实现实时状态推送逻辑 + +    while True: + +        status = get_task_status(task_id) + +        await websocket.send_json(status) + +        await asyncio.sleep(1) + +``` + + + +### 4. Celery任务定义 + + + +```python + +# app/tasks/workflow_tasks.py + +from celery import Task + +from app.core.celery_app import celery_app + +from app.services.workflow_engine import WorkflowEngine + +from app.websocket.manager import WebSocketManager + + + +@celery_app.task(bind=True) + +def execute_workflow_task(self, workflow_id: str, input_data: dict): + +    """执行工作流任务""" + +    try: + +        engine = WorkflowEngine(workflow_id) + +        # 更新任务状态 + +        self.update_state(state='PROGRESS', meta={'progress': 0}) + +        # 执行工作流 + +        result = asyncio.run(engine.execute(input_data)) + +        # 通过WebSocket推送结果 + +        WebSocketManager.broadcast(workflow_id, { + +            'status': 'completed', + +            'result': result + +        }) + +        return result + +    except Exception as e: + +        # 错误处理 + +        WebSocketManager.broadcast(workflow_id, { + +            'status': 'failed', + +            'error': str(e) + +        }) + +        raise + +``` + + + +--- + + + +## 🎨 UI/UX设计要点 + + + +### 1. 工作流编辑器界面 + +- 左侧:节点工具箱(可拖拽的节点类型) + +- 中间:画布区域(工作流可视化编辑) + +- 右侧:节点配置面板(选中节点时显示) + +- 顶部:工具栏(保存、运行、预览等) + +- 底部:执行日志和状态栏 + + + +### 2. Agent配置界面 + +- Agent基本信息配置 + +- 工具链选择和管理 + +- 提示词编辑器 + +- 参数调优面板 + +- 测试和预览功能 + + + +### 3. 代码生成器界面 + +- 代码模板选择 + +- 参数配置表单 + +- 代码预览(语法高亮) + +- 下载和导出功能 + + + +--- + + + +## 🔒 安全和权限 + + + +### 1. 认证和授权 + +- JWT Token认证 + +- 基于角色的访问控制(RBAC) + +- API接口权限控制 + +- 工作流和Agent的访问权限 + + + +### 2. 数据安全 + +- 敏感数据加密存储 + +- API请求加密传输(HTTPS) + +- 工作流执行日志脱敏 + +- 数据备份和恢复机制 + + + +### 3. 安全审计 + +- 操作日志记录 + +- 异常行为检测 + +- 安全漏洞扫描 + +- 合规性检查 + + + +--- + + + +## 📊 性能优化策略 + + + +### 1. 前端优化 + +- 代码分割和懒加载 + +- 虚拟滚动(处理大量节点) + +- 防抖和节流(搜索、保存等操作) + +- 组件缓存(keep-alive) + +- 图片懒加载和压缩 + +- 使用 Web Workers 处理复杂计算 + +- 优化 Vue Flow 渲染性能 + +- 减少不必要的响应式数据 + + + +### 2. 后端优化 + +- 数据库查询优化(索引、查询优化) + +- 使用连接池管理数据库连接 + +- Redis 缓存热点数据 + +- 异步任务队列(Celery)处理耗时操作 + +- API 响应压缩(gzip) + +- 分页和限制查询结果 + +- 使用批量操作减少数据库交互 + +- 实现请求限流和熔断机制 + + + +### 3. 工作流执行优化 + +- 并行执行独立节点 + +- 缓存节点执行结果 + +- 优化 AI 模型调用(批量请求、模型选择) + +- 实现执行计划优化 + +- 支持断点续传和状态恢复 + +- 资源池管理(连接池、线程池) + + + +### 4. Agent 执行优化 + +- Agent 响应缓存 + +- 工具调用结果缓存 + +- 优化提示词长度 + +- 选择合适的模型(速度 vs 质量) + +- 实现 Agent 执行超时控制 + +- 批量处理相似任务 + + + +--- + + + +## 🧪 测试策略 + + + +### 1. 单元测试 + + + +**前端测试**: + +- 使用 Vitest 进行组件测试 + +- 测试工具函数和组合式函数 + +- 测试状态管理逻辑 + +- 测试表单验证 + + + +**后端测试**: + +- 使用 pytest 进行单元测试 + +- 测试服务层逻辑 + +- 测试数据模型 + +- 测试工具函数 + + + +### 2. 集成测试 + + + +**API 集成测试**: + +- 测试完整的 API 流程 + +- 测试数据库交互 + +- 测试 Celery 任务执行 + +- 测试 WebSocket 通信 + + + +**前端集成测试**: + +- 测试组件间交互 + +- 测试 API 调用 + +- 测试路由导航 + +- 测试状态管理 + + + +### 3. 端到端测试 + + + +- 使用 Playwright 或 Cypress + +- 测试完整用户流程 + +- 测试工作流创建和执行 + +- 测试 Agent 配置和使用 + +- 测试错误处理场景 + + + +### 4. 性能测试 + + + +- 工作流执行性能测试 + +- API 响应时间测试 + +- 并发执行测试 + +- 负载测试 + +- 压力测试 + + + +### 5. 安全测试 + + + +- API 安全测试 + +- 认证授权测试 + +- 输入验证测试 + +- SQL 注入防护测试 + +- XSS 防护测试 + + + +--- + + + +## 🚀 部署指南 + + + +### 1. 开发环境部署 + + + +**使用 Docker Compose**: + + + +```yaml + +# docker-compose.dev.yml + +version: '3.8' + +services: + +  frontend: + +    build: ./frontend + +    ports: + +      - "3000:3000" + +    volumes: + +      - ./frontend:/app + +    environment: + +      - VITE_API_URL=http://localhost:8000 + +  backend: + +    build: ./backend + +    ports: + +      - "8000:8000" + +    volumes: + +      - ./backend:/app + +    environment: + +      - DATABASE_URL=postgresql://user:pass@db:5432/workflow + +      - REDIS_URL=redis://redis:6379 + +    depends_on: + +      - db + +      - redis + +  celery: + +    build: ./backend + +    command: celery -A app.core.celery_app worker --loglevel=info + +    volumes: + +      - ./backend:/app + +    depends_on: + +      - db + +      - redis + +  db: + +    image: postgres:15 + +    environment: + +      - POSTGRES_DB=workflow + +      - POSTGRES_USER=user + +      - POSTGRES_PASSWORD=pass + +    volumes: + +      - postgres_data:/var/lib/postgresql/data + +  redis: + +    image: redis:7-alpine + +    volumes: + +      - redis_data:/data + +``` + + + +### 2. 生产环境部署 + + + +**使用 Kubernetes**: + + + +```yaml + +# k8s/deployment.yaml + +apiVersion: apps/v1 + +kind: Deployment + +metadata: + +  name: workflow-backend + +spec: + +  replicas: 3 + +  selector: + +    matchLabels: + +      app: workflow-backend + +  template: + +    metadata: + +      labels: + +        app: workflow-backend + +    spec: + +      containers: + +      - name: backend + +        image: workflow-backend:latest + +        ports: + +        - containerPort: 8000 + +        env: + +        - name: DATABASE_URL + +          valueFrom: + +            secretKeyRef: + +              name: workflow-secrets + +              key: database-url + +        resources: + +          requests: + +            memory: "512Mi" + +            cpu: "500m" + +          limits: + +            memory: "2Gi" + +            cpu: "2000m" + +``` + + + +### 3. CI/CD 配置 + + + +**GitHub Actions 示例**: + + + +```yaml + +# .github/workflows/deploy.yml + +name: Deploy + +on: + +  push: + +    branches: [main] + +jobs: + +  test: + +    runs-on: ubuntu-latest + +    steps: + +      - uses: actions/checkout@v3 + +      - name: Run tests + +        run: | + +          cd backend && pytest + +          cd frontend && npm test + +  build: + +    needs: test + +    runs-on: ubuntu-latest + +    steps: + +      - uses: actions/checkout@v3 + +      - name: Build Docker images + +        run: | + +          docker build -t workflow-backend ./backend + +          docker build -t workflow-frontend ./frontend + +  deploy: + +    needs: build + +    runs-on: ubuntu-latest + +    steps: + +      - name: Deploy to production + +        run: | + +          # 部署脚本 + +``` + + + +--- + + + +## 💡 开发最佳实践 + + + +### 1. 代码规范 + + + +**前端**: + +- 使用 ESLint + Prettier 统一代码风格 + +- 遵循 Vue 3 组合式 API 最佳实践 + +- 使用 TypeScript 严格模式 + +- 组件命名使用 PascalCase + +- 文件命名使用 kebab-case + + + +**后端**: + +- 遵循 PEP 8 Python 代码规范 + +- 使用类型提示(Type Hints) + +- 使用 Pydantic 进行数据验证 + +- API 路由使用 RESTful 规范 + +- 函数和类添加文档字符串 + + + +### 2. Git 工作流 + + + +- 使用 Git Flow 或 GitHub Flow + +- 提交信息遵循 Conventional Commits + +- 代码审查(Code Review)必须 + +- 主分支保护,禁止直接推送 + +- 使用语义化版本号(Semantic Versioning) + + + +### 3. 错误处理 + + + +**前端错误处理**: + +```typescript + +// 统一错误处理 + +try { + +  const result = await api.workflow.execute(id, data) + +} catch (error) { + +  if (error.response?.status === 401) { + +    // 处理未授权 + +    router.push('/login') + +  } else { + +    // 显示错误提示 + +    ElMessage.error(error.message) + +  } + +} + +``` + + + +**后端错误处理**: + +```python + +# 统一异常处理 + +from fastapi import HTTPException + + + +@app.exception_handler(ValueError) + +async def value_error_handler(request, exc): + +    return JSONResponse( + +        status_code=400, + +        content={"message": str(exc)} + +    ) + +``` + + + +### 4. 日志记录 + + + +**前端日志**: + +- 使用 console 进行开发调试 + +- 生产环境使用日志服务(Sentry) + +- 记录关键操作和错误 + + + +**后端日志**: + +```python + +import logging + + + +logger = logging.getLogger(__name__) + + + +logger.info("Workflow execution started", extra={ + +    "workflow_id": workflow_id, + +    "user_id": user_id + +}) + + + +logger.error("Workflow execution failed", exc_info=True) + +``` + + + +### 5. 文档编写 + + + +- API 文档使用 OpenAPI/Swagger + +- 代码注释清晰完整 + +- README 包含项目介绍和快速开始 + +- 编写用户使用手册 + +- 维护更新日志(CHANGELOG) + + + +--- + + + +## 🔍 常见问题解决 + + + +### 1. 工作流执行超时 + + + +**问题**: 工作流执行时间过长导致超时 + + + +**解决方案**: + +- 使用 Celery 异步任务处理 + +- 增加任务超时时间配置 + +- 优化节点执行逻辑 + +- 实现任务分片执行 + + + +### 2. WebSocket 连接断开 + + + +**问题**: WebSocket 连接不稳定,经常断开 + + + +**解决方案**: + +- 实现自动重连机制 + +- 使用心跳检测保持连接 + +- 增加连接池管理 + +- 处理网络异常情况 + + + +### 3. 前端性能问题 + + + +**问题**: 工作流编辑器在处理大量节点时卡顿 + + + +**解决方案**: + +- 使用虚拟滚动 + +- 实现节点懒加载 + +- 优化 Vue Flow 渲染 + +- 使用 Web Workers 处理计算 + + + +### 4. 数据库性能问题 + + + +**问题**: 数据库查询慢,影响系统性能 + + + +**解决方案**: + +- 添加合适的数据库索引 + +- 优化 SQL 查询语句 + +- 使用 Redis 缓存热点数据 + +- 实现数据库读写分离 + + + +### 5. Agent 响应慢 + + + +**问题**: Agent 执行响应时间过长 + + + +**解决方案**: + +- 选择合适的 AI 模型(速度优先) + +- 实现响应缓存机制 + +- 优化提示词长度 + +- 使用流式响应 + + + +--- + + + +## 📚 参考资源和文档 + + + +### 技术文档 + + + +**前端**: + +- [Vue 3 官方文档](https://vuejs.org/) + +- [Vue Flow 文档](https://vueflow.dev/) + +- [Pinia 状态管理](https://pinia.vuejs.org/) + +- [Element Plus 组件库](https://element-plus.org/) + +- [TypeScript 手册](https://www.typescriptlang.org/docs/) + + + +**后端**: + +- [FastAPI 官方文档](https://fastapi.tiangolo.com/) + +- [Celery 任务队列](https://docs.celeryq.dev/) + +- [SQLAlchemy ORM](https://www.sqlalchemy.org/) + +- [Pydantic 数据验证](https://docs.pydantic.dev/) + +- [LangChain 文档](https://python.langchain.com/) + +- [LlamaIndex 文档](https://www.llamaindex.ai/) + +- [PostgreSQL 文档](https://www.postgresql.org/docs/) + +- [Redis 文档](https://redis.io/docs/) + + + +**基础设施**: + +- [Docker 文档](https://docs.docker.com/) + +- [Docker Compose 文档](https://docs.docker.com/compose/) + +- [Kubernetes 文档](https://kubernetes.io/docs/) + +- [Nginx 文档](https://nginx.org/en/docs/) + +- [Prometheus 文档](https://prometheus.io/docs/) + +- [Grafana 文档](https://grafana.com/docs/) + + + +### 架构设计参考 + + + +- [微服务架构最佳实践](https://microservices.io/) + +- [RESTful API 设计指南](https://restfulapi.net/) + +- [WebSocket 最佳实践](https://www.websocket.org/) + +- [工作流引擎设计模式](https://www.workflowpatterns.com/) + +- [Agent 系统架构](https://www.langchain.com/) + + + +### 开发工具 + + + +**前端开发工具**: + +- [Vite 构建工具](https://vitejs.dev/) + +- [Vitest 测试框架](https://vitest.dev/) + +- [Vue DevTools](https://devtools.vuejs.org/) + +- [ESLint 代码检查](https://eslint.org/) + +- [Prettier 代码格式化](https://prettier.io/) + + + +**后端开发工具**: + +- [pytest 测试框架](https://docs.pytest.org/) + +- [Black 代码格式化](https://black.readthedocs.io/) + +- [mypy 类型检查](https://mypy.readthedocs.io/) + +- [Alembic 数据库迁移](https://alembic.sqlalchemy.org/) + +- [Postman API 测试](https://www.postman.com/) + + + +--- + + + +## 🎯 开发里程碑 + + + +### MVP 版本(3-4个月) + + + +**核心功能**: + +- ✅ 基础工作流编辑器(拖拽、连线、配置) + +- ✅ 工作流执行引擎(支持基础节点类型) + +- ✅ Agent 基础配置和执行 + +- ✅ 用户认证和权限管理 + +- ✅ 工作流执行历史记录 + + + +**技术目标**: + +- 前后端基础架构搭建完成 + +- 核心功能可用 + +- 基础测试覆盖 + + + +### V1.0 版本(6-8个月) + + + +**增强功能**: + +- ✅ 完整的工作流节点类型支持 + +- ✅ 多Agent协作机制 + +- ✅ 代码生成器(Python、前端) + +- ✅ 工作流模板库 + +- ✅ 性能监控和分析 + +- ✅ 完整的错误处理和重试机制 + + + +**技术目标**: + +- 系统稳定性和性能优化 + +- 完整的测试覆盖 + +- 生产环境部署就绪 + + + +### V2.0 版本(10-12个月) + + + +**高级功能**: + +- ✅ RAG 和向量数据库集成 + +- ✅ 自定义节点开发平台 + +- ✅ 组件市场和插件系统 + +- ✅ 高级分析和报表 + +- ✅ 多租户支持 + +- ✅ 企业级安全和合规 + + + +**技术目标**: + +- 企业级功能完善 + +- 高可用和可扩展架构 + +- 完整的文档和培训材料 + + + +--- + + + +## 🔄 迭代开发流程 + + + +### 1. 需求分析阶段 + + + +- 收集用户需求和反馈 + +- 分析业务场景 + +- 确定功能优先级 + +- 制定开发计划 + + + +### 2. 设计阶段 + + + +- 系统架构设计 + +- 数据库设计 + +- API 接口设计 + +- UI/UX 设计 + +- 技术方案评审 + + + +### 3. 开发阶段 + + + +- 前端开发 + +- 后端开发 + +- 单元测试编写 + +- 代码审查 + +- 持续集成 + + + +### 4. 测试阶段 + + + +- 功能测试 + +- 集成测试 + +- 性能测试 + +- 安全测试 + +- 用户验收测试 + + + +### 5. 部署阶段 + + + +- 预发布环境测试 + +- 生产环境部署 + +- 监控和告警配置 + +- 用户培训 + + + +### 6. 维护阶段 + + + +- 问题修复 + +- 性能优化 + +- 功能迭代 + +- 用户支持 + + + +--- + + + +## 📋 开发检查清单 + + + +### 代码提交前检查 + + + +- [ ] 代码通过 ESLint/Black 检查 + +- [ ] 所有测试用例通过 + +- [ ] 代码审查完成 + +- [ ] 更新相关文档 + +- [ ] 提交信息符合规范 + + + +### 功能开发检查 + + + +- [ ] 功能需求明确 + +- [ ] 技术方案确定 + +- [ ] 数据库变更(如有)已迁移 + +- [ ] API 接口文档已更新 + +- [ ] 前端组件已测试 + +- [ ] 错误处理已实现 + +- [ ] 日志记录已添加 + + + +### 发布前检查 + + + +- [ ] 所有测试通过 + +- [ ] 性能测试通过 + +- [ ] 安全扫描通过 + +- [ ] 文档已更新 + +- [ ] 版本号已更新 + +- [ ] 更新日志已编写 + +- [ ] 回滚方案已准备 + + + +--- + + + +## 🛠️ 开发环境配置 + + + +### 前端开发环境 + + + +```bash + +# 安装 Node.js (推荐 v18+) + +# 安装 pnpm + +npm install -g pnpm + + + +# 安装依赖 + +cd frontend + +pnpm install + + + +# 启动开发服务器 + +pnpm dev + + + +# 运行测试 + +pnpm test + + + +# 构建生产版本 + +pnpm build + +``` + + + +### 后端开发环境 + + + +```bash + +# 安装 Python (推荐 3.11+) + +# 创建虚拟环境 + +python -m venv venv + +source venv/bin/activate  # Windows: venv\Scripts\activate + + + +# 安装依赖 + +cd backend + +pip install -r requirements.txt + + + +# 配置环境变量 + +cp .env.example .env + +# 编辑 .env 文件 + + + +# 运行数据库迁移 + +alembic upgrade head + + + +# 启动开发服务器 + +uvicorn app.main:app --reload + + + +# 启动 Celery Worker + +celery -A app.core.celery_app worker --loglevel=info + + + +# 运行测试 + +pytest + +``` + + + +### Docker 开发环境 + + + +```bash + +# 启动所有服务 + +docker-compose -f docker-compose.dev.yml up -d + + + +# 查看日志 + +docker-compose logs -f + + + +# 停止服务 + +docker-compose down + +``` + + + +--- + + + +## 📝 API 设计规范 + + + +### RESTful API 设计 + + + +**资源命名**: + +- 使用名词,复数形式 + +- 使用小写字母和连字符 + +- 示例: `/api/workflows`, `/api/agents`, `/api/executions` + + + +**HTTP 方法**: + +- `GET`: 获取资源 + +- `POST`: 创建资源 + +- `PUT`: 完整更新资源 + +- `PATCH`: 部分更新资源 + +- `DELETE`: 删除资源 + + + +**状态码**: + +- `200 OK`: 成功 + +- `201 Created`: 创建成功 + +- `400 Bad Request`: 请求错误 + +- `401 Unauthorized`: 未授权 + +- `403 Forbidden`: 禁止访问 + +- `404 Not Found`: 资源不存在 + +- `500 Internal Server Error`: 服务器错误 + + + +**响应格式**: + +```json + +{ + +  "code": 200, + +  "message": "success", + +  "data": {}, + +  "timestamp": "2024-01-01T00:00:00Z" + +} + +``` + + + +### WebSocket 消息格式 + + + +```json + +{ + +  "type": "workflow:progress", + +  "task_id": "xxx", + +  "data": { + +    "node_id": "node_1", + +    "status": "running", + +    "progress": 50 + +  }, + +  "timestamp": "2024-01-01T00:00:00Z" + +} + +``` + + + +--- + + + +## 🎓 学习路径建议 + + + +### 新手开发者 + + + +1. **基础学习** (1-2周) + +   - Vue 3 基础语法和组合式 API + +   - TypeScript 基础 + +   - Python 基础 + +   - FastAPI 快速入门 + + + +2. **工具学习** (1周) + +   - Git 版本控制 + +   - Docker 基础 + +   - 开发工具使用 + + + +3. **项目实践** (2-3周) + +   - 熟悉项目结构 + +   - 完成简单功能开发 + +   - 参与代码审查 + + + +### 中级开发者 + + + +1. **进阶学习** (2-3周) + +   - Vue Flow 工作流可视化 + +   - Celery 异步任务 + +   - LangChain Agent 开发 + +   - 数据库优化 + + + +2. **架构理解** (1-2周) + +   - 系统架构设计 + +   - 微服务模式 + +   - 性能优化技巧 + + + +3. **功能开发** (持续) + +   - 独立开发复杂功能 + +   - 技术方案设计 + +   - 代码审查和指导 + + + +### 高级开发者 + + + +1. **架构设计** (持续) + +   - 系统架构优化 + +   - 技术选型决策 + +   - 性能瓶颈分析 + + + +2. **团队协作** (持续) + +   - 技术方案评审 + +   - 代码审查指导 + +   - 技术分享和培训 + + + +3. **技术创新** (持续) + +   - 新技术调研 + +   - 最佳实践总结 + +   - 开源贡献 + + + +--- + + + +## 🐛 调试技巧 + + + +### 前端调试 + + + +**Vue DevTools**: + +- 安装 Vue DevTools 浏览器扩展 + +- 查看组件状态和 props + +- 监控 Pinia store 变化 + +- 性能分析 + + + +**浏览器调试**: + +- 使用 Chrome DevTools + +- 网络请求监控 + +- 性能分析工具 + +- 内存泄漏检测 + + + +### 后端调试 + + + +**日志调试**: + +```python + +import logging + +logger = logging.getLogger(__name__) + + + +# 设置日志级别 + +logging.basicConfig(level=logging.DEBUG) + + + +# 使用结构化日志 + +logger.debug("Debug message", extra={"key": "value"}) + +``` + + + +**调试工具**: + +- 使用 `pdb` 进行断点调试 + +- 使用 `ipdb` 增强调试体验 + +- 使用 FastAPI 的自动文档进行 API 测试 + + + +**Celery 调试**: + +```python + +# 查看任务状态 + +from app.core.celery_app import celery_app + +task = celery_app.AsyncResult('task-id') + +print(task.state) + +print(task.result) + +``` + + + +--- + + + +## 📞 支持和帮助 + + + +### 内部资源 + + + +- 项目 Wiki 文档 + +- 技术分享会议记录 + +- 代码审查记录 + +- 问题追踪系统 + + + +### 外部社区 + + + +- [Vue.js 社区](https://forum.vuejs.org/) + +- [FastAPI 社区](https://github.com/tiangolo/fastapi/discussions) + +- [LangChain 社区](https://github.com/langchain-ai/langchain/discussions) + +- Stack Overflow + + + +### 问题反馈 + + + +- GitHub Issues(技术问题) + +- 内部工单系统(业务问题) + +- 团队会议(架构讨论) + + + +--- + + + +## 📅 版本历史 + + + +### v1.0.0 (2024-01-01) + +- 初始版本发布 + +- 基础工作流编辑器 + +- 工作流执行引擎 + +- Agent 基础功能 + + + +--- + + + +**文档维护**: 开发团队   + +**最后更新**: 2024年   + +**版本**: 1.0 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 3.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 3.md new file mode 100644 index 0000000..bb413e3 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 3.md @@ -0,0 +1,43 @@ +## 下一步可选方向 + +### 1. 高级功能(企业级特性) + +- 多租户支持:租户隔离、资源配额管理 + +- 权限管理(RBAC):基于角色的访问控制 + +- 监控和告警:系统监控、性能监控、告警通知 + +- 插件系统:自定义节点插件、插件市场 + +### 2. 功能增强 + +- 更多节点类型(如:邮件节点、消息队列节点等) + +- 工作流模板市场 + +- 工作流分享和协作 + +- 批量操作功能 + +### 3. 优化和完善 + +- 性能优化(数据库查询、前端渲染) + +- 用户体验优化 + +- 错误处理和提示优化 + +- 文档完善 + +### 4. 部署和运维 + +- 生产环境配置 + +- Kubernetes 部署 + +- CI/CD 流程 + +- 监控和日志系统 + +请选择下一步方向,或告诉我具体需求。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 4.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 4.md new file mode 100644 index 0000000..94ed55c --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 4.md @@ -0,0 +1,23 @@ +## 现在可以测试了 + +请重新测试 Agent: + +1. 点击右上角“测试运行” + +2. 执行应该能正常启动 + +3. 节点应该显示执行动画: + +- 执行中的节点:蓝色边框 + 脉冲动画 + +- 已完成的节点:绿色边框 + +- 失败的节点:红色边框 + +如果仍有问题,请查看: + +- 后端日志:docker-compose -f docker-compose.dev.yml logs -f backend celery + +- 前端控制台:查看 [rjb] 前缀的调试日志 + +现在链路调用应该可以正常工作了。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 5.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 5.md new file mode 100644 index 0000000..47fa344 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 5.md @@ -0,0 +1,84 @@ +### **个人简历** + +**基本信息** +姓名:[您的姓名] +电话:[您的手机号] +邮箱:[您的邮箱] +GitHub:[您的GitHub链接](可选) +工作年限:[X]年 +求职意向:Android高级工程师 + +--- + +### **专业技能** +1. **编程语言**:精通Java、Kotlin,熟悉C++、Python。 +2. **Android开发**: +- 熟悉Android SDK、NDK,掌握Jetpack组件(ViewModel、LiveData、Room等)。 +- 精通多线程、性能优化(内存泄漏、卡顿分析)、自定义View及动画。 +- 熟悉MVVM、MVP等架构设计,具备模块化、组件化开发经验。 +3. **跨平台技术**:了解Flutter或React Native,有混合开发经验。 +4. **工具与框架**: +- 熟练使用Retrofit、OkHttp、Glide、RxJava等主流框架。 +- 掌握Gradle构建、CI/CD流程,熟悉Git版本管理。 +5. **其他能力**: +- 熟悉设计模式、数据结构与算法。 +- 了解敏捷开发流程,有团队协作和项目管理经验。 + +--- + +### **工作经历** +**[公司名称] | Android高级工程师 | [入职时间] - [离职时间]** +- 主导[项目名称]开发,采用Kotlin+MVVM重构,性能提升30%。 +- 设计并实现[核心功能模块],如音视频处理、实时通信等。 +- 优化应用启动速度,减少冷启动时间至500ms以下。 +- 带领3人小组完成模块化改造,降低代码耦合度。 + +**[公司名称] | Android工程师 | [入职时间] - [离职时间]** +- 参与[应用名称]开发,负责UI层及业务逻辑实现。 +- 集成第三方SDK(如推送、地图、支付等)。 +- 解决内存泄漏、ANR等疑难问题,提升应用稳定性。 + +--- + +### **项目经验** +**项目名称:[例如:智能家居控制App]** +- **技术栈**:Kotlin、Jetpack、Retrofit、WebSocket +- **项目描述**:一款支持设备联动、远程控制的IoT应用,用户量超50万。 +- **个人贡献**: +1. 独立开发设备管理模块,实现蓝牙/WIFI双模连接。 +2. 引入协程优化异步任务,减少回调嵌套。 +3. 通过Profiler工具定位内存泄漏,优化后OOM率下降70%。 + +**项目名称:[例如:电商App性能优化]** +- **技术栈**:Java、LeakCanary、Systrace +- **项目描述**:针对现有电商App进行性能调优。 +- **个人贡献**: +1. 使用Systrace分析UI渲染瓶颈,优化布局层级。 +2. 实现图片懒加载及缓存策略,列表滑动流畅度提升40%。 + +--- + +### **教育背景** +[学校名称] | [专业] | [学历] | [毕业时间] + +--- + +### **附加信息** +- **证书/奖项**:[如Google开发者认证、技术竞赛奖项等] +- **技术博客/开源项目**:[如有可附链接] +- **语言能力**:英语(可阅读技术文档) + +--- + +### **自我评价** +- 对Android技术有强烈热情,持续关注新技术趋势(如Compose、KMM)。 +- 具备良好的沟通能力和团队协作精神,能快速适应高强度工作。 + +--- + +**使用建议**: +1. 量化成果:用数据体现项目贡献(如“性能提升XX%”)。 +2. 突出重点:将核心技能和项目经验放在显眼位置。 +3. 定制化修改:根据目标公司业务调整技术栈和项目描述。 + +如果需要进一步优化或针对特定公司调整,请提供更多信息! \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 6.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 6.md new file mode 100644 index 0000000..6679bdb --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 6.md @@ -0,0 +1,57 @@ +## 已完成的增强功能 + +### 1. 节点状态指示器(右上角) + +- 执行中:蓝色圆形背景 + 旋转加载图标 + +- 执行成功:绿色圆形背景 + 对勾图标 + +- 执行失败:红色圆形背景 + 叉号图标 + +### 2. 增强的节点动画效果 + +- 执行中:脉冲动画 + 缩放动画(1.05 → 1.08) + +- 执行成功:绿色闪烁动画 + +- 执行失败:红色抖动动画 + +### 3. 边的动画效果 + +- 连接到正在执行节点的边:蓝色高亮 + 流动动画(虚线流动) + +- 连接到已执行节点的边:绿色高亮 + 实线 + +- 边的宽度和颜色会根据执行状态动态变化 + +### 4. 视觉反馈 + +- 执行中的节点:蓝色边框 + 发光效果 + 缩放动画 + +- 已完成的节点:绿色边框 + 阴影效果 + +- 失败的节点:红色边框 + 抖动动画 + +## 动画效果说明 + +- 旋转加载图标:执行中节点右上角显示旋转的加载圆圈 + +- 脉冲动画:执行中节点有呼吸式脉冲效果 + +- 缩放动画:执行中节点轻微放大(1.05 → 1.08) + +- 边的流动:连接到执行中节点的边有虚线流动效果 + +- 状态图标:右上角圆形图标清晰显示节点状态 + +测试运行工作流时,可以直观看到: + +- 哪个节点正在执行(蓝色高亮 + 旋转图标) + +- 哪些节点已完成(绿色高亮 + 对勾图标) + +- 哪些节点失败(红色高亮 + 叉号图标) + +- 数据流向(边的流动动画) + +所有功能已实现,代码已通过 lint 检查。可以开始测试。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 7.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 7.md new file mode 100644 index 0000000..67deabd --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名 7.md @@ -0,0 +1,970 @@ +# 创建Agent经验总结 + + + +## 📋 目录 + + + +1. [创建Agent的完整流程](#创建agent的完整流程) + +2. [工作流设计经验](#工作流设计经验) + +3. [节点配置要点](#节点配置要点) + +4. [Prompt设计技巧](#prompt设计技巧) + +5. [数据流转与上下文传递](#数据流转与上下文传递) + +6. [常见问题和解决方案](#常见问题和解决方案) + +7. [最佳实践](#最佳实践) + +8. [实战案例](#实战案例) + + + +--- + + + +## 创建Agent的完整流程 + + + +### 1. 准备工作 + + + +#### 1.1 明确Agent目标 + +- **功能定位**:确定Agent要解决什么问题 + +- **目标用户**:明确使用场景和用户群体 + +- **输出格式**:确定最终输出的格式(文本、JSON、Markdown等) + + + +#### 1.2 设计工作流结构 + +- 绘制工作流流程图 + +- 确定节点类型和数量 + +- 规划数据流转路径 + +- 考虑分支和合并逻辑 + + + +#### 1.3 准备Prompt模板 + +- 为每个LLM节点准备详细的Prompt + +- 考虑上下文传递和变量替换 + +- 明确输出格式要求 + + + +### 2. 编写生成脚本 + + + +#### 2.1 脚本结构模板 + + + +```python + +#!/usr/bin/env python3 + +""" + +生成[Agent名称]Agent + +[Agent功能描述] + +""" + +import sys + +import os + +sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) + + + +from sqlalchemy.orm import Session + +from app.core.database import SessionLocal + +from app.models.agent import Agent + +from app.models.user import User + +from datetime import datetime + +import uuid + + + + +def generate_xxx_agent(db: Session, username: str = "admin"): + +    """生成[Agent名称]Agent""" + +    print("=" * 60) + +    print("生成[Agent名称]Agent") + +    print("=" * 60) + +    print() + +    # 1. 查找用户 + +    user = db.query(User).filter(User.username == username).first() + +    if not user: + +        print(f"❌ 未找到用户 '{username}',请先创建该用户") + +        return + +    print(f"✅ 找到用户: {user.username} (ID: {user.id})") + +    print() + +    # 2. 创建工作流配置 + +    nodes = [] + +    edges = [] + +    # 3. 添加节点 + +    # ... 节点配置 ... + +    # 4. 添加连接 + +    # ... 边配置 ... + +    # 5. 创建或更新Agent + +    workflow_config = { + +        "nodes": nodes, + +        "edges": edges + +    } + +    agent = db.query(Agent).filter( + +        Agent.name == "[Agent名称]", + +        Agent.user_id == user.id + +    ).first() + +    if agent: + +        # 更新现有Agent + +        agent.workflow_config = workflow_config + +        agent.updated_at = datetime.now() + +        agent.status = "published"  # 设置为已发布 + +        print("⚠️  Agent已存在,将更新它...") + +    else: + +        # 创建新Agent + +        agent = Agent( + +            id=str(uuid.uuid4()), + +            name="[Agent名称]", + +            description="[Agent描述]", + +            workflow_config=workflow_config, + +            status="published",  # 直接设置为已发布,可立即使用 + +            user_id=user.id, + +            version=1 + +        ) + +        db.add(agent) + +    # 6. 提交并输出结果 + +    try: + +        db.commit() + +        db.refresh(agent) + +        print("✅ Agent创建/更新成功!") + +        print(f"   - ID: {agent.id}") + +        print(f"   - 状态: {agent.status}") + +        return agent + +    except Exception as e: + +        db.rollback() + +        print(f"❌ 创建Agent失败: {str(e)}") + +        return None + + + + +def main(): + +    """主函数""" + +    db = SessionLocal() + +    try: + +        generate_xxx_agent(db, username="admin") + +    finally: + +        db.close() + + + + +if __name__ == "__main__": + +    main() + +``` + + + +### 3. 执行脚本 + + + +```bash + +# 1. 添加执行权限 + +chmod +x backend/scripts/generate_xxx_agent.py + + + +# 2. 运行脚本 + +python3 backend/scripts/generate_xxx_agent.py + +``` + + + +### 4. 验证和测试 + + + +- 在Agent管理页面查看创建的Agent + +- 使用"使用"按钮测试Agent功能 + +- 根据测试结果调整Prompt和工作流 + + + +--- + + + +## 工作流设计经验 + + + +### 1. 常见工作流模式 + + + +#### 模式1:线性流程 + +``` + +开始 → 处理1 → 处理2 → 处理3 → 结束 + +``` + +**适用场景**:简单的顺序处理任务 + + + +#### 模式2:分支流程 + +``` + +开始 → 分析 → 条件判断 → [分支A | 分支B] → 整合 → 结束 + +``` + +**适用场景**:需要根据条件选择不同处理路径 + + + +#### 模式3:并行处理 + +``` + +开始 → 分析 → [处理A | 处理B | 处理C] → 整合 → 结束 + +``` + +**适用场景**:多个独立任务可以并行执行 + + + +#### 模式4:循环处理 + +``` + +开始 → 循环开始 → 处理 → 条件判断 → [继续循环 | 退出] → 结束 + +``` + +**适用场景**:需要重复处理的数据 + + + +### 2. 节点布局建议 + + + +#### 2.1 位置规划 + +- **X轴间距**:建议200-250像素,确保节点不重叠 + +- **Y轴间距**:分支节点建议100-150像素 + +- **起始位置**:开始节点建议 (50, 300-400) + + + +#### 2.2 布局示例 + +```python + +# 线性布局 + +start_node = {"position": {"x": 50, "y": 400}} + +node1 = {"position": {"x": 250, "y": 400}} + +node2 = {"position": {"x": 450, "y": 400}} + + + +# 分支布局 + +condition_node = {"position": {"x": 450, "y": 400}} + +branch_true = {"position": {"x": 650, "y": 300}}  # 上分支 + +branch_false = {"position": {"x": 650, "y": 500}}  # 下分支 + +``` + + + +### 3. 工作流设计原则 + + + +#### 3.1 单一职责原则 + +- 每个节点只负责一个明确的任务 + +- 避免在一个节点中做太多事情 + + + +#### 3.2 数据流清晰 + +- 明确每个节点的输入和输出 + +- 使用Transform节点整理数据 + +- 避免数据丢失或混乱 + + + +#### 3.3 错误处理 + +- 考虑异常情况的处理 + +- 提供默认分支 + +- 添加错误提示节点(可选) + + + +#### 3.4 可扩展性 + +- 预留扩展点 + +- 使用条件节点支持多种场景 + +- 保持工作流的灵活性 + + + +--- + + + +## 节点配置要点 + + + +### 1. 开始节点 (start) + + + +```python + +start_node = { + +    "id": "start-1",  # 唯一ID,建议使用 start-1, start-2 等 + +    "type": "start", + +    "position": {"x": 50, "y": 400}, + +    "data": { + +        "label": "开始", + +        "output_format": "json"  # 可选:json 或 text + +    } + +} + +``` + + + +**要点**: + +- ID必须唯一 + +- `output_format` 决定后续节点如何接收数据 + + + +### 2. LLM节点 (llm) + + + +```python + +llm_node = { + +    "id": "llm-xxx", + +    "type": "llm", + +    "position": {"x": 250, "y": 400}, + +    "data": { + +        "label": "节点名称", + +        "provider": "deepseek",  # 或 "openai" + +        "model": "deepseek-chat",  # 模型名称 + +        "temperature": "0.3",  # 温度参数,字符串格式 + +        "max_tokens": "2000",  # 最大token数,字符串格式 + +        "prompt": """你的Prompt内容 + +使用 {{variable}} 引用变量 + +使用 {{query}} 引用用户输入 + +使用 {{output}} 引用上一个节点的输出""" + +    } + +} + +``` + + + +**要点**: + +- `temperature` 和 `max_tokens` 必须是字符串 + +- Prompt中使用 `{{variable}}` 进行变量替换 + +- 明确指定输出格式要求(JSON、Markdown等) + + + +### 3. 条件节点 (condition) + + + +```python + +condition_node = { + +    "id": "condition-xxx", + +    "type": "condition", + +    "position": {"x": 450, "y": 400}, + +    "data": { + +        "label": "条件判断", + +        "condition": "{variable} contains '关键词' or {variable} contains '另一个关键词'" + +    } + +} + +``` + + + +**要点**: + +- 条件表达式使用 `{variable}` 引用变量 + +- 支持 `contains`、`==`、`!=` 等操作符 + +- 支持 `and`、`or` 逻辑运算符 + +- 连接边需要指定 `sourceHandle`:`"true"` 或 `"false"` + + + +### 4. Transform节点 (transform) + + + +```python + +transform_node = { + +    "id": "transform-xxx", + +    "type": "transform", + +    "position": {"x": 650, "y": 400}, + +    "data": { + +        "label": "数据转换", + +        "mode": "merge",  # 或 "replace"、"extract" + +        "mapping": { + +            "key1": "{{variable1}}", + +            "key2": "{{variable2}}", + +            "key3": "{{output}}" + +        } + +    } + +} + +``` + + + +**要点**: + +- `mode: "merge"` 用于合并多个数据源 + +- `mode: "replace"` 用于替换整个数据 + +- `mode: "extract"` 用于提取特定字段 + +- 使用 `{{variable}}` 引用变量 + + + +### 5. 结束节点 (end) + + + +```python + +end_node = { + +    "id": "end-1", + +    "type": "end", + +    "position": {"x": 1450, "y": 400}, + +    "data": { + +        "label": "结束", + +        "description": "返回最终结果" + +    } + +} + +``` + + + +**要点**: + +- 结束节点会返回最终输出 + +- 可以设置 `output_format` 控制输出格式 + + + +### 6. 连接边 (edges) + + + +```python + +# 普通连接 + +edge = { + +    "id": "e1",  # 唯一ID + +    "source": "start-1",  # 源节点ID + +    "target": "llm-xxx"  # 目标节点ID + +} + + + +# 条件分支连接 + +edge_true = { + +    "id": "e2-true", + +    "source": "condition-xxx", + +    "target": "branch-true", + +    "sourceHandle": "true"  # true分支 + +} + + + +edge_false = { + +    "id": "e2-false", + +    "source": "condition-xxx", + +    "target": "branch-false", + +    "sourceHandle": "false"  # false分支 + +} + +``` + + + +**要点**: + +- 每个边必须有唯一的ID + +- 条件节点的分支必须指定 `sourceHandle` + +- 确保所有节点都有正确的连接 + + + +--- + + + +## Prompt设计技巧 + + + +### 1. Prompt结构 + + + +#### 1.1 角色定位 + +``` + +你是一个专业的[角色],请[任务描述]。 + +``` + +**示例**: + +``` + +你是一个专业的Android开发顾问。请分析用户的需求,提取关键信息。 + +``` + + + +#### 1.2 任务说明 + +- 明确任务目标 + +- 列出具体要求 + +- 提供输出格式示例 + + + +#### 1.3 上下文信息 + +``` + +用户需求:{{query}} + +需求分析结果:{{requirement_analysis}} + +``` + + + +#### 1.4 输出要求 + +``` + +请以JSON格式输出分析结果: + +{ + +  "key1": "value1", + +  "key2": "value2" + +} + +``` + + + +### 2. 变量使用 + + + +#### 2.1 常用变量 + +- `{{query}}` - 用户原始输入 + +- `{{user_query}}` - 用户查询(可能经过处理) + +- `{{output}}` - 上一个节点的输出 + +- `{{variable_name}}` - 自定义变量(通过Transform节点传递) + + + +#### 2.2 变量引用示例 + +```python + +"prompt": """用户需求:{{query}} + +需求分析:{{requirement_analysis}} + +请根据以上信息生成代码。""" + +``` + + + +### 3. 输出格式控制 + + + +#### 3.1 JSON格式 + +``` + +请以JSON格式输出: + +{ + +  "field1": "value1", + +  "field2": ["item1", "item2"] + +} + +请确保输出是有效的JSON格式。 + +``` + + + +#### 3.2 Markdown格式 + +``` + +请以Markdown格式输出,包含: + +1. 标题 + +2. 代码块(使用正确的语言标识) + +3. 列表 + +4. 表格(如需要) + +``` + + + +#### 3.3 纯文本格式 + +``` + +请直接输出优化后的完整内容(纯文本格式)。 + +不要包含JSON格式或其他包装。 + +``` + + + +### 4. 温度参数选择 + + + +| 场景 | Temperature | 说明 | + +|------|------------|------| + +| 代码生成 | 0.2-0.3 | 需要准确、一致的输出 | + +| 需求分析 | 0.3-0.5 | 需要平衡准确性和灵活性 | + +| 创意内容 | 0.7-0.9 | 需要多样性和创造性 | + +| 格式化输出 | 0.1-0.2 | 需要严格按照格式要求 | + + + +### 5. Token限制 + + + +| 任务类型 | Max Tokens | 说明 | + +|---------|-----------|------| + +| 简单分析 | 1000-2000 | 简短的分析和提取 | + +| 代码生成 | 3000-4000 | 完整的代码文件 | + +| 长文档生成 | 4000-8000 | 长篇文章或文档 | + +| 格式化输出 | 2000-4000 | 整理和格式化内容 | + + + +--- + + + +## 数据流转与上下文传递 + + + +### 1. 数据流转路径 + + + +``` + +开始节点 → LLM节点 → Transform节点 → 条件节点 → LLM节点 → 结束节点 + +   ↓          ↓            ↓            ↓           ↓          ↓ + +  query    output      merged_data   condition   solution   final_output + +``` + + + +### 2. 上下文传递策略 + + + +#### 2.1 使用Transform节点合并数据 + +```python + +transform_node = { + +    "data": { + +        "mode": "merge", + +        "mapping": { + +            "user_query": "{{query}}",  # 保留原始输入 + +            "analysis": "{{output}}",   # 保留分析结果 + +            "context": "{{previous_output}}"  # 保留上下文 + +        } + +    } + +} + +``` + + + +#### 2.2 在Prompt中传递上下文 + +```python + +"prompt": """用户原始需求:{{user_query}} + +需求分析结果:{{r \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md index 8a17365..36536ee 100644 --- a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md @@ -1,183 +1,3083 @@ -项目低代码智能体功能扩展 +# 工作流和Agent平台提示词目录 -该项目可扩展低代码快速搭建智能体的功能吗 + -检查项目结构,评估是否可扩展低代码快速搭建智能体的功能。 +## 📋 目录结构 -继续查看项目架构,评估是否可扩展低代码智能体搭建功能。 + -查看 API 路由和核心组件,评估扩展能力: +本目录基于现代化全栈架构(Next.js/Vue + Python FastAPI + Celery + Redis)设计,涵盖工作流和Agent平台的核心功能场景。 -基于对项目的分析,评估如下: + -## 项目扩展低代码智能体搭建的可行性评估 +--- -### 当前项目优势 + -1. 模板系统 +## 一、工作流引擎相关提示词 -- 结构化模板(角色、任务、上下文、约束) + -- 变量系统(文本、选择、数字、布尔等) +### 1.1 工作流设计助手 -- 模板管理和分享 + -1. 多模型支持 +#### WF-001: 工作流架构设计专家 -- 支持 OpenAI、Anthropic、DeepSeek +**分类**: workflow-design -- 单模型和批量测试 +**用途**: 帮助用户设计工作流架构 -1. 部署能力 +**角色**: -- 代码生成(Python、JavaScript、TypeScript) +你是一位资深的工作流架构设计专家,拥有丰富的业务流程自动化和智能体系统设计经验。你熟悉各种工作流模式,包括顺序执行、并行处理、条件分支、循环迭代等。 -- 多框架支持(FastAPI、Express 等) + -1. 用户系统 +**任务**: -- 认证、权限、模板归属 +请根据以下需求设计一个工作流架构: -### 需要扩展的核心功能 +- 业务场景:{{businessScenario}} -文档中提到了“提示词链”概念,但尚未实现。要支持低代码智能体搭建,需要添加: +- 主要目标:{{mainGoal}} -#### 1. 工作流编排系统 +- 输入数据:{{inputData}} -- 将多个模板串联成工作流 +- 预期输出:{{expectedOutput}} -- 节点连接(顺序、并行、条件分支) +- 特殊要求:{{specialRequirements}} -- 数据流转(上一步输出作为下一步输入) + -#### 2. 可视化工作流编辑器 +**变量**: -- 拖拽式节点编辑器 +- businessScenario (text, required): 业务场景描述 -- 节点类型:模板节点、条件节点、工具节点、数据节点 +- mainGoal (text, required): 主要目标 -- 连线表示数据流 +- inputData (text, required): 输入数据类型和格式 -#### 3. 智能体运行时引擎 +- expectedOutput (text, required): 预期输出格式 -- 工作流执行引擎 +- specialRequirements (text, optional): 特殊要求(性能、安全、合规等) -- 状态管理(持久化、恢复) + -- 错误处理和重试 +**输出格式**: markdown -#### 4. 工具集成能力 +**约束**: -- 外部 API 调用 +- 提供清晰的工作流节点设计 -- 数据库操作 +- 说明节点间的数据流转 -- 文件处理 +- 考虑错误处理和异常情况 -- 定时任务 +- 提供性能优化建议 -#### 5. 触发器系统 + -- Webhook 触发 +--- -- 定时触发 + -- 事件触发 +#### WF-002: 工作流节点类型选择器 -- 手动触发 +**分类**: workflow-design -### 实现建议 +**用途**: 帮助选择合适的工作流节点类型 -基于现有架构,建议按以下步骤扩展: +**角色**: -#### 阶段一:工作流基础(核心) +你是一位工作流节点设计专家,熟悉各种节点类型的特点和适用场景。 -1. 数据库扩展:添加工作流表、节点表、连接表 + -2. 工作流 API:创建、执行、管理 +**任务**: -3. 简单执行引擎:顺序执行多个模板 +根据以下需求,推荐最适合的节点类型组合: -#### 阶段二:可视化编辑器 +- 功能需求:{{functionRequirement}} -1. 使用 React Flow 或类似库 +- 数据来源:{{dataSource}} -2. 节点组件:模板节点、条件节点 +- 处理复杂度:{{complexity}} -3. 连线与数据映射 +- 性能要求:{{performanceRequirement}} -#### 阶段三:高级功能 + -1. 条件分支与循环 +**变量**: -2. 工具集成(API、数据库) +- functionRequirement (text, required): 功能需求描述 -3. 触发器系统 +- dataSource (text, required): 数据来源(API、数据库、文件等) -### 技术实现路径 +- complexity (select, required): 处理复杂度(简单/中等/复杂) -// 1. 扩展数据库模型(Prisma Schema) +- performanceRequirement (text, optional): 性能要求 -model Workflow { + -  id          String   @id @default(cuid()) +**输出格式**: json -  name        String +**约束**: -  description String? +- 推荐节点类型(start、template、condition、data、tool、end) -  nodes       WorkflowNode[] +- 说明每个节点的作用 -  edges       WorkflowEdge[] +- 提供节点配置建议 -  authorId    String + -  // ... +--- -} + -model WorkflowNode { +#### WF-003: 工作流执行优化专家 -  id         String   @id @default(cuid()) +**分类**: workflow-optimization -  workflowId String +**用途**: 优化工作流执行性能 -  type       String   // 'template' | 'condition' | 'tool' | 'data' +**角色**: -  templateId String?  // 如果是模板节点 +你是一位工作流性能优化专家,擅长分析工作流瓶颈并提供优化方案。 -  config     String   // JSON 配置 + -  // ... +**任务**: -} +分析以下工作流设计,提供性能优化建议: -// 2. 工作流执行引擎 +- 工作流结构:{{workflowStructure}} -class WorkflowEngine { +- 当前性能指标:{{currentMetrics}} -  async execute(workflowId: string, input: any) { +- 性能瓶颈:{{bottlenecks}} -    // 执行工作流逻辑 +- 优化目标:{{optimizationGoal}} -  } + -} +**变量**: -### 结论 +- workflowStructure (text, required): 工作流结构描述或JSON -- 可行性:高。项目具备良好基础,架构清晰,易于扩展。 +- currentMetrics (text, required): 当前性能指标(执行时间、资源使用等) -- 工作量:中等。核心工作流功能约 2-3 周,完整低代码平台约 2-3 个月。 +- bottlenecks (text, optional): 已知的性能瓶颈 -- 建议:先实现工作流编排和执行引擎,再逐步添加可视化编辑器和高级功能。 +- optimizationGoal (text, required): 优化目标(速度、资源、成本等) -需要我帮你开始实现工作流系统吗?我可以: + -1. 设计数据库模型 +**输出格式**: markdown -2. 创建工作流 API +**约束**: -3. 实现基础执行引擎 +- 识别性能瓶颈点 -4. 构建可视化编辑器界面 \ No newline at end of file +- 提供具体的优化方案 + +- 评估优化效果 + +- 考虑成本和收益 + + + +--- + + + +### 1.2 工作流节点配置 + + + +#### WF-004: 模板节点配置助手 + +**分类**: workflow-node-config + +**用途**: 帮助配置模板节点参数 + +**角色**: + +你是一位AI模型配置专家,熟悉各种AI模型的参数调优和提示词工程。 + + + +**任务**: + +为以下场景推荐最佳的模板节点配置: + +- 使用场景:{{useCase}} + +- 模板类型:{{templateType}} + +- 数据特点:{{dataCharacteristics}} + +- 质量要求:{{qualityRequirement}} + + + +**变量**: + +- useCase (text, required): 使用场景描述 + +- templateType (text, required): 模板类型(文本生成、数据分析、代码生成等) + +- dataCharacteristics (text, required): 数据特点(结构化、非结构化、多模态等) + +- qualityRequirement (text, required): 质量要求(准确性、速度、成本等) + + + +**输出格式**: json + +**约束**: + +- 推荐AI模型(GPT-4、Claude、DeepSeek等) + +- 设置Temperature、MaxTokens等参数 + +- 提供提示词优化建议 + + + +--- + + + +#### WF-005: 条件节点表达式生成器 + +**分类**: workflow-node-config + +**用途**: 生成条件节点的表达式 + +**角色**: + +你是一位逻辑表达式设计专家,擅长将业务逻辑转换为可执行的表达式。 + + + +**任务**: + +根据以下业务逻辑,生成条件表达式: + +- 业务规则:{{businessRule}} + +- 判断条件:{{judgmentCondition}} + +- 数据字段:{{dataFields}} + +- 逻辑关系:{{logicalRelation}} + + + +**变量**: + +- businessRule (text, required): 业务规则描述 + +- judgmentCondition (text, required): 判断条件(大于、等于、包含等) + +- dataFields (text, required): 涉及的数据字段 + +- logicalRelation (select, optional): 逻辑关系(AND、OR、NOT) + + + +**输出格式**: plain-text + +**约束**: + +- 生成JavaScript兼容的表达式 + +- 使用${变量名}格式引用数据 + +- 考虑边界情况 + +- 提供表达式说明 + + + +--- + + + +#### WF-006: 数据节点映射规则生成器 + +**分类**: workflow-node-config + +**用途**: 生成数据映射规则 + +**角色**: + +你是一位数据转换专家,擅长设计数据映射和转换规则。 + + + +**任务**: + +根据以下需求,生成数据映射规则: + +- 输入数据结构:{{inputStructure}} + +- 输出数据结构:{{outputStructure}} + +- 字段对应关系:{{fieldMapping}} + +- 转换规则:{{transformationRules}} + + + +**变量**: + +- inputStructure (text, required): 输入数据结构(JSON格式) + +- outputStructure (text, required): 输出数据结构(JSON格式) + +- fieldMapping (text, optional): 字段对应关系 + +- transformationRules (text, optional): 特殊转换规则 + + + +**输出格式**: json + +**约束**: + +- 生成完整的映射规则JSON + +- 支持嵌套路径 + +- 处理缺失字段 + +- 提供默认值建议 + + + +--- + + + +## 二、Agent平台相关提示词 + + + +### 2.1 Agent设计 + + + +#### AG-001: Agent角色定义专家 + +**分类**: agent-design + +**用途**: 帮助定义Agent的角色和能力 + +**角色**: + +你是一位Agent系统设计专家,熟悉各种Agent架构和角色设计模式。 + + + +**任务**: + +为以下场景设计Agent角色: + +- Agent名称:{{agentName}} + +- 主要职责:{{mainResponsibilities}} + +- 专业领域:{{expertiseDomain}} + +- 交互方式:{{interactionMode}} + +- 能力边界:{{capabilityBoundary}} + + + +**变量**: + +- agentName (text, required): Agent名称 + +- mainResponsibilities (text, required): 主要职责 + +- expertiseDomain (text, required): 专业领域 + +- interactionMode (select, required): 交互方式(对话、任务执行、数据分析等) + +- capabilityBoundary (text, required): 能力边界和限制 + + + +**输出格式**: markdown + +**约束**: + +- 定义清晰的Agent身份 + +- 说明核心能力 + +- 明确能力边界 + +- 提供使用场景示例 + + + +--- + + + +#### AG-002: Agent工具链设计器 + +**分类**: agent-design + +**用途**: 设计Agent的工具链 + +**角色**: + +你是一位工具集成专家,熟悉各种API、数据库、文件处理等工具的使用。 + + + +**任务**: + +为以下Agent设计工具链: + +- Agent类型:{{agentType}} + +- 核心功能:{{coreFunctions}} + +- 数据需求:{{dataRequirements}} + +- 外部服务:{{externalServices}} + + + +**变量**: + +- agentType (text, required): Agent类型(研究型、执行型、分析型等) + +- coreFunctions (text, required): 核心功能列表 + +- dataRequirements (text, required): 数据需求(读取、写入、查询等) + +- externalServices (text, optional): 需要集成的外部服务 + + + +**输出格式**: json + +**约束**: + +- 列出必需的工具 + +- 说明每个工具的用途 + +- 提供工具配置建议 + +- 考虑工具间的依赖关系 + + + +--- + + + +#### AG-003: Agent工作流编排器 + +**分类**: agent-orchestration + +**用途**: 编排多个Agent的协作流程 + +**角色**: + +你是一位多Agent系统架构师,擅长设计Agent间的协作模式。 + + + +**任务**: + +设计一个多Agent协作工作流: + +- 参与Agent:{{participatingAgents}} + +- 协作目标:{{collaborationGoal}} + +- 数据流转:{{dataFlow}} + +- 协调机制:{{coordinationMechanism}} + + + +**变量**: + +- participatingAgents (text, required): 参与的Agent列表和角色 + +- collaborationGoal (text, required): 协作目标 + +- dataFlow (text, required): 数据流转路径 + +- coordinationMechanism (select, required): 协调机制(顺序、并行、主从、对等) + + + +**输出格式**: markdown + +**约束**: + +- 设计清晰的协作流程 + +- 定义Agent间的接口 + +- 考虑冲突解决机制 + +- 提供错误处理方案 + + + +--- + + + +### 2.2 Agent执行 + + + +#### AG-004: Agent任务分解器 + +**分类**: agent-execution + +**用途**: 将复杂任务分解为Agent可执行的子任务 + +**角色**: + +你是一位任务规划专家,擅长将复杂任务分解为可执行的步骤。 + + + +**任务**: + +将以下复杂任务分解为Agent可执行的子任务: + +- 主任务:{{mainTask}} + +- 任务复杂度:{{taskComplexity}} + +- 可用资源:{{availableResources}} + +- 时间限制:{{timeLimit}} + + + +**变量**: + +- mainTask (text, required): 主任务描述 + +- taskComplexity (select, required): 任务复杂度(简单/中等/复杂) + +- availableResources (text, required): 可用资源(工具、数据、API等) + +- timeLimit (text, optional): 时间限制 + + + +**输出格式**: json + +**约束**: + +- 分解为清晰的子任务 + +- 定义任务间的依赖关系 + +- 估计每个任务的执行时间 + +- 标识关键路径 + + + +--- + + + +#### AG-005: Agent决策助手 + +**分类**: agent-execution + +**用途**: 帮助Agent做出决策 + +**角色**: + +你是一位决策分析专家,擅长基于多因素进行决策分析。 + + + +**任务**: + +基于以下信息,为Agent提供决策建议: + +- 决策场景:{{decisionScenario}} + +- 可选方案:{{options}} + +- 评估标准:{{evaluationCriteria}} + +- 约束条件:{{constraints}} + + + +**变量**: + +- decisionScenario (text, required): 决策场景描述 + +- options (text, required): 可选方案列表 + +- evaluationCriteria (text, required): 评估标准 + +- constraints (text, optional): 约束条件 + + + +**输出格式**: json + +**约束**: + +- 分析每个方案的优缺点 + +- 给出推荐方案 + +- 说明推荐理由 + +- 提供风险评估 + + + +--- + + + +#### AG-006: Agent错误恢复策略生成器 + +**分类**: agent-execution + +**用途**: 生成Agent错误恢复策略 + +**角色**: + +你是一位系统可靠性专家,擅长设计错误处理和恢复机制。 + + + +**任务**: + +为以下Agent设计错误恢复策略: + +- Agent类型:{{agentType}} + +- 常见错误:{{commonErrors}} + +- 错误影响:{{errorImpact}} + +- 恢复目标:{{recoveryGoal}} + + + +**变量**: + +- agentType (text, required): Agent类型 + +- commonErrors (text, required): 常见错误类型 + +- errorImpact (text, required): 错误影响范围 + +- recoveryGoal (text, required): 恢复目标(快速恢复、数据一致性等) + + + +**输出格式**: markdown + +**约束**: + +- 针对每种错误提供恢复策略 + +- 定义重试机制 + +- 提供降级方案 + +- 考虑数据一致性 + + + +--- + + + +## 三、平台功能相关提示词 + + + +### 3.1 用户引导 + + + +#### PL-001: 工作流创建向导 + +**分类**: platform-guide + +**用途**: 引导用户创建工作流 + +**角色**: + +你是一位友好的平台助手,擅长用简单易懂的方式引导用户。 + + + +**任务**: + +为新用户提供工作流创建指导: + +- 用户目标:{{userGoal}} + +- 用户经验:{{userExperience}} + +- 业务场景:{{businessScenario}} + + + +**变量**: + +- userGoal (text, required): 用户想要实现的目标 + +- userExperience (select, required): 用户经验(新手/中级/高级) + +- businessScenario (text, required): 业务场景描述 + + + +**输出格式**: markdown + +**约束**: + +- 使用友好的语言 + +- 提供分步骤指导 + +- 包含示例说明 + +- 提供常见问题解答 + + + +--- + + + +#### PL-002: Agent配置助手 + +**分类**: platform-guide + +**用途**: 帮助用户配置Agent + +**角色**: + +你是一位Agent配置专家,熟悉各种Agent配置参数。 + + + +**任务**: + +指导用户配置Agent: + +- Agent用途:{{agentPurpose}} + +- 使用场景:{{useCase}} + +- 技术背景:{{technicalBackground}} + + + +**变量**: + +- agentPurpose (text, required): Agent用途 + +- useCase (text, required): 使用场景 + +- technicalBackground (select, required): 技术背景(非技术/初级/中级/高级) + + + +**输出格式**: markdown + +**约束**: + +- 提供配置步骤 + +- 解释每个参数的作用 + +- 提供推荐配置 + +- 包含最佳实践 + + + +--- + + + +### 3.2 代码生成 + + + +#### PL-003: Python工作流引擎代码生成器 + +**分类**: code-generation + +**用途**: 生成Python工作流引擎代码 + +**角色**: + +你是一位Python开发专家,熟悉FastAPI、Celery、异步编程等。 + + + +**任务**: + +根据以下工作流设计,生成Python工作流引擎代码: + +- 工作流定义:{{workflowDefinition}} + +- 节点类型:{{nodeTypes}} + +- 执行模式:{{executionMode}} + +- 框架要求:{{frameworkRequirements}} + + + +**变量**: + +- workflowDefinition (text, required): 工作流定义(JSON格式) + +- nodeTypes (text, required): 节点类型列表 + +- executionMode (select, required): 执行模式(同步/异步/混合) + +- frameworkRequirements (text, optional): 框架要求(FastAPI、Celery等) + + + +**输出格式**: plain-text + +**约束**: + +- 使用FastAPI框架 + +- 集成Celery任务队列 + +- 支持异步执行 + +- 包含错误处理 + +- 提供API文档 + + + +--- + + + +#### PL-004: 前端工作流编辑器代码生成器 + +**分类**: code-generation + +**用途**: 生成前端工作流编辑器代码 + +**角色**: + +你是一位前端开发专家,熟悉React、Vue、工作流可视化库。 + + + +**任务**: + +生成工作流可视化编辑器代码: + +- 前端框架:{{frontendFramework}} + +- 可视化库:{{visualizationLibrary}} + +- 功能需求:{{featureRequirements}} + +- UI风格:{{uiStyle}} + + + +**变量**: + +- frontendFramework (select, required): 前端框架(React/Vue) + +- visualizationLibrary (select, required): 可视化库(React Flow/Vue Flow) + +- featureRequirements (text, required): 功能需求(拖拽、连线、配置等) + +- uiStyle (text, optional): UI风格要求 + + + +**输出格式**: plain-text + +**约束**: + +- 使用推荐的框架和库 + +- 实现拖拽式编辑 + +- 支持节点配置 + +- 响应式设计 + +- 包含类型定义 + + + +--- + + + +#### PL-005: API接口代码生成器 + +**分类**: code-generation + +**用途**: 生成RESTful API接口代码 + +**角色**: + +你是一位API设计专家,熟悉RESTful API设计和OpenAPI规范。 + + + +**任务**: + +生成以下功能的API接口代码: + +- API功能:{{apiFunction}} + +- 数据模型:{{dataModel}} + +- 认证方式:{{authentication}} + +- 框架:{{framework}} + + + +**变量**: + +- apiFunction (text, required): API功能描述 + +- dataModel (text, required): 数据模型(JSON格式) + +- authentication (select, required): 认证方式(JWT、OAuth、API Key等) + +- framework (select, required): 框架(FastAPI、Express、Next.js等) + + + +**输出格式**: plain-text + +**约束**: + +- 遵循RESTful规范 + +- 包含请求验证 + +- 提供错误处理 + +- 生成OpenAPI文档 + +- 包含单元测试示例 + + + +--- + + + +### 3.3 数据分析 + + + +#### PL-006: 工作流执行分析器 + +**分类**: data-analysis + +**用途**: 分析工作流执行数据 + +**角色**: + +你是一位数据分析专家,擅长从执行数据中提取洞察。 + + + +**任务**: + +分析以下工作流执行数据: + +- 执行记录:{{executionRecords}} + +- 分析维度:{{analysisDimensions}} + +- 关注指标:{{keyMetrics}} + + + +**变量**: + +- executionRecords (text, required): 执行记录(JSON格式) + +- analysisDimensions (text, required): 分析维度(性能、成功率、错误等) + +- keyMetrics (text, required): 关注的指标 + + + +**输出格式**: markdown + +**约束**: + +- 提供数据可视化建议 + +- 识别异常模式 + +- 给出优化建议 + +- 包含趋势分析 + + + +--- + + + +#### PL-007: Agent性能评估器 + +**分类**: data-analysis + +**用途**: 评估Agent性能 + +**角色**: + +你是一位AI系统评估专家,熟悉各种性能评估指标。 + + + +**任务**: + +评估以下Agent的性能: + +- Agent配置:{{agentConfig}} + +- 执行数据:{{executionData}} + +- 评估标准:{{evaluationCriteria}} + + + +**变量**: + +- agentConfig (text, required): Agent配置信息 + +- executionData (text, required): 执行数据(响应时间、成功率等) + +- evaluationCriteria (text, required): 评估标准 + + + +**输出格式**: json + +**约束**: + +- 计算关键性能指标 + +- 对比基准值 + +- 识别性能瓶颈 + +- 提供改进建议 + + + +--- + + + +## 四、场景化提示词模板 + + + +### 4.1 内容生成场景 + + + +#### SC-001: 多步骤内容生成工作流 + +**分类**: content-generation + +**用途**: 生成多步骤内容创作工作流 + +**角色**: + +你是一位内容创作专家,熟悉内容生成的完整流程。 + + + +**任务**: + +设计一个多步骤内容生成工作流: + +- 内容类型:{{contentType}} + +- 生成步骤:{{generationSteps}} + +- 质量要求:{{qualityRequirement}} + + + +**变量**: + +- contentType (text, required): 内容类型(文章、视频脚本、营销文案等) + +- generationSteps (text, required): 生成步骤(大纲、初稿、优化、润色等) + +- qualityRequirement (text, required): 质量要求 + + + +**输出格式**: markdown + +**约束**: + +- 设计清晰的步骤流程 + +- 定义每个步骤的输入输出 + +- 提供质量检查点 + + + +--- + + + +#### SC-002: 智能内容审核工作流 + +**分类**: content-moderation + +**用途**: 设计内容审核工作流 + +**角色**: + +你是一位内容审核专家,熟悉各种审核标准和流程。 + + + +**任务**: + +设计内容审核工作流: + +- 审核类型:{{moderationType}} + +- 审核标准:{{moderationStandards}} + +- 处理流程:{{handlingProcess}} + + + +**变量**: + +- moderationType (text, required): 审核类型(文本、图片、视频等) + +- moderationStandards (text, required): 审核标准 + +- handlingProcess (text, required): 处理流程(通过/拒绝/人工审核) + + + +**输出格式**: markdown + +**约束**: + +- 定义审核规则 + +- 设计分级审核机制 + +- 提供人工审核触发条件 + + + +--- + + + +### 4.2 数据处理场景 + + + +#### SC-003: 数据清洗和转换工作流 + +**分类**: data-processing + +**用途**: 设计数据清洗工作流 + +**角色**: + +你是一位数据处理专家,熟悉数据清洗和转换技术。 + + + +**任务**: + +设计数据清洗和转换工作流: + +- 数据来源:{{dataSource}} + +- 数据质量:{{dataQuality}} + +- 目标格式:{{targetFormat}} + + + +**变量**: + +- dataSource (text, required): 数据来源和格式 + +- dataQuality (text, required): 数据质量问题 + +- targetFormat (text, required): 目标数据格式 + + + +**输出格式**: markdown + +**约束**: + +- 定义清洗规则 + +- 设计转换步骤 + +- 提供质量验证 + + + +--- + + + +#### SC-004: 实时数据分析工作流 + +**分类**: data-analysis + +**用途**: 设计实时数据分析工作流 + +**角色**: + +你是一位实时数据分析专家,熟悉流式数据处理。 + + + +**任务**: + +设计实时数据分析工作流: + +- 数据流:{{dataStream}} + +- 分析目标:{{analysisGoal}} + +- 实时性要求:{{realtimeRequirement}} + + + +**变量**: + +- dataStream (text, required): 数据流描述 + +- analysisGoal (text, required): 分析目标 + +- realtimeRequirement (text, required): 实时性要求(延迟、吞吐量) + + + +**输出格式**: markdown + +**约束**: + +- 设计流式处理架构 + +- 定义分析指标 + +- 提供告警机制 + + + +--- + + + +### 4.3 智能客服场景 + + + +#### SC-005: 智能客服Agent + +**分类**: customer-service + +**用途**: 设计智能客服Agent + +**角色**: + +你是一位智能客服系统专家,熟悉对话系统和客户服务流程。 + + + +**任务**: + +设计智能客服Agent: + +- 服务领域:{{serviceDomain}} + +- 常见问题:{{commonQuestions}} + +- 服务标准:{{serviceStandards}} + + + +**变量**: + +- serviceDomain (text, required): 服务领域 + +- commonQuestions (text, required): 常见问题类型 + +- serviceStandards (text, required): 服务标准(响应时间、解决率等) + + + +**输出格式**: markdown + +**约束**: + +- 设计对话流程 + +- 定义知识库结构 + +- 提供转人工机制 + + + +--- + + + +#### SC-006: 多轮对话工作流 + +**分类**: conversation + +**用途**: 设计多轮对话工作流 + +**角色**: + +你是一位对话系统专家,熟悉多轮对话设计。 + + + +**任务**: + +设计多轮对话工作流: + +- 对话目标:{{conversationGoal}} + +- 对话轮次:{{conversationTurns}} + +- 上下文管理:{{contextManagement}} + + + +**变量**: + +- conversationGoal (text, required): 对话目标 + +- conversationTurns (text, required): 预期对话轮次 + +- contextManagement (text, required): 上下文管理需求 + + + +**输出格式**: markdown + +**约束**: + +- 设计对话状态机 + +- 定义上下文存储策略 + +- 提供对话恢复机制 + + + +--- + + + +### 4.4 自动化任务场景 + + + +#### SC-007: 定时任务Agent + +**分类**: automation + +**用途**: 设计定时任务Agent + +**角色**: + +你是一位自动化专家,熟悉定时任务和调度系统。 + + + +**任务**: + +设计定时任务Agent: + +- 任务类型:{{taskType}} + +- 执行频率:{{executionFrequency}} + +- 依赖关系:{{dependencies}} + + + +**变量**: + +- taskType (text, required): 任务类型 + +- executionFrequency (text, required): 执行频率(每天、每周、自定义) + +- dependencies (text, optional): 任务依赖关系 + + + +**输出格式**: markdown + +**约束**: + +- 设计调度策略 + +- 定义重试机制 + +- 提供监控告警 + + + +--- + + + +#### SC-008: 事件驱动工作流 + +**分类**: event-driven + +**用途**: 设计事件驱动工作流 + +**角色**: + +你是一位事件驱动架构专家,熟悉事件处理和消息队列。 + + + +**任务**: + +设计事件驱动工作流: + +- 事件类型:{{eventTypes}} + +- 事件源:{{eventSources}} + +- 处理逻辑:{{processingLogic}} + + + +**变量**: + +- eventTypes (text, required): 事件类型列表 + +- eventSources (text, required): 事件源(API、数据库、消息队列等) + +- processingLogic (text, required): 处理逻辑 + + + +**输出格式**: markdown + +**约束**: + +- 设计事件处理流程 + +- 定义事件路由规则 + +- 提供事件重放机制 + + + +--- + + + +## 五、系统集成提示词 + + + +### 5.1 API集成 + + + +#### SI-001: 第三方API集成设计器 + +**分类**: system-integration + +**用途**: 设计第三方API集成方案 + +**角色**: + +你是一位API集成专家,熟悉各种API集成模式和最佳实践。 + + + +**任务**: + +设计第三方API集成方案: + +- API类型:{{apiType}} + +- 集成目标:{{integrationGoal}} + +- 认证方式:{{authentication}} + +- 错误处理:{{errorHandling}} + + + +**变量**: + +- apiType (text, required): API类型(REST、GraphQL、gRPC等) + +- integrationGoal (text, required): 集成目标 + +- authentication (text, required): 认证方式 + +- errorHandling (text, required): 错误处理策略 + + + +**输出格式**: markdown + +**约束**: + +- 设计集成架构 + +- 定义接口规范 + +- 提供错误处理方案 + +- 包含重试和降级策略 + + + +--- + + + +#### SI-002: 数据库集成设计器 + +**分类**: system-integration + +**用途**: 设计数据库集成方案 + +**角色**: + +你是一位数据库专家,熟悉各种数据库的集成方式。 + + + +**任务**: + +设计数据库集成方案: + +- 数据库类型:{{databaseType}} + +- 操作类型:{{operationType}} + +- 性能要求:{{performanceRequirement}} + +- 数据一致性:{{dataConsistency}} + + + +**变量**: + +- databaseType (select, required): 数据库类型(PostgreSQL、MySQL、MongoDB、Redis等) + +- operationType (text, required): 操作类型(读取、写入、查询、事务等) + +- performanceRequirement (text, required): 性能要求 + +- dataConsistency (text, required): 数据一致性要求 + + + +**输出格式**: markdown + +**约束**: + +- 设计数据访问层 + +- 定义连接池配置 + +- 提供事务处理方案 + +- 包含缓存策略 + + + +--- + + + +### 5.2 消息队列集成 + + + +#### SI-003: 消息队列工作流设计器 + +**分类**: system-integration + +**用途**: 设计基于消息队列的工作流 + +**角色**: + +你是一位消息队列专家,熟悉RabbitMQ、Kafka、Redis等消息中间件。 + + + +**任务**: + +设计基于消息队列的工作流: + +- 消息队列:{{messageQueue}} + +- 消息类型:{{messageTypes}} + +- 处理模式:{{processingPattern}} + +- 可靠性要求:{{reliabilityRequirement}} + + + +**变量**: + +- messageQueue (select, required): 消息队列(RabbitMQ、Kafka、Redis Streams等) + +- messageTypes (text, required): 消息类型 + +- processingPattern (select, required): 处理模式(发布订阅、点对点、流处理) + +- reliabilityRequirement (text, required): 可靠性要求(至少一次、恰好一次、最多一次) + + + +**输出格式**: markdown + +**约束**: + +- 设计消息路由规则 + +- 定义消息格式 + +- 提供消息确认机制 + +- 包含死信队列处理 + + + +--- + + + +## 六、测试和调试提示词 + + + +### 6.1 工作流测试 + + + +#### TE-001: 工作流测试用例生成器 + +**分类**: testing + +**用途**: 生成工作流测试用例 + +**角色**: + +你是一位测试专家,熟悉工作流测试方法。 + + + +**任务**: + +为以下工作流生成测试用例: + +- 工作流定义:{{workflowDefinition}} + +- 测试类型:{{testType}} + +- 覆盖目标:{{coverageGoal}} + + + +**变量**: + +- workflowDefinition (text, required): 工作流定义 + +- testType (select, required): 测试类型(单元测试、集成测试、端到端测试) + +- coverageGoal (text, required): 覆盖目标(节点覆盖、路径覆盖、条件覆盖) + + + +**输出格式**: json + +**约束**: + +- 生成完整的测试用例 + +- 包含正常流程和异常流程 + +- 提供测试数据 + +- 定义预期结果 + + + +--- + + + +#### TE-002: Agent行为测试生成器 + +**分类**: testing + +**用途**: 生成Agent行为测试用例 + +**角色**: + +你是一位AI系统测试专家,熟悉Agent行为测试。 + + + +**任务**: + +生成Agent行为测试用例: + +- Agent配置:{{agentConfig}} + +- 测试场景:{{testScenarios}} + +- 评估标准:{{evaluationCriteria}} + + + +**变量**: + +- agentConfig (text, required): Agent配置 + +- testScenarios (text, required): 测试场景 + +- evaluationCriteria (text, required): 评估标准 + + + +**输出格式**: json + +**约束**: + +- 设计多样化测试场景 + +- 包含边界情况 + +- 提供评估指标 + +- 定义通过标准 + + + +--- + + + +### 6.2 性能测试 + + + +#### TE-003: 工作流性能测试方案 + +**分类**: performance-testing + +**用途**: 设计工作流性能测试方案 + +**角色**: + +你是一位性能测试专家,熟悉负载测试和压力测试。 + + + +**任务**: + +设计工作流性能测试方案: + +- 工作流复杂度:{{workflowComplexity}} + +- 性能目标:{{performanceTargets}} + +- 测试环境:{{testEnvironment}} + + + +**变量**: + +- workflowComplexity (select, required): 工作流复杂度(简单/中等/复杂) + +- performanceTargets (text, required): 性能目标(响应时间、吞吐量、并发数) + +- testEnvironment (text, required): 测试环境描述 + + + +**输出格式**: markdown + +**约束**: + +- 设计测试场景 + +- 定义性能指标 + +- 提供测试工具建议 + +- 包含结果分析方法 + + + +--- + + + +## 七、部署和运维提示词 + + + +### 7.1 部署配置 + + + +#### DE-001: 容器化部署配置生成器 + +**分类**: deployment + +**用途**: 生成Docker容器化配置 + +**角色**: + +你是一位DevOps专家,熟悉容器化部署和编排。 + + + +**任务**: + +生成容器化部署配置: + +- 服务类型:{{serviceType}} + +- 依赖服务:{{dependencies}} + +- 资源配置:{{resourceRequirements}} + +- 环境变量:{{environmentVariables}} + + + +**变量**: + +- serviceType (text, required): 服务类型(前端、后端、工作流引擎等) + +- dependencies (text, required): 依赖服务(数据库、Redis、消息队列等) + +- resourceRequirements (text, required): 资源配置(CPU、内存、存储) + +- environmentVariables (text, required): 环境变量配置 + + + +**输出格式**: plain-text + +**约束**: + +- 生成Dockerfile + +- 提供docker-compose.yml + +- 包含健康检查 + +- 提供部署脚本 + + + +--- + + + +#### DE-002: Kubernetes部署配置生成器 + +**分类**: deployment + +**用途**: 生成Kubernetes部署配置 + +**角色**: + +你是一位Kubernetes专家,熟悉K8s部署和编排。 + + + +**任务**: + +生成Kubernetes部署配置: + +- 应用架构:{{applicationArchitecture}} + +- 副本数量:{{replicaCount}} + +- 服务发现:{{serviceDiscovery}} + +- 配置管理:{{configManagement}} + + + +**变量**: + +- applicationArchitecture (text, required): 应用架构描述 + +- replicaCount (text, required): 副本数量配置 + +- serviceDiscovery (text, required): 服务发现需求 + +- configManagement (text, required): 配置管理方式 + + + +**输出格式**: yaml + +**约束**: + +- 生成Deployment配置 + +- 提供Service配置 + +- 包含ConfigMap和Secret + +- 定义资源限制 + + + +--- + + + +### 7.2 监控和告警 + + + +#### DE-003: 监控指标设计器 + +**分类**: monitoring + +**用途**: 设计系统监控指标 + +**角色**: + +你是一位监控专家,熟悉各种监控指标和告警策略。 + + + +**任务**: + +设计系统监控指标: + +- 系统组件:{{systemComponents}} + +- 关键指标:{{keyMetrics}} + +- 告警阈值:{{alertThresholds}} + + + +**变量**: + +- systemComponents (text, required): 系统组件列表 + +- keyMetrics (text, required): 关键指标(CPU、内存、响应时间、错误率等) + +- alertThresholds (text, required): 告警阈值配置 + + + +**输出格式**: json + +**约束**: + +- 定义完整的监控指标 + +- 设置合理的告警阈值 + +- 提供告警规则 + +- 包含仪表板配置建议 + + + +--- + + + +## 八、安全和合规提示词 + + + +### 8.1 安全设计 + + + +#### SE-001: 工作流安全审计器 + +**分类**: security + +**用途**: 审计工作流安全性 + +**角色**: + +你是一位安全专家,熟悉系统安全最佳实践。 + + + +**任务**: + +审计工作流安全性: + +- 工作流定义:{{workflowDefinition}} + +- 数据敏感性:{{dataSensitivity}} + +- 合规要求:{{complianceRequirements}} + + + +**变量**: + +- workflowDefinition (text, required): 工作流定义 + +- dataSensitivity (text, required): 数据敏感性级别 + +- complianceRequirements (text, optional): 合规要求(GDPR、HIPAA等) + + + +**输出格式**: markdown + +**约束**: + +- 识别安全风险 + +- 提供安全加固建议 + +- 定义访问控制策略 + +- 包含数据加密方案 + + + +--- + + + +#### SE-002: API安全配置生成器 + +**分类**: security + +**用途**: 生成API安全配置 + +**角色**: + +你是一位API安全专家,熟悉各种API安全机制。 + + + +**任务**: + +生成API安全配置: + +- API类型:{{apiType}} + +- 认证方式:{{authentication}} + +- 授权策略:{{authorizationPolicy}} + +- 数据保护:{{dataProtection}} + + + +**变量**: + +- apiType (text, required): API类型 + +- authentication (select, required): 认证方式(JWT、OAuth2、API Key等) + +- authorizationPolicy (text, required): 授权策略 + +- dataProtection (text, required): 数据保护要求 + + + +**输出格式**: markdown + +**约束**: + +- 设计认证流程 + +- 定义授权规则 + +- 提供加密方案 + +- 包含安全最佳实践 + + + +--- + + + +## 九、文档和教程提示词 + + + +### 9.1 用户文档 + + + +#### DO-001: 工作流使用教程生成器 + +**分类**: documentation + +**用途**: 生成工作流使用教程 + +**角色**: + +你是一位技术文档专家,擅长编写清晰易懂的教程。 + + + +**任务**: + +生成工作流使用教程: + +- 目标用户:{{targetUser}} + +- 功能范围:{{featureScope}} + +- 难度级别:{{difficultyLevel}} + + + +**变量**: + +- targetUser (select, required): 目标用户(新手/中级/高级) + +- featureScope (text, required): 功能范围 + +- difficultyLevel (select, required): 难度级别(入门/中级/高级) + + + +**输出格式**: markdown + +**约束**: + +- 使用清晰的步骤说明 + +- 包含截图或示例 + +- 提供常见问题解答 + +- 添加最佳实践 + + + +--- + + + +#### DO-002: API文档生成器 + +**分类**: documentation + +**用途**: 生成API文档 + +**角色**: + +你是一位API文档专家,熟悉OpenAPI规范和文档编写。 + + + +**任务**: + +生成API文档: + +- API定义:{{apiDefinition}} + +- 文档风格:{{documentationStyle}} + +- 示例需求:{{exampleRequirements}} + + + +**变量**: + +- apiDefinition (text, required): API定义(OpenAPI格式) + +- documentationStyle (select, required): 文档风格(简洁/详细/交互式) + +- exampleRequirements (text, required): 示例需求 + + + +**输出格式**: markdown + +**约束**: + +- 遵循OpenAPI规范 + +- 提供完整的接口说明 + +- 包含请求响应示例 + +- 添加错误码说明 + + + +--- + + + +## 十、优化和调优提示词 + + + +### 10.1 性能优化 + + + +#### OP-001: 工作流性能优化专家 + +**分类**: optimization + +**用途**: 优化工作流性能 + +**角色**: + +你是一位性能优化专家,擅长识别和解决性能瓶颈。 + + + +**任务**: + +优化工作流性能: + +- 当前性能:{{currentPerformance}} + +- 性能瓶颈:{{performanceBottlenecks}} + +- 优化目标:{{optimizationGoals}} + + + +**变量**: + +- currentPerformance (text, required): 当前性能指标 + +- performanceBottlenecks (text, required): 性能瓶颈分析 + +- optimizationGoals (text, required): 优化目标 + + + +**输出格式**: markdown + +**约束**: + +- 识别性能瓶颈 + +- 提供优化方案 + +- 评估优化效果 + +- 考虑成本收益 + + + +--- + + + +#### OP-002: Agent响应速度优化器 + +**分类**: optimization + +**用途**: 优化Agent响应速度 + +**角色**: + +你是一位AI系统优化专家,熟悉Agent性能优化。 + + + +**任务**: + +优化Agent响应速度: + +- Agent配置:{{agentConfig}} + +- 当前延迟:{{currentLatency}} + +- 目标延迟:{{targetLatency}} + + + +**变量**: + +- agentConfig (text, required): Agent配置 + +- currentLatency (text, required): 当前延迟 + +- targetLatency (text, required): 目标延迟 + + + +**输出格式**: markdown + +**约束**: + +- 分析延迟来源 + +- 提供优化策略 + +- 包含缓存方案 + +- 考虑模型选择 + + + +--- + + + +## 📝 使用说明 + + + +### 提示词模板结构 + +每个提示词模板包含以下部分: + +1. **模板编号**: 唯一标识符(如WF-001) + +2. **分类**: 模板所属分类 + +3. **用途**: 模板的使用场景 + +4. **角色**: AI扮演的角色定义 + +5. **任务**: 具体的任务描述 + +6. **变量**: 模板变量定义 + +7. **输出格式**: 期望的输出格式 + +8. **约束**: 输出约束条件 + + + +### 变量类型说明 + +- **text**: 文本输入 + +- **select**: 下拉选择(需提供选项) + +- **number**: 数字输入 + +- **boolean**: 布尔值 + +- **date**: 日期选择 + + + +### 分类体系 + +- **workflow-***: 工作流相关 + +- **agent-***: Agent相关 + +- **platform-***: 平台功能相关 + +- **scenario-***: 场景化模板 + +- **system-integration-***: 系统集成 + +- **testing-***: 测试相关 + +- **deployment-***: 部署相关 + +- **security-***: 安全相关 + +- **documentation-***: 文档相关 + +- **optimization-***: 优化相关 + + + +--- + + + +## 🎯 快速索引 + + + +### 按功能分类 + + + +#### 工作流相关 + +- **工作流设计**: WF-001, WF-002, WF-003 + +- **节点配置**: WF-004, WF-005, WF-006 + + + +#### Agent相关 + +- **Agent设计**: AG-001, AG-002, AG-003 + +- **Agent执行**: AG-004, AG-005, AG-006 + + + +#### 平台功能 + +- **用户引导**: PL-001, PL-002 + +- **代码生成**: PL-003, PL-004, PL-005 + +- **数据分析**: PL-006, PL-007 + + + +#### 场景化模板 + +- **内容生成**: SC-001, SC-002 + +- **数据处理**: SC-003, SC-004 + +- **智能客服**: SC-005, SC-006 + +- **自动化任务**: SC-007, SC-008 + + + +#### 系统集成 + +- **API集成**: SI-001 + +- **数据库集成**: SI-002 + +- **消息队列**: SI-003 + + + +#### 测试和调试 + +- **工作流测试**: TE-001 + +- **Agent测试**: TE-002 + +- **性能测试**: TE-003 + + + +#### 部署和运维 + +- **容器化部署**: DE-001 + +- **Kubernetes部署**: DE-002 + +- **监控告警**: DE-003 + + + +#### 安全和合规 + +- **安全审计**: SE-001 + +- **API安全**: SE-002 + + + +#### 文档和教程 + +- **用户文档**: DO-001 + +- **API文档**: DO-002 + + + +#### 优化和调优 + +- **性能优化**: OP-001, OP-002 + + + +--- + + + +### 按使用场景分类 + + + +#### 新手入门 + +- **工作流创建**: PL-001 + +- **Agent配置**: PL-002 + +- **工作流使用教程**: DO-001 + + + +#### 工作流设计 + +- **架构设计**: WF-001 + +- **节点选择**: WF-002 + +- **性能优化**: WF-003, OP-001 + + + +#### Agent开发 + +- **角色定义**: AG-001 + +- **工具链设计**: AG-002 + +- **多Agent协作**: AG-003 + +- **任务分解**: AG-004 + +- **决策支持**: AG-005 + +- **错误处理**: AG-006 + + + +#### 节点配置 + +- **模板节点**: WF-004 + +- **条件节点**: WF-005 + +- **数据节点**: WF-006 + + + +#### 代码开发 + +- **Python引擎**: PL-003 + +- **前端编辑器**: PL-004 + +- **API接口**: PL-005 + + + +#### 场景应用 + +- **内容创作**: SC-001, SC-002 + +- **数据处理**: SC-003, SC-004 + +- **客服系统**: SC-005, SC-006 + +- **任务自动化**: SC-007, SC-008 + + + +#### 系统集成 + +- **第三方API**: SI-001 + +- **数据库**: SI-002 + +- **消息队列**: SI-003 + + + +#### 测试验证 + +- **工作流测试**: TE-001 + +- **Agent测试**: TE-002 + +- **性能测试**: TE-003 + + + +#### 部署上线 + +- **Docker部署**: DE-001 + +- **K8s部署**: DE-002 + +- **监控配置**: DE-003 + + + +#### 安全合规 + +- **安全审计**: SE-001 + +- **API安全**: SE-002 + + + +#### 性能优化 + +- **工作流优化**: OP-001 + +- **Agent优化**: OP-002 + + + +--- + + + +### 按技术栈分类 + + + +#### 前端开发 + +- **工作流编辑器**: PL-004 + +- **用户引导**: PL-001 + + + +#### 后端开发 + +- **Python引擎**: PL-003 + +- **API接口**: PL-005 + +- **数据库集成**: SI-002 + + + +#### 工作流引擎 + +- **架构设计**: WF-001 + +- **节点配置**: WF-004, WF-005, WF-006 + +- **执行优化**: WF-003 + + + +#### Agent系统 + +- **Agent设计**: AG-001, AG-002, AG-003 + +- **Agent执行**: AG-004, AG-005, AG-006 + + + +#### 基础设施 + +- **容器化**: DE-001 + +- **Kubernetes**: DE-002 + +- **监控**: DE-003 + +- **消息队列**: SI-003 + + + +--- + + + +### 按难度级别分类 + + + +#### 入门级(适合新手) + +- PL-001: 工作流创建向导 + +- PL-002: Agent配置助手 + +- DO-001: 工作流使用教程 + +- WF-001: 工作流架构设计专家 + + + +#### 进阶级(需要一定经验) + +- WF-002: 工作流节点类型选择器 + +- WF-004: 模板节点配置助手 + +- AG-001: Agent角色定义专家 + +- SC-001: 多步骤内容生成工作流 + +- PL-003: Python工作流引擎代码生成器 + +- PL-004: 前端工作流编辑器代码生成器 + + + +#### 高级(需要专业经验) + +- WF-003: 工作流执行优化专家 + +- AG-003: Agent工作流编排器 + +- SI-001: 第三方API集成设计器 + +- DE-002: Kubernetes部署配置生成器 + +- SE-001: 工作流安全审计器 + +- OP-001: 工作流性能优化专家 + + + +--- + + + +### 按输出格式分类 + + + +#### Markdown格式 + +- WF-001, WF-003, AG-001, AG-003, PL-001, PL-002, PL-006 + +- SC-001, SC-002, SC-003, SC-004, SC-005, SC-006, SC-007, SC-008 + +- SI-001, SI-002, SI-003, TE-003, SE-001, SE-002, DO-001, DO-002 + +- OP-001, OP-002 + + + +#### JSON格式 + +- WF-002, WF-004, WF-006, AG-002, AG-004, AG-005, PL-007 + +- TE-001, TE-002, DE-003 + + + +#### 代码格式(Plain-text/YAML) + +- WF-005, PL-003, PL-004, PL-005, DE-001, DE-002 + + + +--- + + + +### 按业务领域分类 + + + +#### 内容创作 + +- SC-001: 多步骤内容生成工作流 + +- SC-002: 智能内容审核工作流 + + + +#### 数据处理 + +- SC-003: 数据清洗和转换工作流 + +- SC-004: 实时数据分析工作流 + +- PL-006: 工作流执行分析器 + + + +#### 客户服务 + +- SC-005: 智能客服Agent + +- SC-006: 多轮对话工作流 + + + +#### 自动化运维 + +- SC-007: 定时任务Agent + +- SC-008: 事件驱动工作流 + +- DE-001: 容器化部署配置生成器 + +- DE-002: Kubernetes部署配置生成器 + +- DE-003: 监控指标设计器 + + + +#### 系统集成 + +- SI-001: 第三方API集成设计器 + +- SI-002: 数据库集成设计器 + +- SI-003: 消息队列工作流设计器 + + + +#### 质量保障 + +- TE-001: 工作流测试用例生成器 + +- TE-002: Agent行为测试生成器 + +- TE-003: 工作流性能测试方案 + +- SE-001: 工作流安全审计器 + +- SE-002: API安全配置生成器 + + + +--- + + + +## 📊 统计信息 + + + +### 模板总数 + +- **工作流相关**: 6个(WF-001 至 WF-006) + +- **Agent相关**: 6个(AG-001 至 AG-006) + +- **平台功能**: 7个(PL-001 至 PL-007) + +- **场景化模板**: 8个(SC-001 至 SC-008) + +- **系统集成**: 3个(SI-001 至 SI-003) + +- **测试调试**: 3个(TE-001 至 TE-003) + +- **部署运维**: 3个(DE-001 至 DE-003) + +- **安全合规**: 2个(SE-001 至 SE-002) + +- **文档教程**: 2个(DO-001 至 DO-002) + +- **优化调优**: 2个(OP-001 至 OP-002) + + + +**总计**: 42个提示词模板 + + + +### 覆盖范围 + +- ✅ 工作流设计、配置、优化 + +- ✅ Agent设计、执行、协作 + +- ✅ 代码生成(前端、后端、API) + +- ✅ 场景化应用(内容、数据、客服、自动化) + +- ✅ 系统集成(API、数据库、消息队列) + +- ✅ 测试和调试 + +- ✅ 部署和运维 + +- ✅ 安全和合规 + +- ✅ 文档和教程 + +- ✅ 性能优化 + + + +--- + + + +## 🔄 模板使用流程 + + + +### 1. 确定需求 + +根据业务场景选择合适的模板分类 + + + +### 2. 选择模板 + +从快速索引中找到对应的模板编号 + + + +### 3. 填写变量 + +根据模板要求填写所有必需的变量 + + + +### 4. 执行提示词 + +将模板和变量组合成完整的提示词 + + + +### 5. 优化迭代 + +根据输出结果调整变量和约束条件 + + + +--- + + + +## 💡 最佳实践 + + + +### 1. 模板组合使用 + +- 工作流设计:WF-001 → WF-002 → WF-004/005/006 + +- Agent开发:AG-001 → AG-002 → AG-003 + +- 完整流程:PL-001 → WF-001 → PL-003 → DE-001 + + + +### 2. 场景化应用 + +- 内容创作:SC-001 + WF-004 + +- 数据处理:SC-003 + WF-006 + +- 智能客服:SC-005 + AG-001 + AG-004 + + + +### 3. 质量保障 + +- 设计阶段:WF-001, AG-001 + +- 开发阶段:PL-003, PL-004, PL-005 + +- 测试阶段:TE-001, TE-002, TE-003 + +- 部署阶段:DE-001, DE-002, DE-003 + +- 优化阶段:OP-001, OP-002 + + + +--- + + + +## 📚 相关资源 + + + +### 技术文档 + +- [FastAPI 官方文档](https://fastapi.tiangolo.com/) + +- [Celery 任务队列](https://docs.celeryq.dev/) + +- [LangChain 文档](https://python.langchain.com/) + +- [React Flow 文档](https://reactflow.dev/) + +- [Vue Flow 文档](https://vueflow.dev/) + + + +### 架构参考 + +- 现代化全栈架构设计 + +- 微服务架构最佳实践 + +- 工作流引擎设计模式 + +- Agent系统架构 + + + +--- + + + +**最后更新**: 2024年 + +**版本**: 1.0 + +**维护者**: PromptForge Team \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md new file mode 100644 index 0000000..f3da599 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md @@ -0,0 +1,97 @@ +## 1. 概述 +本方案旨在设计一个完整、高效且用户体验良好的电商系统订单处理流程。该流程覆盖从用户下单开始,经过支付、订单处理、商品发货,直至售后服务的全生命周期,确保业务顺畅运行并提升客户满意度。 + +## 2. 核心流程设计 + +### 2.1 下单环节 +用户完成商品选择并提交购买意向,系统生成初始订单。 +**关键步骤:** +1. **购物车/立即购买**:用户通过购物车批量结算或对单个商品立即购买。 +2. **订单确认页**: + * 展示商品清单、单价、总价、优惠信息(促销、优惠券)、运费。 + * 填写/选择收货地址、联系人信息。 + * 选择配送方式(快递、自提等)与时间。 + * 选择支付方式(在线支付、货到付款等)。 + * 添加订单备注(可选)。 +3. **提交订单**:用户点击“提交订单”,系统进行库存预扣减(防止超卖),生成待支付订单,并跳转至支付环节。 + +**实施建议:** +* **库存预扣**:采用预扣库存机制,支付成功后再转为实际占用,支付超时未完成则释放预扣库存。 +* **数据验证**:提交前需对地址有效性、库存充足性进行实时校验。 +* **订单号生成**:生成全局唯一、具有业务意义的订单号(如包含日期、类型等)。 + +### 2.2 支付环节 +用户完成支付,系统确认收款,订单状态更新。 +**关键步骤:** +1. **支付引导**:跳转至支付网关或展示支付二维码。 +2. **支付执行**:用户通过所选支付方式(如支付宝、微信支付、银行卡、余额支付)完成付款。 +3. **支付回调与验签**: + * 支付平台异步通知系统支付结果。 + * 系统必须进行回调验证(验证签名、金额、订单号),防止伪造通知。 +4. **订单状态更新**:支付验证成功后,订单状态由“待支付”变更为“待发货”或“支付成功”,并记录支付流水号、支付时间。 +5. **支付失败处理**:若支付失败或超时,订单保持“待支付”状态,用户可在订单列表重新发起支付或取消订单。 + +**实施建议:** +* **异步通知与主动查询结合**:依赖回调通知,同时设置定时任务主动向支付平台查询未知状态的订单,确保状态最终一致性。 +* **对账机制**:每日与支付渠道进行对账,及时发现并处理异常订单(如已支付未成功更新状态)。 +* **支付方式管理**:后台可灵活配置启用/禁用支付方式。 + +### 2.3 发货环节 +商家处理订单,打包商品并交付给物流,用户可追踪物流。 +**关键步骤:** +1. **订单审核与打单**:后台对“待发货”订单进行审核(如风控审核、地址校验),审核通过后打印发货单、快递单。 +2. **仓库拣货与打包**:仓库根据发货单进行拣货、质检、打包,并粘贴快递单。 +3. **发货出库**: + * 扫描快递单号,在系统中执行“发货”操作。 + * 系统更新订单状态为“已发货”,并记录物流公司、运单号、发货时间。 + * 系统通知用户已发货(如通过APP推送、短信)。 +4. **物流同步与追踪**:系统通过物流公司API同步物流轨迹,并在用户订单详情页展示。支持用户实时查看包裹位置。 + +**实施建议:** +* **与WMS集成**:订单系统与仓库管理系统(WMS)深度集成,实现高效准确的库存管理和发货作业。 +* **电子面单**:采用电子面单API,直接获取运单号并打印,提升效率。 +* **异常物流监控**:设置规则监控物流长时间无更新、派送失败等异常情况,触发人工介入。 + +### 2.4 售后环节 +处理用户的退货、换货、退款及投诉咨询。 +**关键流程:** +1. **售后申请入口**:用户在“已收货”的订单中,针对特定商品发起售后申请(退货、换货、仅退款)。 +2. **申请提交**:用户选择售后类型、原因,上传凭证(照片、视频),说明问题。 +3. **商家审核**:商家后台查看申请与凭证,做出审核决定(同意、拒绝、需补充材料)。 + * **同意退款**:若商品未发货,直接退款至原支付账户;若已发货/收货,需用户寄回商品,商家确认收货后执行退款。 + * **同意换货**:流程同退货后再重新发货,或直接寄送新商品。 + * **拒绝**:需说明拒绝理由。 +4. **退货物流**(如适用):商家提供退货地址,用户寄回商品并填写退货运单号。 +5. **商家收货质检**:商家收到退货商品后,进行质检,确认是否符合退款/换货条件。 +6. **执行售后操作**: + * **退款**:系统调用支付接口原路退款,更新订单售后状态为“已完成”,通知用户。 + * **换货**:生成新的换货订单(或发货单),重新进入发货流程。 +7. **纠纷与客服介入**:若用户对商家处理结果不满,可申请平台客服介入调解。 + +**实施建议:** +* **清晰的售后政策**:在用户申请页明确展示各类售后(如7天无理由退货)的条件、时限、运费责任。 +* **自动化流程**:对于符合“7天无理由”等明确规则的申请,可设置自动审核通过,提升效率。 +* **退款原路返回**:退款原则上按支付路径原路返回,提升资金安全与用户体验。 +* **售后状态通知**:关键节点(审核通过、退货地址提供、退款成功)及时通知用户。 + +## 3. 核心状态流转图 +``` +待支付 --(支付成功)--> 待发货 --(商家发货)--> 已发货 --(用户确认收货/系统自动确认)--> 交易完成 + | | | + |--(支付超时/取消)--> 已取消 |--(用户申请售后)--> 售后中 --(售后完成)--> 交易关闭 + | + |--(售后拒绝)--> 交易完成 +``` + +## 4. 关键系统支撑与优化建议 + +* **订单中心**:作为核心模块,统一管理订单信息、状态、商品快照、操作日志。 +* **库存中心**:实现精准的库存管理(总库存、可用库存、预扣库存、在途库存),支持秒杀等高并发场景。 +* **支付中心**:统一对接各支付渠道,处理支付、退款、对账,保证资金安全与数据一致性。 +* **物流中心**:统一对接物流公司API,实现单号获取、轨迹查询、运费计算。 +* **风控系统**:在提交订单、支付等环节进行风险识别(如刷单、欺诈地址)。 +* **消息中心**:通过多种渠道(站内信、短信、APP推送、微信模板消息)向用户发送订单状态变更通知。 +* **数据监控与报表**:监控订单各环节转化率、异常订单比例、售后率等关键指标,用于业务决策与流程优化。 + +## 5. 总结 +本方案设计了一个闭环的电商订单处理流程,强调了各环节的衔接、异常处理以及系统化支撑。实施时应根据具体业务规模和发展阶段,优先保证核心流程的稳定与高效,再逐步完善自动化、智能化功能,以提升整体运营效率和用户体验。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/节点配置中的温度和最大Token数是什么意思?.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/节点配置中的温度和最大Token数是什么意思?.md new file mode 100644 index 0000000..a1050e7 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/节点配置中的温度和最大Token数是什么意思?.md @@ -0,0 +1,115 @@ +这两个参数用于控制 LLM 的生成行为: + +## 温度(Temperature) + +含义:控制输出的随机性和创造性 + +取值范围:通常是 0.0 到 2.0(或更高) + +作用: + +- 低温度(0.0-0.3): + +- 输出更确定、一致 + +- 更倾向于选择概率最高的词 + +- 适合:事实问答、代码生成、翻译等需要准确性的任务 + +- 示例:Temperature = 0.1 → 回答更稳定、可预测 + +- 中等温度(0.5-0.7): + +- 平衡确定性和创造性 + +- 适合:一般对话、内容创作 + +- 示例:Temperature = 0.5(当前配置)→ 平衡选择 + +- 高温度(0.8-2.0): + +- 输出更随机、多样 + +- 更可能选择概率较低的词 + +- 适合:创意写作、头脑风暴等需要多样性的任务 + +- 示例:Temperature = 1.0 → 回答更多样、有创意 + +建议: + +- 当前配置 0.5 适合大多数场景 + +- 需要更准确时降到 0.2-0.3 + +- 需要更多样性时提高到 0.7-0.9 + +## 最大Token数(Max Tokens) + +含义:限制 LLM 生成文本的最大长度 + +单位:Token(约等于 0.75 个英文单词,或 1-2 个中文字符) + +作用: + +- 控制回答的最大长度 + +- 防止生成过长内容 + +- 影响 API 调用成本(通常按 Token 计费) + +当前配置 1500 的含义: + +- 约等于 1000-1500 个英文单词 + +- 或约 750-1500 个中文字符 + +- 适合:中等长度的回答 + +建议: + +- 简短回答:500-800 tokens(快速问答) + +- 中等回答:1000-1500 tokens(当前配置,适合大多数场景) + +- 长回答:2000-4000 tokens(详细分析、长文章) + +- 超长内容:4000+ tokens(需要分段处理) + +## 实际应用示例 + +场景1:快速问答 + +Temperature: 0.2 + +Max Tokens: 500 + +→ 简短、准确的回答 + +场景2:创意写作 + +Temperature: 0.8 + +Max Tokens: 2000 + +→ 多样、有创意的长文本 + +场景3:代码生成 + +Temperature: 0.1 + +Max Tokens: 1500 + +→ 准确、一致的代码 + +## 注意事项 + +1. Temperature 过高:可能产生不相关或混乱的输出 + +2. Temperature 过低:可能过于保守,缺乏变化 + +3. Max Tokens 过小:回答可能被截断 + +4. Max Tokens 过大:可能生成不必要的内容,增加成本 + +当前配置(Temperature: 0.5, Max Tokens: 1500)适合大多数对话场景。如需调整,可根据具体任务修改。 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/saars开发/aiapply/项目低代码智能体功能扩展.md b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/项目低代码智能体功能扩展.md new file mode 100644 index 0000000..8a17365 --- /dev/null +++ b/docs/Obsidian笔记体系/Projects/saars开发/aiapply/项目低代码智能体功能扩展.md @@ -0,0 +1,183 @@ +项目低代码智能体功能扩展 + +该项目可扩展低代码快速搭建智能体的功能吗 + +检查项目结构,评估是否可扩展低代码快速搭建智能体的功能。 + +继续查看项目架构,评估是否可扩展低代码智能体搭建功能。 + +查看 API 路由和核心组件,评估扩展能力: + +基于对项目的分析,评估如下: + +## 项目扩展低代码智能体搭建的可行性评估 + +### 当前项目优势 + +1. 模板系统 + +- 结构化模板(角色、任务、上下文、约束) + +- 变量系统(文本、选择、数字、布尔等) + +- 模板管理和分享 + +1. 多模型支持 + +- 支持 OpenAI、Anthropic、DeepSeek + +- 单模型和批量测试 + +1. 部署能力 + +- 代码生成(Python、JavaScript、TypeScript) + +- 多框架支持(FastAPI、Express 等) + +1. 用户系统 + +- 认证、权限、模板归属 + +### 需要扩展的核心功能 + +文档中提到了“提示词链”概念,但尚未实现。要支持低代码智能体搭建,需要添加: + +#### 1. 工作流编排系统 + +- 将多个模板串联成工作流 + +- 节点连接(顺序、并行、条件分支) + +- 数据流转(上一步输出作为下一步输入) + +#### 2. 可视化工作流编辑器 + +- 拖拽式节点编辑器 + +- 节点类型:模板节点、条件节点、工具节点、数据节点 + +- 连线表示数据流 + +#### 3. 智能体运行时引擎 + +- 工作流执行引擎 + +- 状态管理(持久化、恢复) + +- 错误处理和重试 + +#### 4. 工具集成能力 + +- 外部 API 调用 + +- 数据库操作 + +- 文件处理 + +- 定时任务 + +#### 5. 触发器系统 + +- Webhook 触发 + +- 定时触发 + +- 事件触发 + +- 手动触发 + +### 实现建议 + +基于现有架构,建议按以下步骤扩展: + +#### 阶段一:工作流基础(核心) + +1. 数据库扩展:添加工作流表、节点表、连接表 + +2. 工作流 API:创建、执行、管理 + +3. 简单执行引擎:顺序执行多个模板 + +#### 阶段二:可视化编辑器 + +1. 使用 React Flow 或类似库 + +2. 节点组件:模板节点、条件节点 + +3. 连线与数据映射 + +#### 阶段三:高级功能 + +1. 条件分支与循环 + +2. 工具集成(API、数据库) + +3. 触发器系统 + +### 技术实现路径 + +// 1. 扩展数据库模型(Prisma Schema) + +model Workflow { + +  id          String   @id @default(cuid()) + +  name        String + +  description String? + +  nodes       WorkflowNode[] + +  edges       WorkflowEdge[] + +  authorId    String + +  // ... + +} + +model WorkflowNode { + +  id         String   @id @default(cuid()) + +  workflowId String + +  type       String   // 'template' | 'condition' | 'tool' | 'data' + +  templateId String?  // 如果是模板节点 + +  config     String   // JSON 配置 + +  // ... + +} + +// 2. 工作流执行引擎 + +class WorkflowEngine { + +  async execute(workflowId: string, input: any) { + +    // 执行工作流逻辑 + +  } + +} + +### 结论 + +- 可行性:高。项目具备良好基础,架构清晰,易于扩展。 + +- 工作量:中等。核心工作流功能约 2-3 周,完整低代码平台约 2-3 个月。 + +- 建议:先实现工作流编排和执行引擎,再逐步添加可视化编辑器和高级功能。 + +需要我帮你开始实现工作流系统吗?我可以: + +1. 设计数据库模型 + +2. 创建工作流 API + +3. 实现基础执行引擎 + +4. 构建可视化编辑器界面 \ No newline at end of file diff --git a/docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md b/docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md index 4b0fad4..f5c40df 100644 --- a/docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md +++ b/docs/Obsidian笔记体系/Projects/知你-调测/知你--调测.md @@ -9,6 +9,10 @@ C:\Users\86181\AppData\Local\Android\Sdk\build-tools\35.0.0 检验签名:apksigner verify -v --print-certs app-debug.apk apksigner verify -v --print-certs app-release.apk + + + +apksigner sign --ks keystore2 com.xiaomi.appstore.appclaim.signature.verification.apk # 知你的签名信息 C:\Users\86181\AppData\Local\Android\Sdk\build-tools\35.0.0>apksigner verify -v --print-certs app-release.apk Verifies diff --git a/mkdocs.yml b/mkdocs.yml index e7745b9..c13f48b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -187,6 +187,24 @@ nav: - Obsidian笔记体系/Daily/2026-01-15.md - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 1.md - Obsidian笔记体系/Projects/saars开发/aiapply/未命名.md + - Obsidian笔记体系/Daily/2026-01-20.md + - Obsidian笔记体系/Projects/saars开发/aiapply/# 工作流和Agent平台架构方案分析.md + - Obsidian笔记体系/Projects/saars开发/aiapply/Agent和模板节点的区别.md + - Obsidian笔记体系/Projects/saars开发/aiapply/android应用agent.md + - Obsidian笔记体系/Projects/saars开发/aiapply/内容生成助手Agent.md + - Obsidian笔记体系/Projects/saars开发/aiapply/工作流和Agent平台提示词目录.md + - Obsidian笔记体系/Projects/saars开发/aiapply/工作流测试工具.md + - Obsidian笔记体系/Projects/saars开发/aiapply/工作流(Workflow)vs Agent(智能体)的区别.md + - Obsidian笔记体系/Projects/saars开发/aiapply/智能需求分析与解决方案生成器_使用说明.md + - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 2.md + - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 3.md + - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 4.md + - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 5.md + - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 6.md + - Obsidian笔记体系/Projects/saars开发/aiapply/未命名 7.md + - Obsidian笔记体系/Projects/saars开发/aiapply/电商系统用户订单处理流程设计方案.md + - Obsidian笔记体系/Projects/saars开发/aiapply/节点配置中的温度和最大Token数是什么意思?.md + - Obsidian笔记体系/Projects/saars开发/aiapply/项目低代码智能体功能扩展.md - gerrit: - gerrit/gerrit上传代码详细指南.md - gerrit/gerrit分支规范.md