70 lines
2.2 KiB
Markdown
70 lines
2.2 KiB
Markdown
|
---
|
|||
|
|
name: gemini-deep-research
|
|||
|
|
description: "使用Gemini深度研究代理执行复杂、长期的研究任务。在被要求研究需要多源综合、竞争分析、市场调研或全面技术调查的主题时使用，这些主题受益于系统的网络搜索和分析。"
|
|||
|
|
metadata: {"clawdbot":{"emoji":"🔬","requires":{"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY"}}
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Gemini Deep Research
|
|||
|
|
|
|||
|
|
Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks.
|
|||
|
|
|
|||
|
|
## Prerequisites
|
|||
|
|
|
|||
|
|
- `GEMINI_API_KEY` environment variable (from Google AI Studio)
|
|||
|
|
- **Note**: This does NOT work with Antigravity OAuth tokens. Requires a direct Gemini API key.
|
|||
|
|
|
|||
|
|
## How It Works
|
|||
|
|
|
|||
|
|
Deep Research is an agent that:
|
|||
|
|
1. Breaks down complex queries into sub-questions
|
|||
|
|
2. Searches the web systematically
|
|||
|
|
3. Synthesizes findings into comprehensive reports
|
|||
|
|
4. Provides streaming progress updates
|
|||
|
|
|
|||
|
|
## Usage
|
|||
|
|
|
|||
|
|
### Basic Research
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
scripts/deep_research.py --query "Research the history of Google TPUs"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Custom Output Format
|
|||
|
|
|
|||
|
|
```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"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### With File Search (optional)
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
|
|||
|
|
--file-search-store "fileSearchStores/my-store-name"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Stream Progress
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
scripts/deep_research.py --query "Your research topic" --stream
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Output
|
|||
|
|
|
|||
|
|
The script saves results to timestamped files:
|
|||
|
|
- `deep-research-YYYY-MM-DD-HH-MM-SS.md` - Final report in markdown
|
|||
|
|
- `deep-research-YYYY-MM-DD-HH-MM-SS.json` - Full interaction metadata
|
|||
|
|
|
|||
|
|
## API Details
|
|||
|
|
|
|||
|
|
- **Endpoint**: `https://generativelanguage.googleapis.com/v1beta/interactions`
|
|||
|
|
- **Agent**: `deep-research-pro-preview-12-2025`
|
|||
|
|
- **Auth**: `x-goog-api-key` header (NOT OAuth Bearer token)
|
|||
|
|
|
|||
|
|
## Limitations
|
|||
|
|
|
|||
|
|
- Requires Gemini API key (get from [Google AI Studio](https://aistudio.google.com/apikey))
|
|||
|
|
- Does NOT work with Antigravity OAuth authentication
|
|||
|
|
- Long-running tasks (minutes to hours depending on complexity)
|
|||
|
|
- May incur API costs depending on your quota
|