Data_Source/START_HERE.md

🚀 从这里开始

你现在拥有什么？

一个AI Agent智能代理系统，可以：

1. 用自然语言描述需求
2. AI自动理解并执行
3. 自动获取抖音数据
4. 自动分析数据
5. 给出专业建议

最重要的是：只需修改提示词文件就能控制整个流程！

🎯 立即开始（3步）

1️⃣ 配置API Key

# 编辑 .env 文件，填入你的阿里云百炼API Key
DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxx

获取API Key: https://dashscope.console.aliyun.com/

2️⃣ 安装依赖

pip install -r requirements.txt

3️⃣ 测试运行

python test_agent.py

💡 使用示例

示例1：分析游戏类视频

# 启动API服务
python api.py

# 在另一个终端调用
curl -X POST "http://localhost:8001/api/agent" \
  -H "Content-Type: application/json" \
  -d '{"query": "帮我分析一下游戏类视频的热门趋势"}'

示例2：获取美食创作建议

curl -X POST "http://localhost:8001/api/agent" \
  -H "Content-Type: application/json" \
  -d '{"query": "我想做美食相关的内容，给我一些建议"}'

示例3：分析特定关键词

curl -X POST "http://localhost:8001/api/agent" \
  -H "Content-Type: application/json" \
  -d '{"query": "王者荣耀的视频现在什么内容最火？"}'

🎨 自定义Agent行为

核心文件：prompts/agent_prompt.md

这个文件控制Agent的所有行为！

## 工作流程

### 2. 制定执行计划

**场景A：用户提到明确的分类**
- 使用 `get_creative_guidance` 获取数据
- 使用 `analyze_video_data` 分析
- 总结并给出建议

**场景B：你的自定义场景**
- 你的自定义逻辑
- ...

修改这个文件，Agent就会按照你的逻辑执行！

🔧 添加新功能

在 ai_agent.py 中添加新工具：

# 1. 定义工具函数
async def your_tool(param: str) -> Dict:
    # 你的实现
    return {"success": True, "data": ...}

# 2. 在 create_agent() 中注册
agent.register_tool(
    name="your_tool",
    func=your_tool,
    description="工具描述（AI会根据这个决定何时使用）",
    parameters={...}
)

在 prompts/agent_prompt.md 中添加使用场景：

**场景X：用户需要XXX**
- 使用 `your_tool` 做XXX
- ...

📚 文档导航

快速开始

• SUMMARY.md ⭐ - 功能总结和核心概念
• AGENT_QUICKSTART.md - 30秒上手Agent

详细文档

• README_AGENT.md - Agent完整文档
• README_AI.md - AI分析功能文档
• PROJECT_OVERVIEW.md - 项目总览

配置和测试

• QUICKSTART.md - 基础功能快速开始
• test_agent.py - Agent测试脚本
• test_ai_analysis.py - AI分析测试脚本

🎯 核心文件

必须了解

• prompts/agent_prompt.md - 控制Agent行为
• ai_agent.py - Agent核心实现
• api.py - API服务

配置文件

• .env - API Key配置
• douyin_data_soupce/douyin_cookie.json - 抖音Cookie

💡 工作原理

用户输入: "帮我分析游戏类视频"
    ↓
AI理解意图: 需要游戏分类数据
    ↓
AI选择工具: get_creative_guidance
    ↓
执行工具: 获取50个游戏视频
    ↓
AI选择工具: analyze_video_data
    ↓
执行工具: 分析数据
    ↓
AI生成答案: 包含趋势、建议等
    ↓
返回给用户

✨ 核心优势

1. 自然语言交互 - 不需要学习API，直接说需求
2. 自主决策 - AI自动选择工具和执行顺序
3. 提示词驱动 - 修改提示词就能改变行为
4. 易于扩展 - 轻松添加新工具

🎉 开始使用

方式1：测试脚本（推荐新手）

python test_agent.py

方式2：命令行

python ai_agent.py --query "你的查询"

方式3：API服务（推荐生产）

python api.py
# 访问 http://localhost:8001/docs

🆘 需要帮助？

1. 查看 SUMMARY.md 了解核心概念
2. 查看 README_AGENT.md 了解详细功能
3. 运行 python test_agent.py 测试功能
4. 访问 http://localhost:8001/docs 查看API文档

🚀 下一步

1. ✅ 测试基础功能: python test_agent.py
2. ✅ 自定义提示词: 编辑 prompts/agent_prompt.md
3. ✅ 添加新工具: 在 ai_agent.py 中添加
4. ✅ 集成到你的应用

开始探索吧！🎊