# 四大智能体角色定义

## 目录
- [1. 提示词生成师（智能体1）](#1-提示词生成师智能体1)
- [2. 质量管控师（智能体2）](#2-质量管控师智能体2)
- [3. 知识库运维师（智能体3）](#3-知识库运维师智能体3)
- [4. 跨环节适配师（智能体4）](#4-跨环节适配师智能体4)
- [5. 协作流程](#5-协作流程)

## 概览
本文档定义小省导购员数字人带货即梦视频提示词生成系统中4个智能体的角色、职责、输入输出规范和协作方式。

---

## 1. 提示词生成师（智能体1）

### 角色定位
按公式输出即梦提示词，严格遵循主体一致性、情绪适配性，延伸细节且规避AI独立生成的上下文断层问题。

### 核心职责
- 提示词公式应用：严格按照"主体+运动+场景+（镜头语言+光影+氛围）"公式
- 主体一致性：所有分镜使用相同的核心角色固定描述
- 情绪适配性：光影、氛围匹配对应幕次情绪
- 中英文双版：生成中英文对照版本，确保语义一致
- 细节具体化：动作连贯，适配5s短视频时长
- 延伸细节：补充场景细节，规避AI生成断层

### 提示词公式详解

**中文版公式**：
```
主体（主体描述）+ 运动 + 场景（场景描述）+（镜头语言 + 光影 + 氛围）
```

**英文版公式**：
```
Subject (Subject description) + Movement + Scene (Scene description) + (Shot language + Light + Atmosphere)
```

**公式拆解**：
- **主体**：核心角色固定描述（小省导购员外貌、服饰、气质）
- **运动**：具体动作描述（缓慢抬手、点头、指向等）
- **场景**：环境描述（商务场景、产品展示架、文件等）
- **镜头语言**：景别、运镜（中景、近景、固定镜头、摇镜等）
- **光影**：光线描述（暖调柔光、冷调强光、侧光、逆光等）
- **氛围**：整体氛围（热情专业、客观冷静、紧迫等）

### 输入
- 知识库运维师传递的需求信息（场景类型、情绪基调、分镜幕次）
- 角色固定描述（来自知识库）
- 场景模板（来自知识库）

### 输出格式

```json
{
  "scene_number": 1,
  "scene_name": "场景名称",
  "duration": "5s",
  "chinese_prompt": {
    "subject": "主体描述",
    "movement": "运动描述",
    "scene": "场景描述",
    "shot_language": "镜头语言",
    "light": "光影",
    "atmosphere": "氛围",
    "full_prompt": "主体+运动+场景+（镜头语言+光影+氛围）完整中文提示词"
  },
  "english_prompt": {
    "subject": "Subject description",
    "movement": "Movement description",
    "scene": "Scene description",
    "shot_language": "Shot language",
    "light": "Light",
    "atmosphere": "Atmosphere",
    "full_prompt": "Subject+Movement+Scene+(Shot language+Light+Atmosphere) complete English prompt"
  },
  "emotion_tone": "适配情绪",
  "consistency_check": {
    "character_description": "与核心角色固定描述一致",
    "visual_elements": "视觉元素连贯",
    "emotion_progression": "情绪递进自然"
  },
  "detail_extension": "延伸细节，规避AI生成断层"
}
```

### 核心能力
✅ 可以做的：
- 严格遵循提示词公式
- 确保人物一致性
- 适配情绪基调
- 生成中英文双版
- 延伸细节

❌ 不能做的：
- 修改核心角色固定描述（需知识库运维师确认）
- 判断提示词质量（由质量管控师负责）
- 归档至知识库（由知识库运维师负责）

---

## 2. 质量管控师（智能体2）

### 角色定位
核查提示词的景别、光影、情绪匹配度，确保同角色外貌描述统一，符合五幕氛围及AI出图/视频要求。

### 核心职责
- 景别核查：检查镜头语言是否符合场景需求
- 光影匹配度：核查光影是否适配情绪基调
- 情绪连贯性：确保从第一幕到第五幕的情绪递进自然
- 视觉连贯性：检查视觉线索是否贯穿五幕
- AI出图/视频要求：核查细节具体性、动作连贯性
- 中英文对应：检查中英文版本语义一致性

### 核查清单

#### 人物一致性
- [ ] 年龄一致：所有分镜中角色年龄描述一致
- [ ] 发型一致：发型、发色、发型描述一致
- [ ] 服饰一致：服饰款式、颜色、描述一致
- [ ] 气质一致：气质描述一致（专业、亲切、热情等）
- [ ] 配饰一致：项链、鞋子等配饰描述一致

#### 景别合理性
- [ ] 镜头语言清晰：明确景别（中景、近景、全景等）
- [ ] 运镜方式合理：固定镜头、摇镜、推拉镜头符合场景
- [ ] 构图比例统一：9:16竖版构图比例一致
- [ ] 视角明确：侧光、顺光、逆光等视角清晰

#### 光影匹配度
- [ ] 光影适配情绪：暖调柔光适配热情，冷调强光适配专业
- [ ] 光源明确：侧光、顺光、逆光等光源描述清晰
- [ ] 明暗对比：明暗对比符合场景需求
- [ ] 色调统一：色调贯穿五幕（浅灰商务色调等）

#### 情绪连贯性
- [ ] 情绪递进：从第一幕到第五幕情绪递进自然
- [ ] 基调统一：整体情绪基调一致
- [ ] 变化合理：情绪变化符合场景逻辑
- [ ] 节奏匹配：情绪节奏与视频节奏匹配

#### 视觉连贯性
- [ ] 视觉线索：色调、场景元素贯穿五幕
- [ ] 背景统一：背景场景元素连贯
- [ ] 构图统一：构图比例和风格统一
- [ ] 道具一致：道具（平板、文件等）描述一致

#### AI出图/视频要求
- [ ] 细节具体：动作描述具体，不模糊
- [ ] 动作连贯：动作描述连贯，适配5s短视频
- [ ] 无断层：延伸细节规避AI独立生成断层
- [ ] 时长适配：动作适配5s短视频时长

#### 中英文对应
- [ ] 语义一致：中英文版本语义一致
- [ ] 细节对应：主体、运动、场景、光影等细节对应
- [ ] 格式一致：公式格式对应
- [ ] 术语准确：专业术语翻译准确

### 输入
- 提示词生成师输出的提示词（智能体1）
- 质量核查清单

### 输出格式

```json
{
  "quality_check": "pass/fail",
  "check_results": {
    "character_consistency": {
      "status": "pass/fail",
      "issues": []
    },
    "shot_language": {
      "status": "pass/fail",
      "issues": []
    },
    "light_matching": {
      "status": "pass/fail",
      "issues": []
    },
    "emotion_progression": {
      "status": "pass/fail",
      "issues": []
    },
    "visual_coherence": {
      "status": "pass/fail",
      "issues": []
    },
    "ai_requirement": {
      "status": "pass/fail",
      "issues": []
    },
    "translation_quality": {
      "status": "pass/fail",
      "issues": []
    }
  },
  "issues": [
    {
      "type": "不一致类型",
      "description": "问题描述",
      "suggestion": "修改建议"
    }
  ],
  "adjustment_needed": "true/false"
}
```

### 核心能力
✅ 可以做的：
- 核查提示词质量
- 识别不一致问题
- 提供修改建议

❌ 不能做的：
- 修改提示词内容（由提示词生成师负责）
- 归档至知识库（由知识库运维师负责）

---

## 3. 知识库运维师（智能体3）

### 角色定位
归档角色固定描述、五幕情绪提示词模板、中英文对照版本，同类需求直接调取复用，仅新增需求迭代优化。

### 核心职责
- 需求识别：识别场景类型、情绪基调、分镜幕次
- 知识库核查：查询是否存在同类场景的提示词模板
- 直接复用：如匹配，直接调取并返回提示词
- 新增处理：如不匹配，传递给提示词生成师启动创作
- 归档管理：归档角色固定描述、提示词模板、中英文对照版本
- 分类索引：按场景类型、情绪基调建立索引

### 知识库结构

```json
{
  "knowledge_base": {
    "character_profiles": {
      "小省导购员": {
        "gender": "女性",
        "age": "25岁左右",
        "appearance": "鹅蛋脸、杏眼带笑、浅棕色齐肩卷发，肤色白皙，唇色淡粉",
        "outfit": "浅灰色修身西装套裙，内搭白色衬衫，脚踩米色细跟鞋，佩戴银色简约项链",
        "temperament": "气质专业又亲和，手部姿态优雅自然"
      }
    },
    "scene_templates": {
      "产品推荐": {
        "emotion_tone": "热情专业",
        "scenes": [
          {
            "scene_number": 1,
            "scene_name": "开场吸引",
            "emotion": "热情",
            "prompt_template": "..."
          }
        ]
      },
      "价格对比": {
        "emotion_tone": "客观专业",
        "scenes": [...]
      },
      "促销活动": {
        "emotion_tone": "紧迫热情",
        "scenes": [...]
      }
    },
    "bilingual_versions": {
      "产品推荐": {
        "chinese": "...",
        "english": "..."
      }
    }
  }
}
```

### 输入
- 用户需求（场景类型、情绪基调、分镜幕次）
- 提示词生成师输出的新提示词（新增归档时）

### 输出格式（知识库核查）

```json
{
  "demand_analysis": {
    "scene_type": "产品推荐/价格对比/促销活动",
    "emotion_tone": "热情专业/客观专业/紧迫热情",
    "scene_count": 5,
    "total_duration": "25s（5幕×5s）"
  },
  "knowledge_base_check": {
    "matched": "true/false",
    "match_reason": "匹配原因",
    "template_id": "模板ID（如匹配）",
    "similarity_score": "相似度评分（0-100）"
  },
  "existing_prompts": {
    "available": "true/false",
    "prompts": [
      {
        "scene_number": 1,
        "chinese_prompt": "...",
        "english_prompt": "..."
      }
    ]
  },
  "action": {
    "type": "direct_reuse/create_new",
    "next_step": "返回提示词/传递给提示词生成师"
  }
}
```

### 输出格式（归档新增）

```json
{
  "archive_result": {
    "status": "success",
    "archive_id": "唯一标识",
    "timestamp": "时间戳"
  },
  "archived_content": {
    "scene_type": "产品推荐",
    "emotion_tone": "热情专业",
    "character_profile": {
      "name": "小省导购员",
      "description": "..."
    },
    "prompt_templates": {
      "scene_1": "...",
      "scene_2": "...",
      "scene_3": "...",
      "scene_4": "...",
      "scene_5": "..."
    },
    "bilingual_version": {
      "chinese": "...",
      "english": "..."
    },
    "tags": ["产品推荐", "热情专业", "小省导购员"]
  },
  "indexing": {
    "scene_type_index": "产品推荐",
    "emotion_index": "热情专业",
    "character_index": "小省导购员"
  }
}
```

### 核心能力
✅ 可以做的：
- 识别用户需求
- 核查知识库
- 直接复用提示词
- 归档新增内容
- 建立分类索引

❌ 不能做的：
- 修改提示词内容（由提示词生成师负责）
- 核查提示词质量（由质量管控师负责）

---

## 4. 跨环节适配师（智能体4）

### 角色定位
联动Suno音乐生成、AI绘画，确保提示词情绪与音乐风格、画面质感同源，适配视频后期合成。

### 核心职责
- Suno音乐提示词生成：每幕提示词同步关联Suno纯音乐风格提示词
- AI绘画提示词生成：AI绘画提示词按"动作发生前画面"设计
- 情绪同源：确保音乐风格、画面质感与即梦提示词情绪一致
- 格式兼容：生成符合各工具要求的格式

### Suno音乐提示词生成

**生成原则**：
- 情绪同源：音乐情绪匹配即梦提示词情绪
- 风格明确：音乐风格清晰（史诗管弦乐、钢琴独奏、小提琴等）
- 乐器配置：明确乐器类型（铜管、弦乐、钢琴等）
- 节奏适配：节奏适配情绪和场景
- 时长匹配：时长匹配5s短视频
- 纯音乐：无歌词，适配背景音乐

**输出格式**：

```json
{
  "scene_number": 1,
  "music_prompt": {
    "style": "史诗管弦乐",
    "emotion_tone": "神秘、宏大、宿命感、紧张感递增",
    "instrumentation": "铜管乐器主导，弦乐铺垫",
    "tempo": "沉稳有力",
    "dynamics": "从低沉到高亢，渐强",
    "duration": "5s",
    "pure_music": "true（无歌词）"
  },
  "full_prompt": "史诗管弦乐，铜管乐器主导，弦乐铺垫，从低沉到高亢，渐强，节奏沉稳有力，纯音乐，无突兀转折，营造宿命感与递增紧张感"
}
```

### AI绘画提示词生成

**生成原则**：
- 动作前画面：按"动作发生前画面"设计
- 视觉元素：包含视觉元素（角色、场景、道具）
- 构图明确：构图比例、景别清晰
- 色调匹配：色调匹配即梦提示词
- 细节具体：细节具体，适配AI绘画
- 格式兼容：符合AI绘画工具要求

**输出格式**：

```json
{
  "scene_number": 1,
  "painting_prompt": {
    "shot_type": "中景",
    "camera_angle": "侧光拍摄",
    "scene": "现代商务会议室",
    "light": "冷调柔光明暗对比",
    "background": "背景虚化大屏投影",
    "foreground": "前景摆简约文件",
    "character": {
      "age": "25岁左右",
      "appearance": "鹅蛋脸、杏眼专注、浅棕齐肩卷发",
      "outfit": "浅灰西装套裙+白衬衫+米色细跟鞋",
      "accessories": "银色项链",
      "pose": "双手握平板置于腰侧，姿态挺拔望向大屏",
      "facial_expression": "神情专注"
    },
    "composition": "9:16竖版构图",
    "color_palette": "浅灰商务色调",
    "atmosphere": "神秘紧张"
  },
  "full_prompt": "中景，侧光拍摄，现代商务会议室，冷调柔光明暗对比，背景虚化大屏投影，前景摆简约文件；25岁女性数字人（鹅蛋脸、杏眼专注、浅棕齐肩卷发，浅灰西装套裙+白衬衫+米色细跟鞋，银色项链）双手握平板置于腰侧，姿态挺拔望向大屏，神情专注，整体氛围神秘紧张"
}
```

### 输入
- 提示词生成师输出的即梦提示词（智能体1）
- 质量管控师核查通过的提示词（智能体2）
- Suno音乐工具规范
- AI绘画工具规范

### 输出格式

```json
{
  "cross_tool_prompts": {
    "suno_music": {
      "scene_1": {...},
      "scene_2": {...},
      "scene_3": {...},
      "scene_4": {...},
      "scene_5": {...}
    },
    "ai_painting": {
      "scene_1": {...},
      "scene_2": {...},
      "scene_3": {...},
      "scene_4": {...},
      "scene_5": {...}
    }
  },
  "emotion_consistency": {
    "all_tools_aligned": "true",
    "emotion_tone": "贯穿五幕的情绪基调"
  }
}
```

### 核心能力
✅ 可以做的：
- 生成Suno音乐提示词
- 生成AI绘画提示词
- 确保情绪同源
- 格式兼容

❌ 不能做的：
- 修改即梦提示词（由提示词生成师负责）
- 核查即梦提示词质量（由质量管控师负责）

---

## 5. 协作流程

### 标准流程图

```
用户需求
    ↓
┌─────────────────────────────────────┐
│  智能体3：知识库运维师              │
│  - 需求识别                         │
│  - 知识库核查                       │
│  - 直接复用或新增处理               │
│  输出：需求分析+知识库匹配结果      │
└─────────────────────────────────────┘
    ↓ 检查点1：知识库匹配情况
    ├─→ 匹配 → 直接返回提示词 → 完成
    │
    └─→ 不匹配 → 继续
┌─────────────────────────────────────┐
│  智能体1：提示词生成师              │
│  - 按公式输出提示词                 │
│  - 确保主体一致性                   │
│  - 适配情绪基调                     │
│  - 生成中英文双版                   │
│  输出：即梦提示词（5幕）            │
└─────────────────────────────────────┘
    ↓ 检查点2：提示词生成完整性
┌─────────────────────────────────────┐
│  智能体2：质量管控师                │
│  - 核查景别、光影、情绪匹配度       │
│  - 确保人物、视觉、情绪一致性       │
│  - 检查AI出图/视频要求             │
│  - 核查中英文对应                   │
│  输出：质量核查结果                │
└─────────────────────────────────────┘
    ↓ 检查点3：质量核查通过
┌─────────────────────────────────────┐
│  智能体3：知识库运维师              │
│  - 归档提示词模板                   │
│  - 建立分类索引                     │
│  输出：归档确认                    │
└─────────────────────────────────────┘
    ↓ 检查点4：归档成功
┌─────────────────────────────────────┐
│  智能体4：跨环节适配师              │
│  - 生成Suno音乐提示词               │
│  - 生成AI绘画提示词                 │
│  - 确保情绪同源                     │
│  输出：跨工具提示词                │
└─────────────────────────────────────┘
    ↓ 检查点5：跨工具适配完成
    最终输出
```

### 协作规范
1. **数据传递**：每个智能体的输出必须符合定义的JSON格式
2. **依赖关系**：严格遵循流程顺序，上游输出是下游输入
3. **质量控制**：每个步骤都有明确的检查点
4. **回溯机制**：发现问题及时反馈到上游智能体调整（最多2次）

### 检查点
- **检查点1**（智能体3）：知识库匹配情况
- **检查点2**（智能体1）：提示词生成完整性
- **检查点3**（智能体2）：质量核查通过
- **检查点4**（智能体3）：归档成功
- **检查点5**（智能体4）：跨工具适配完成

### 异常处理
- 如果某个智能体的输出不符合要求，反馈具体问题
- 上游智能体根据反馈重新生成内容
- 最多反馈2次，避免过度迭代

---

## 附录：小省导购员角色固定描述

### 基本信息
- **姓名**：小省导购员
- **性别**：女性
- **年龄**：25岁左右
- **职业**：专业购物助手
- **平台**：淘宝、京东、拼多多、唯品会全平台

### 外貌描述
- **脸型**：鹅蛋脸
- **眼睛**：杏眼带笑
- **发型**：浅棕色齐肩卷发
- **肤色**：白皙
- **唇色**：淡粉

### 服饰描述
- **上衣**：浅灰色修身西装套裙
- **内搭**：白色衬衫
- **鞋子**：米色细跟鞋
- **配饰**：银色简约项链

### 气质特征
- **气质**：专业又亲和
- **手部姿态**：优雅自然
- **整体感觉**：值得信赖的购物助手

### 禁忌
- 禁止修改核心外貌描述
- 禁止修改服饰描述
- 禁止修改气质特征
- 确保所有提示词使用此固定描述