# 创作灵感生成功能使用指南

## 🎯 功能概述

这是一个基于AI的创作灵感生成系统，可以根据你的需求自动：
1. 理解你想创作的内容类型
2. 获取相关的热门视频数据
3. 生成9个具体可执行的创作灵感
4. 如果不满意，可以获取更多灵感

## 📋 支持的内容分类（26个）

- **生活类**: 美食、旅行、泛生活、随拍、亲子、三农
- **娱乐类**: 娱乐、明星、剧情、二次元
- **运动类**: 体育、户外
- **知识类**: 文化教育、校园、政务
- **技能类**: 汽车、科技、游戏、时尚、才艺、创意
- **其他**: 动植物、图文控、公益

## 🚀 快速开始

### 方式1：API接口（推荐）

```bash
# 启动服务
python api.py

# 调用接口
curl -X POST "http://localhost:8001/api/agent" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "我想做一些美食相关的短视频，主要是家常菜的制作教程",
    "max_iterations": 15
  }'
```

### 方式2：测试脚本

```bash
python test_inspiration.py
```

### 方式3：Python代码

```python
import asyncio
from ai_agent import create_agent

async def main():
    agent = create_agent()
    result = await agent.run(
        user_input="我想做一些美食相关的短视频，主要是家常菜的制作教程",
        system_prompt_file="prompts/agent_prompt.md",
        max_iterations=15
    )
    print(result["final_answer"])

asyncio.run(main())
```

## 💡 使用示例

### 示例1：美食类内容

**输入**:
```
我想做一些美食相关的短视频，主要是家常菜的制作教程
```

**系统会**:
1. 识别分类：美食
2. 获取美食类热门视频数据
3. 生成9个创作灵感，例如：
   - 灵感1：10分钟快手早餐
   - 灵感2：一人食晚餐系列
   - 灵感3：剩菜改造大法
   - ...（共9个）

### 示例2：校园类内容

**输入**:
```
我想拍一些关于大学生活的有趣视频，记录校园日常
```

**系统会**:
1. 识别分类：校园
2. 获取校园类热门视频数据
3. 生成9个创作灵感，例如：
   - 灵感1：宿舍神器测评
   - 灵感2：图书馆学习vlog
   - 灵感3：食堂美食探店
   - ...（共9个）

### 示例3：健身类内容

**输入**:
```
我想做一些关于健身的短视频，分享简单的居家锻炼方法
```

**系统会**:
1. 识别分类：体育
2. 获取体育类热门视频数据
3. 生成9个创作灵感，例如：
   - 灵感1：5分钟晨起唤醒操
   - 灵感2：办公室久坐拉伸
   - 灵感3：睡前放松瑜伽
   - ...（共9个）

### 示例4：不明确需求

**输入**:
```
我想做短视频，但不知道拍什么
```

**系统会**:
1. 使用默认分类：泛生活
2. 获取泛生活类热门视频数据
3. 生成9个多样化的创作灵感

## 📊 输出格式

系统会返回结构化的创作灵感：

```markdown
📂 识别的内容分类：【美食】
💡 识别依据：用户提到"美食"和"家常菜"

📊 数据来源：创作指导
📈 分析视频数量：50个

## 🎬 创作灵感

### 灵感 1：10分钟快手早餐
**核心创意**：展示简单快速的早餐制作过程
**执行建议**：固定机位俯拍，配快节奏音乐，展示3-4道快手早餐
**推荐标签**：#快手早餐 #10分钟搞定 #上班族必备
**热门关键词**：快手、早餐、简单

---

### 灵感 2：一人食晚餐系列
**核心创意**：针对独居人群的简单晚餐方案
**执行建议**：温馨的厨房场景，展示食材准备到成品的过程
**推荐标签**：#一人食 #独居生活 #治愈系美食
**热门关键词**：一人食、独居、治愈

---

（共9个灵感）

💭 创作提示：
- 注意画面的美感和食物的色彩搭配
- 配上轻松的背景音乐增加观看体验
- 可以加入小贴士和烹饪技巧
- 保持视频节奏紧凑，控制在1-3分钟
```

## 🔄 获取更多灵感

如果对生成的灵感不满意，可以：

**方式1：继续对话**
```
这些灵感不太适合我，能给我一些其他的吗？
```

系统会：
1. 使用搜索功能获取更多数据
2. 生成新的9个灵感

**方式2：调整需求**
```
我想要更简单一些的，适合新手的
```

系统会：
1. 理解新的要求
2. 重新生成符合要求的灵感

## 🎨 工作原理

```
用户输入描述
    ↓
AI理解需求 → 提取分类
    ↓
获取热门视频数据（创作指导）
    ↓
AI分析数据 → 提取趋势
    ↓
生成9个创作灵感
    ↓
返回给用户
    ↓
（如果不满意）
    ↓
搜索更多数据 → 生成新灵感
```

## 🛠️ 自定义配置

### 修改提示词

编辑 `prompts/agent_prompt.md` 可以调整：
- 灵感生成的风格
- 输出格式
- 分析维度

### 调整灵感数量

在代码中修改 `count` 参数：
```python
generate_creative_inspirations(videos=..., user_query=..., count=12)  # 生成12个
```

### 添加新分类

在 `ai_agent.py` 的 `extract_search_keywords` 函数中添加：
```python
category_map = {
    "你的新分类": ["关键词1", "关键词2", "关键词3"],
    ...
}
```

## 📝 最佳实践

### 1. 清晰描述需求

✅ 好的描述：
- "我想做一些美食相关的短视频，主要是家常菜的制作教程"
- "我想拍一些关于大学生活的有趣视频，记录校园日常"

❌ 不好的描述：
- "给我一些建议"
- "我想做视频"

### 2. 提供具体信息

包含以下信息会得到更好的结果：
- 内容类型（美食、旅行、健身等）
- 目标受众（上班族、学生、宝妈等）
- 内容风格（搞笑、治愈、干货等）
- 特殊要求（简单、快速、低成本等）

### 3. 迭代优化

如果第一次生成的灵感不满意：
- 说明哪些方面不满意
- 提供更多具体要求
- 系统会生成新的灵感

## 🔍 故障排查

### 问题1：无法识别分类

**原因**：描述太模糊或不在支持的分类中

**解决**：
- 使用更明确的分类关键词
- 或者系统会使用"泛生活"作为默认

### 问题2：生成的灵感不够具体

**原因**：数据不足或提示词需要优化

**解决**：
- 尝试获取更多灵感
- 或修改 `prompts/agent_prompt.md` 提示词

### 问题3：API调用失败

**原因**：API Key未配置或网络问题

**解决**：
- 检查 `.env` 文件中的 `DASHSCOPE_API_KEY`
- 确保网络连接正常

## 📚 相关文档

- [README_AGENT.md](README_AGENT.md) - Agent完整文档
- [PROMPTS_GUIDE.md](PROMPTS_GUIDE.md) - 提示词使用指南
- [SUMMARY.md](SUMMARY.md) - 功能总结

## 🎉 开始使用

```bash
# 1. 确保API Key已配置
cat .env

# 2. 启动服务
python api.py

# 3. 测试功能
python test_inspiration.py

# 4. 调用API
curl -X POST "http://localhost:8001/api/agent" \
  -H "Content-Type: application/json" \
  -d '{"query": "你的需求描述", "max_iterations": 15}'
```

开始创作吧！🚀