Gemini深度研究

使用Gemini的深度研究代理来执行复杂的、长时间运行的上下文收集与综合任务。

先决条件

• GEMINI_API_KEY环境变量（来自Google AI Studio）
• 注意：此功能不适用于Antigravity OAuth令牌。需要直接的Gemini API密钥。

工作原理

深度研究是一个代理，它能够：

1. 将复杂查询分解为子问题
2. 系统地搜索网络
3. 将发现综合成全面的报告
4. 提供流式进度更新

用法

基础研究

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 费用