Agente Planeador e Executor de Pesquisa de IA com a API de Interações do Google

Um agente de pesquisa multi-fases otimizado, construído com a API de Interações do Google, que demonstra conversas com estado, mistura de modelos, execução em segundo plano e geração automática de infográficos.

🌟 Funcionalidades

• 📋 Fase 1 - Planeamento de Pesquisa: Utiliza Gemini 3 Flash para criar planos de pesquisa estruturados e acionáveis
• 🔍 Fase 2 - Seleção de Tarefas & Pesquisa Profunda: Seleciona tarefas específicas e aproveita o Agente de Pesquisa Profunda com pesquisa na web integrada
• 📊 Fase 3 - Síntese + TL;DR: Utiliza Gemini 3 Pro para relatórios executivos + Gemini 3 Pro Image para geração automática de infográficos
• 🎨 Infográficos Gerados Automaticamente: Cria um resumo estilo quadro branco TL;DR no topo de cada relatório
• 🔄 Conversas com Estado: Demonstra previous_interaction_id para manter o contexto entre fases
• ⚡ Execução em Segundo Plano: Execução de pesquisa assíncrona com acompanhamento de progresso
• 📥 Exportar Relatórios: Descarrega relatórios de pesquisa abrangentes como ficheiros markdown

🎯 Como Funciona

User Goal
    ↓
[Phase 1] Gemini 3 Flash → Research Plan
    ↓
[Phase 2] Select Tasks → Deep Research Agent → Research Results
    ↓
[Phase 3] Gemini 3 Pro → Executive Report
         + Gemini 3 Pro Image → TL;DR Infographic

Fase 1: Planeamento

1. Introduz o teu objetivo de pesquisa
2. Gemini 3 Flash cria um plano de pesquisa numerado com 5-8 tarefas específicas
3. O plano é armazenado como uma Interaction para continuidade com estado

Fase 2: Selecionar & Pesquisar

1. Revê o plano de pesquisa com caixas de verificação para cada tarefa
2. Seleciona/deseleciona tarefas para focar a tua pesquisa
3. Deep Research Agent executa uma pesquisa web abrangente utilizando previous_interaction_id

Fase 3: Síntese + Infográfico

1. Gemini 3 Pro sintetiza as descobertas num relatório executivo
2. Gemini 3 Pro Image gera automaticamente um infográfico TL;DR em quadro branco
3. O relatório é exibido com o infográfico no topo, seguido do texto completo
4. Faz o download como markdown

🛠️ Stack Tecnológico

Como Começar?

1. Clona o repositório do GitHub

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd advanced_ai_agents/single_agent_apps/research_agent_gemini_interaction_api

2. Instala as dependências necessárias:

pip install -r requirements.txt

pip install -r requirements.txt

3. Obtém a tua Chave de API do Google

• Regista-te para uma conta do Google AI Studio e obtém a tua chave de API.

4. Executa a Aplicação Streamlit

streamlit run research_planner_executor_agent.py

5. Abre o teu navegador em http://localhost:8501

6. Introduz a tua chave de API do Google na barra lateral e começa a pesquisar!

📝 Exemplos de Objetivos de Pesquisa

• "Pesquisar o mercado de SaaS de RH B2B na Alemanha - principais players, regulamentações, modelos de preços"
• "Analisar oportunidades de mercado para ferramentas de suporte ao cliente potenciadas por IA"
• "Investigar o panorama competitivo para embalagens sustentáveis no e-commerce"
• "Pesquisar requisitos regulamentares para produtos fintech direcionados à Gen Z"

⚠️ Notas

• API Beta: A API de Interações está em Beta - as funcionalidades podem mudar
• Pesquisa Profunda: Pode demorar 2-5 minutos para uma pesquisa abrangente
• Agente vs Modelo: A Pesquisa Profunda utiliza o parâmetro agent, não model
• Geração de Imagens: A geração de infográficos utiliza a API padrão generate_content

🔗 Recursos

• Documentação da API de Interações Gemini
• Modelos Gemini
• Google AI Studio

📄 Licença

Parte da coleção Awesome LLM Apps.