Habilidade de Pesquisa Profunda do Gemini

Quando Usar

• Use quando uma pergunta precisar de pesquisa autônoma em várias etapas com fontes citadas (análise de mercado, revisões de literatura, varreduras competitivas)
• Use quando quiser iniciar uma execução de Pesquisa Profunda do Gemini, acompanhar o progresso e coletar o relatório final
• Use quando uma pesquisa rápida na web não for suficiente e um relatório estruturado e baseado em fontes for necessário

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

Requisitos

• Python 3.8+
• httpx: pip install -r requirements.txt
• Variável de ambiente GEMINI_API_KEY

Configuração

1. Obtenha uma chave de API do Gemini no Google AI Studio
2. Defina a variável de ambiente:

   export GEMINI_API_KEY=your-api-key-here
   

   Ou crie um arquivo .env no diretório da habilidade.

Portão de Segurança

Antes de iniciar uma tarefa de pesquisa, mostre ao usuário a consulta exata, o fato de que ela será enviada ao serviço Gemini do Google, a faixa de custo esperada e o destino da saída. Inicie uma tarefa somente após aprovação explícita. Não inclua material de espaço de trabalho privado, credenciais, dados pessoais ou informações confidenciais de clientes em uma consulta.

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 pesquisas anteriores

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 paisagismo competitivo
• Revisões de literatura técnica
• Pesquisa de due diligence
• Pesquisa histórica e cronologias
• Análise comparativa (frameworks, produtos, tecnologias)

Fluxo de Trabalho

1. Usuário solicita pesquisa → Executar --query "..."
2. Informar ao usuário o tempo estimado (2-10 minutos)
3. Monitorar com --stream ou consultar com --status
4. Retornar resultados formatados
5. Usar --continue para perguntas de acompanhamento

Códigos de Saída

• 0: Sucesso
• 1: Erro (erro de API, problema de configuração, tempo limite)
• 130: Cancelado pelo usuário (Ctrl+C)

Limitações

• Cada tarefa de pesquisa é uma solicitação paga de API de terceiros; custos e disponibilidade podem mudar, e a estimativa listada não é uma autorização de gastos.
• Relatórios podem conter citações incompletas, desatualizadas ou incorretas. Verifique as alegações consequentes com fontes primárias.
• Esta habilidade não pode garantir que um prompt seja seguro para divulgação; redija material proprietário ou pessoal antes de solicitar a aprovação do usuário.
• Uma chave de API deve permanecer local e nunca deve ser confirmada, impressa ou enviada em uma consulta.