Habilidade de Pesquisa Profunda do Gemini

Execute tarefas de pesquisa autônomas que planejam, buscam, leem e sintetizam informações em relatórios abrangentes.

Quando Usar Esta Habilidade

Use esta habilidade quando:

• Realizando análise de mercado
• Conduzindo mapeamento competitivo
• Criando revisões de literatura
• Fazendo pesquisa técnica
• Realizando due diligence
• Precisar de relatórios de pesquisa detalhados e citados

Requisitos

• Python 3.9+ (o helper recuperado usa tipagem moderna do Python)
• Dependência HTTP revisada: instale requirements.txt em um ambiente específico do projeto e bloqueie suas versões resolvidas; não instale globalmente por padrão
• Variável de ambiente GEMINI_API_KEY

Configuração

1. Use uma conta/chave Gemini autorizada existente ou obtenha aprovação explícita da conta/configuração primeiro. Nunca cole uma chave ativa no chat ou a cometa. Verifique o preço atual da API, acesso do agente e uso na documentação do Google Deep Research.
2. Defina a variável de ambiente:

   : "${GEMINI_API_KEY:?Inject through the approved host secret manager}"
   export GEMINI_API_KEY
   export DEEP_RESEARCH_CACHE_DIR="<absolute private task cache directory>"
   export DEEP_RESEARCH_TIMEOUT="600"
   export DEEP_RESEARCH_POLL_INTERVAL="10"
   

   O helper não carrega arquivos .env silenciosamente nem procura credenciais em diretórios pais. Forneça o ambiente através do host aprovado; o cache explícito apenas para o proprietário armazena IDs/status de interação, não texto de consulta. Seu diretório pai confiável não é um sandbox contra alterações maliciosas concorrentes no sistema de arquivos.

O research.py recuperado, o manifesto e a licença estão agrupados; a proveniência e as modificações estão em UPSTREAM-NOTICE.md. Os caminhos da CLI são relativos à raiz instalada desta habilidade. --help e o histórico local não criam pesquisas na nuvem.

Uso

Iniciar uma tarefa de pesquisa

python3 scripts/research.py --query "Research the history of Kubernetes"

Com formato de saída estruturado

python3 scripts/research.py --query "Compare Python web frameworks" \
  --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"

Transmitir progresso em tempo real

python3 scripts/research.py --query "Analyze EV battery market" --stream

Iniciar sem esperar

python3 scripts/research.py --query "Research topic" --no-wait

Verificar o status da pesquisa em andamento

python3 scripts/research.py --status <interaction_id>

Aguardar a conclusão

python3 scripts/research.py --wait <interaction_id>

Continuar a partir de pesquisa anterior

python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id>

Listar pesquisas recentes

python3 scripts/research.py --list

Formatos de Saída

• Padrão: Relatório em markdown legível por humanos
• JSON (--json): Dados estruturados para uso programático
• Bruto (--raw): Resposta da API não processada

Custo e Tempo

Melhores Casos de Uso

• Análise de mercado e mapeamento competitivo
• Revisões de literatura técnica
• Pesquisa de due diligence
• Pesquisa histórica e linhas do tempo
• Análise comparativa (frameworks, produtos, tecnologias)

Fluxo de Trabalho

1. Confirme o provedor selecionado, os dados/consulta aprovados e o escopo de gastos antes de enviar uma tarefa de pesquisa paga; uma solicitação de pesquisa genérica não exige este provedor externo
2. Registre o ID de interação retornado imediatamente; a duração e o custo variam
3. Monitore com --stream ou consulte com --status
4. Retorne os resultados formatados
5. Use --continue para perguntas de acompanhamento

Códigos de Saída

• 0: Sucesso
• 1: Erro (erro de API, problema de configuração, tempo limite)
• 130: Espera local interrompida; isso não cancela o trabalho remoto

Limitações

• O helper visa o agente atual documentado deep-research-preview-04-2026 e os formatos de etapa/SSE de Interações, mantendo um fallback explícito de saída legado. APIs de pré-visualização podem mudar; verifique a compatibilidade oficial atual e não afirme que a revisão de origem/fixture é um teste de provedor ativo.

…