# 🚀 从这里开始

## 你现在拥有什么？

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

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

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

## 🎯 立即开始（3步）

### 1️⃣ 配置API Key

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

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

### 2️⃣ 安装依赖

```bash
pip install -r requirements.txt
```

### 3️⃣ 测试运行

```bash
python test_agent.py
```

## 💡 使用示例

### 示例1：分析游戏类视频

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

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

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

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

### 示例3：分析特定关键词

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

## 🎨 自定义Agent行为

### 核心文件：`prompts/agent_prompt.md`

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

```markdown
## 工作流程

### 2. 制定执行计划

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

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

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

## 🔧 添加新功能

### 在 `ai_agent.py` 中添加新工具：

```python
# 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` 中添加使用场景：

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

## 📚 文档导航

### 快速开始
- **[SUMMARY.md](SUMMARY.md)** ⭐ - 功能总结和核心概念
- **[AGENT_QUICKSTART.md](AGENT_QUICKSTART.md)** - 30秒上手Agent

### 详细文档
- **[README_AGENT.md](README_AGENT.md)** - Agent完整文档
- [README_AI.md](README_AI.md) - AI分析功能文档
- [PROJECT_OVERVIEW.md](PROJECT_OVERVIEW.md) - 项目总览

### 配置和测试
- [QUICKSTART.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：测试脚本（推荐新手）
```bash
python test_agent.py
```

### 方式2：命令行
```bash
python ai_agent.py --query "你的查询"
```

### 方式3：API服务（推荐生产）
```bash
python api.py
# 访问 http://localhost:8001/docs
```

## 🆘 需要帮助？

1. 查看 [SUMMARY.md](SUMMARY.md) 了解核心概念
2. 查看 [README_AGENT.md](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. ✅ 集成到你的应用

开始探索吧！🎊