# Agents in this Project

本项目是一个**全链路内容生产与分发数字员工**智能体系统，替代人工完成从内容创意生成、视频制作到多平台发布的全流程工作。

## 产品定位

- **核心价值**：效率提升80%、成本优化、合规保障、矩阵协同
- **目标用户**：内容创作者、MCN机构、品牌营销团队

---

## 核心 Agents

### 1. Planning Agent (`agent/planning_bot.py`)

- **类型**: Plan-and-Execute Agent (LangGraph)
- **模型**: GLM-4-Plus
- **职责**: 任务分解与多步骤执行
- **工作流**:
  1. **Planner**: 分解用户请求为执行步骤
  2. **Executor**: 使用 ReAct Agent 执行当前步骤
  3. **Replanner**: 分析结果，决定继续或结束

### 2. Standard Tool Agent (`agent/bot.py`)

- **类型**: OpenAI Tools Agent
- **模型**: GLM-4-Plus (via ZhipuAI)
- **职责**: 通用交互、工具调用
- **工具**: `generate_image`, `generate_video`, `search_memory`, `search_knowledge_base`

---

## 业务流程 Agents

### 3. Content Generation Agent (内容生成)

负责视频脚本和软文的自动生成。

**子模块**:

- **Script Writer**: 视频脚本生成（结构化脚本、多版本、平台适配）
- **Copywriter**: 软文生成（种草文、测评文、标题优化、防重）

**输入**:

```json
{
  "topic": "内容主题",
  "industry": "行业领域",
  "platform": "目标平台",
  "duration": "视频时长",
  "style": "风格偏好",
  "selling_points": "核心卖点"
}
```

**输出**: 结构化脚本文档 + 配套软文

### 4. Video Production Agent (视频制作)

负责 AI 视频创意混剪。

**能力**:

- 素材智能匹配（人物、场景、动作识别）
- 自动剪辑（完播率优化、节奏控制）
- 特效添加（转场、字幕、BGM）
- 去重优化（20+ 变换策略，相似度 < 30%）

**输入**:

```json
{
  "script": "结构化脚本",
  "materials": ["素材列表"],
  "resolution": "1080x1920",
  "fps": 30,
  "style": "转场风格"
}
```

**输出**: 成品视频 + 生成报告

### 5. Publishing Agent (多平台发布)

负责 40+ 平台的自动发布与管理。

**能力**:

- 账号管理（OAuth2.0、分组、权限）
- 内容适配（格式、信息、语言）
- 发布控制（即时/定时/批量/智能）
- 数据同步（播放量、点赞、评论）

**支持平台**:

- 国内：抖音、小红书、知乎、B站、头条号等 38 个
- 海外：YouTube、TikTok、Facebook、Twitter

### 6. Content Moderation Agent (内容审核)

负责内容安全审核与合规保障。

**能力**:

- 敏感词过滤（政治、低俗、广告法）
- 平台规则适配
- 版权检测
- 机器预审 + 人工复核

---

## Specialized Skills

位于 `.agent/skills/` 目录，定义专业能力：

### 内容生成类

| Skill           | 描述              |
| --------------- | ----------------- |
| `script-writer` | 视频脚本生成专家  |
| `copywriter`    | 软文生成专家      |
| `media-expert`  | 图片/视频生成专家 |

### 视频制作类

| Skill          | 描述            |
| -------------- | --------------- |
| `video-editor` | AI 视频混剪专家 |

### 发布运营类

| Skill                | 描述             |
| -------------------- | ---------------- |
| `platform-publisher` | 多平台发布专家   |
| `content-moderator`  | 内容安全审核专家 |

### 开发辅助类

| Skill                  | 描述            |
| ---------------------- | --------------- |
| `code-reviewer`        | Python 代码审查 |
| `test-generator`       | pytest 测试生成 |
| `doc-writer`           | 文档编写        |
| `rag-expert`           | 知识库搜索      |
| `product-designer`     | 产品设计        |
| `project-requirements` | 项目需求        |

---

## 完整业务流程

```
┌─────────────────────────────────────────────────────────────────┐
│                     用户输入需求                                  │
│         (主题、行业、平台、素材、风格偏好)                          │
└─────────────────────────┬───────────────────────────────────────┘
                          ↓
┌─────────────────────────┴───────────────────────────────────────┐
│                 Content Generation Agent                         │
│  ┌─────────────────┐    ┌─────────────────┐                     │
│  │  Script Writer  │    │   Copywriter    │                     │
│  │  (视频脚本)      │    │  (配套软文)      │                     │
│  └────────┬────────┘    └────────┬────────┘                     │
└───────────┼──────────────────────┼──────────────────────────────┘
            ↓                      ↓
┌───────────┴──────────────────────┴──────────────────────────────┐
│                 Video Production Agent                           │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐   │
│  │ 素材匹配    │ │ 智能剪辑    │ │ 特效添加    │ │ 去重优化    │   │
│  └─────┬──────┘ └─────┬──────┘ └─────┬──────┘ └─────┬──────┘   │
└────────┼──────────────┼──────────────┼──────────────┼───────────┘
         └──────────────┴──────────────┴──────────────┘
                          ↓
┌─────────────────────────┴───────────────────────────────────────┐
│                Content Moderation Agent                          │
│         (敏感词过滤、平台规则、版权检测)                            │
└─────────────────────────┬───────────────────────────────────────┘
                          ↓
┌─────────────────────────┴───────────────────────────────────────┐
│                  Publishing Agent                                │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐   │
│  │ 账号管理    │ │ 内容适配    │ │ 发布控制    │ │ 数据同步    │   │
│  └────────────┘ └────────────┘ └────────────┘ └────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────────┐
│                     数据仪表盘                                    │
│     (播放量、点赞、评论、转化率、运营报告)                          │
└─────────────────────────────────────────────────────────────────┘
```

---

## 性能指标

| 指标              | 目标值  |
| ----------------- | ------- |
| 脚本/软文生成时间 | ≤ 30秒  |
| 1分钟视频混剪时间 | ≤ 5分钟 |
| 10平台同时发布    | ≤ 2分钟 |
| 并发混剪任务      | 50+     |
| 并发发布账号      | 100+    |

---

## 技术栈

- **LLM**: ZhipuAI GLM-4-Plus
- **图片生成**: CogView-3-Plus
- **视频生成**: CogVideoX
- **框架**: LangChain + LangGraph
- **前端**: Next.js + Streamlit
- **后端**: FastAPI + LangServe
- **向量存储**: ChromaDB