用途:调用 Gemini 的 Deep Research Agent 完成复杂、长时间运行的情报收集与综合任务,适用于需要跨多个来源进行综合、竞品分析等的研究主题。该智能体会将复杂查询拆解为子问题,系统性地搜索网页,并把发现综合成一份完整报告。
主要能力:查询拆解、系统化网络搜索、结果综合成报告,以及可选的流式进度更新。
必要条件:需要 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;Agent 为 deep-research-pro-preview-12-2025;鉴权使用 x-goog-api-key 请求头,而非 OAuth Bearer 令牌。
限制:需要 Gemini API 密钥;不适用于 Antigravity OAuth 鉴权;任务运行时间较长(从数分钟到数小时,取决于复杂度);视配额情况可能产生 API 费用。
价格与具体计费方式:资料未提供。