架构说明

本页由 README 拆分而来,内容与代码同步维护。返回 README。

系统架构

┌─────────────────────────────────────────────────────────────┐
│                        AgentFlow v2.0.2                     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌───────────┐         ┌───────────────┐                  │
│   │ Frontend  │ ◄─────► │    Backend    │                  │
│   │  (React)  │  HTTP   │   (FastAPI)   │                  │
│   │ :3000/:5173│  SSE    │    :8001      │                  │
│   └───────────┘         └───────┬───────┘                  │
│                                 │                          │
│              ┌──────────────────┼──────────────────┐        │
│              │                  │                  │        │
│       ┌──────▼──────┐   ┌───────▼──────┐   ┌───────▼─────┐ │
│       │  SQLite     │   │ PostgreSQL + │   │   Redis     │ │
│       │ (默认)     │   │  pgvector    │   │ (可选)     │ │
│       │ data/*.db   │   │  (可选)     │   │ 验证码/缓存  │ │
│       └─────────────┘   └──────────────┘   └─────────────┘ │
│                                                             │
│   外部依赖(均为 HTTP 调用,可指向本地服务):                │
│   对话模型端点 · 向量模型端点 · 外部只读数据源(ERP)         │
└─────────────────────────────────────────────────────────────┘

没有 Celery Worker,也没有消息队列:当前所有任务在同一条异步请求链路里完成,单机部署不需要额外的 worker 容器。

后端技术栈

技术 用途
Python 3.11+ 核心语言
FastAPI 异步 Web 框架
SQLAlchemy 2.0 异步 ORM
pgvector 向量相似度搜索
自研工作流引擎 节点编排与执行(app/services/workflow_runtime.py)
Alembic 数据库迁移
chromadb 知识库向量存储(经 langchain_community 调用)
Stripe 订阅支付(可选,未配置时计费模块不启用)

前端技术栈

技术 用途
React 18+ UI 框架
TypeScript 5.0 类型安全
Vite 5 构建工具
ReactFlow 拖拽式工作流编辑器
Tailwind CSS 3.4 原子化样式
Zustand 状态管理

工作流节点类型

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│  START   │────▶│   LLM    │────▶│CONDITION │────▶│  OUTPUT  │
│  入口    │     │  大模型  │     │  条件分支│     │   出口   │
└──────────┘     └──────────┘     └────┬─────┘     └──────────┘
                                      │
                                      ▼
                               ┌──────────┐
                               │KNOWLEDGE │
                               │知识库检索│
                               └──────────┘
节点 功能 典型用途
Start / End 工作流入口 / 出口 定义流程边界
LLM 调用大模型生成回复 问答、翻译、摘要
Condition 根据变量值路由分支 意图识别分流
Tool 调用外部工具 搜索、计算、API
Knowledge RAG 知识库检索 企业文档问答
Browser 浏览器自动化 网页操作、数据采集

项目结构

agentflow/
├── backend/                    # FastAPI 后端
│   ├── app/
│   │   ├── api/               # REST API 路由
│   │   ├── core/              # 配置 / 数据库 / 缓存
│   │   ├── models/            # SQLAlchemy ORM 模型
│   │   ├── services/          # 业务逻辑 (LLM / Knowledge / Browser / 工作流运行时)
│   │   └── integrations/      # 提示词/输出解析、工具与记忆的适配层
│   ├── migrations/            # Alembic 迁移
│   └── tests/
│
├── frontend/                   # React 前端
│   ├── src/
│   │   ├── components/        # workflow / landing / layout / ui
│   │   ├── pages/             # Dashboard / Login / Chat / Workflow...
│   │   └── services/api.ts    # API 客户端
│   └── package.json
│
├── skills/                     # Skill 定义(SKILL.md + scripts/)v2.0.1
│   ├── excel/
│   ├── pdf/
│   └── ...
├── examples/                   # 独立示例(可脱离平台单独运行)
│   └── generate_ai_ppt.py      # 用代码生成一份结构完整的 PPT
├── assets/                     # README 配图与演示素材
│   ├── banner.svg              # 顶部横幅(可编辑源文件)
│   ├── banner.gif              # 顶部横幅动图,由 scripts/build-banner-gif.py 生成
│   ├── banner.png              # 顶部横幅静态回退
│   ├── screens/                # 界面截图
│   ├── gifs/                   # 功能演示动图
│   ├── videos/                 # 完整演示录屏
│   └── ppt/                    # 自动生成的 PPT 页面示例
├── config/
│   └── models.json             # Skill 可用模型清单
├── static/generated/           # Skill 工具产出文件
├── docker-compose.yml
├── .env.example
└── README.md

开箱即用的行业模板

模板 场景 核心功能
💬 智能客服 客服中心 FAQ 自动回答 · 多轮对话 · 工单创建
💰 销售助手 销售团队 客户跟进 · 报价生成 · CRM 集成
👥 HR 助手 人力资源 政策查询 · 假期申请 · 培训推荐
📊 财务助手 财务部门 报销审批 · 发票查询 · 报表生成
📚 知识库问答 企业知识库 文档导入 · 智能检索 · 权限管理
📅 预约助手 服务行业 在线预约 · 日程管理 · 提醒通知