Data_Source/INSPIRATION_GUIDE.md

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

🎯 功能概述

这是一个基于AI的创作灵感生成系统，可以根据你的需求自动：

1. 理解你想创作的内容类型
2. 获取相关的热门视频数据
3. 生成9个具体可执行的创作灵感
4. 如果不满意，可以获取更多灵感

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

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

🚀 快速开始

方式1：API接口（推荐）

# 启动服务
python api.py

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

方式2：测试脚本

python test_inspiration.py

方式3：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个多样化的创作灵感

📊 输出格式

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

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

📊 数据来源：创作指导
📈 分析视频数量：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 参数：

generate_creative_inspirations(videos=..., user_query=..., count=12)  # 生成12个

添加新分类

在 ai_agent.py 的 extract_search_keywords 函数中添加：

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 - Agent完整文档
• PROMPTS_GUIDE.md - 提示词使用指南
• SUMMARY.md - 功能总结

🎉 开始使用

# 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}'

开始创作吧！🚀