Brief → 策略 → PPT + 排期 → 结案报告，全链路一键自动化
AdFlow 是一款面向广告媒体/营销团队的 AI Agent 工具，基于 LangGraph 多 Agent 架构，将客户 Brief 自动转化为完整的营销方案包，并支持投放结束后生成结案报告。
| 功能 | 描述 |
|---|---|
| 🧠 Brief 解析 | 自动解析 PDF / 文本 Brief，提取品牌、预算、投放时间、目标受众等关键信息 |
| 📋 策略生成 | 结合知识库（刊例/规范）自动生成投放策略，支持人工审批与修改意见 |
| 🎨 素材文案 | 自动生成图片广告文案、视频脚本、AI 绘图提示词 |
| 📊 方案输出 | 自动生成营销方案 PPT + 投放排期 Excel，打包为 ZIP |
| 📈 结案报告 | 导入美团后台数据，自动生成结案分析 PPT |
| 📚 知识库管理 | 支持上传刊例 PDF / 素材规范 Excel 到向量知识库，供 Agent 查询参考 |
| 👥 客户管理（CRM） | 记录客户档案、历史方案、消耗数据、投放产品，Brief 联动客户历史背景 |
| 🌐 Web 界面 | 内置 Web UI，支持浏览器操作，无需命令行 |
| 🤖 飞书 Bot（可选） | 通过飞书消息直接发 Brief、上传文件、审批策略 |
┌─────────────────────────────────────────────────────────┐
│ 用户接口层 │
│ Web UI (Flask) │ CLI (Typer) │ 飞书 Bot (可选) │
└────────────────────────┬────────────────────────────────┘
│
┌────────────────────────▼────────────────────────────────┐
│ AdFlow Agent 编排层 │
│ LangGraph 状态机 + 多 Agent 协作 │
│ │
│ BriefParser → StrategyPlanner → CreativeProducer │
│ ↓ ↓ ↓ │
│ KnowledgeAgent RateCardAgent ResourcePackager │
└────────────────────────┬────────────────────────────────┘
│
┌────────────────────────▼────────────────────────────────┐
│ 基础设施层 │
│ ChromaDB（向量库）│ JSON文件（客户数据）│ OpenAI API │
└─────────────────────────────────────────────────────────┘
技术栈： Python 3.11 · LangGraph · LangChain · ChromaDB · sentence-transformers · Flask · Pydantic · python-pptx · openpyxl
# 方式一：双击运行（Windows）
install.bat
# 方式二：手动安装
python -m venv .venv
.venv\Scripts\activate # Windows
source .venv/bin/activate # macOS/Linux
pip install -e ".[feishu]"复制 .env.example 为 .env，填入你的 Key：
cp .env.example .env# .env
OPENAI_API_KEY=你的APIKey
OPENAI_BASE_URL=https://ark.cn-beijing.volces.com/api/coding/v3 # 可改为官方地址adflow serve
# 浏览器打开 http://localhost:5000# 上传刊例到知识库（一次性）
adflow kb add 美团刊例.pdf --type rate_card
# 根据 Brief 生成方案
adflow run --file brief.pdf --brand "某品牌"
# 纯文字描述
adflow run --brief "美团Q2品牌曝光方案，预算50万，4月1日~5月31日"
# 生成结案报告
adflow report 投放数据.xlsx --brand "某品牌"adflow/
├── adflow/ # 核心代码
│ ├── adapters/ # 接口适配层（Web / CLI / 飞书）
│ ├── modules/ # Agent 模块
│ │ ├── brief_parser/ # Brief 解析 Agent
│ │ ├── strategy_planner/# 策略规划 Agent
│ │ ├── creative_producer/# 素材生成 Agent
│ │ ├── knowledge_agent/ # 知识库查询 Agent
│ │ ├── rate_card_agent/ # 刊例解析 Agent
│ │ ├── resource_packager/# 文件打包（PPT/Excel/ZIP）
│ │ └── report_generator/# 结案报告生成
│ ├── core/ # 核心模型、配置、日志
│ └── prompts/ # Prompt 模板
├── uploads/
│ ├── briefs/ # 上传的 Brief 文件
│ ├── references/ # 刊例 / 规范文件
│ └── data/ # 结案数据文件
├── outputs/
│ ├── packages/ # 生成的方案 PPT / Excel / ZIP
│ └── reports/ # 生成的结案报告
├── data/
│ └── customers/ # 客户档案数据（JSON）
├── .env.example # 环境变量配置示例
├── install.bat # Windows 一键安装脚本
├── USAGE.txt # 详细使用说明
└── pyproject.toml # 项目依赖
用户输入 Brief（文件或文字）
↓
[BriefParser] 解析品牌/预算/时间/受众 → 用户确认
↓
[KnowledgeAgent + RateCardAgent] 查询知识库获取版位规格
↓
[StrategyPlanner] 生成投放策略 → 用户审批（可提修改意见）
↓
[CreativeProducer] 生成素材文案 / AI绘图提示词
↓
[ResourcePackager] 输出 PPT + Excel + ZIP 资源包
Q: PDF 解析内容不准确？
A: 先用 adflow kb add 刊例.pdf 添加刊例，系统会用知识库辅助解析
Q: 生成的方案没有版位规格？
A: 先运行 adflow rate-card 你的刊例.pdf 解析刊例
Q: 想修改生成的策略？
A: 运行时选择"不批准"，输入修改意见，重新生成
Q: 结案数据列名识别错误？
A: 确保 Excel 第一行是列名，包含"曝光"、"点击"、"消耗"等关键字
MIT