用途
Gemini Deep Research 用于执行复杂、长时间运行的研究任务，适合需要多来源综合、竞品分析等场景。它借助 Gemini 的 Deep Research Agent 完成复杂的上下文收集与综合任务。
主要能力
Deep Research 是一个代理，能够：
- 将复杂查询拆解为子问题
- 系统性地搜索网络
- 将发现综合成全面的报告
- 提供流式进度更新
使用方式
前置条件
需要 GEMINI_API_KEY 环境变量（来自 Google AI Studio）。
注意：此工具不适用于 Antigravity OAuth 令牌，需要直接的 Gemini API 密钥。
基本研究
scripts/deep_research.py --query "Research the history of Google TPUs"
自定义输出格式
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"
配合文件搜索（可选）
scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
--file-search-store "fileSearchStores/my-store-name"
流式进度
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 获取）
- 不适用于 Antigravity OAuth 认证
- 长时间运行的任务（根据复杂度从几分钟到几小时不等）
- 根据你的配额，可能会产生 API 费用