介绍
# Gemini Deep Research
使用 Gemini 的 Deep Research Agent 执行复杂的、长时间运行的上下文收集和综合任务。
## 前置条件
- `GEMINI_API_KEY` 环境变量（来自 Google AI Studio） - **注意**：这不适用于 Antigravity OAuth 令牌。需要直接的 Gemini API 密钥。
## 工作原理
Deep Research 是一个代理，它： 1. 将复杂查询分解为子问题 2. 系统性地搜索网络 3. 将发现综合成全面的报告 4. 提供流式进度更新
## 用法
### 基础研究
```bash scripts/deep_research.py --query "Research the history of Google TPUs" ```
### 自定义输出格式
```bash scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \ --format "1. Executive Summary\n2. Key Players (include data table)\n3. Supply Chain Risks" ```
### 使用文件搜索（可选）
```bash scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \ --file-search-store "fileSearchStores/my-store-name" ```
### 流式进度
```bash scripts/deep_research.py --query "Your research topic" --stream ```
## 输出
脚本会将结果保存到带时间戳的文件中： - `deep-research-YYYY-MM-DD-HH-MM-SS.md` - Markdown 格式的最终报告 - `deep-research-YYYY-MM-DD-HH-MM-SS.json` - 完整的交互元数据
## API 详情
- **端点**：`https://generativelanguage.googleapis.com/v1beta/interactions` - **代理**：`deep-research-pro-preview-12-2025` - **认证**：`x-goog-api-key` 请求头（非 OAuth Bearer 令牌）
## 限制
- 需要 Gemini API 密钥（从 [Google AI Studio](https://aistudio.google.com/apikey) 获取） - 不适用于 Antigravity OAuth 身份验证 - 长时间运行的任务（根据复杂度持续数分钟到数小时） - 可能会产生 API 费用，具体取决于您的配额