名称： gemini-deep-research
描述： 使用 Gemini 深度研究代理执行复杂、耗时的研究任务。适用于需要多源信息综合、竞品分析、市场调研或系统性网络搜索与分析的综合技术调查。
元数据： {"clawdbot":{"emoji":"🔬","requires":{"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY"}}

Gemini 深度研究

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

前提条件

• 设置 GEMINI_API_KEY 环境变量（从 Google AI Studio 获取）
• 注意：此功能不兼容 Antigravity OAuth 令牌，必须使用直接的 Gemini API 密钥。

工作原理

深度研究代理的工作流程如下：
1. 分解问题：将复杂查询拆分为子问题。
2. 系统搜索：在网络上进行系统性搜索。
3. 综合报告：将发现整合成全面的报告。
4. 进度更新：提供流式进度更新。

使用方法

基础研究

scripts/deep_research.py --query "研究 Google TPU 的发展历史"

自定义输出格式

scripts/deep_research.py --query "研究电动汽车电池的竞争格局" \
  --format "1. 执行摘要\n2. 主要参与者（包含数据表格）\n3. 供应链风险"

结合文件搜索（可选）

scripts/deep_research.py --query "将我们 2025 财年报告与当前公开网络新闻进行对比" \
  --file-search-store "fileSearchStores/我的存储名称"

流式输出进度

scripts/deep_research.py --query "您的研究主题" --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 调用费用