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

> Um agente de pesquisa multi-fase simplificado 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.

- Fonte: https://doutorai.pt/apps/research-agent-gemini-interaction-api
- Categoria: Agentes Avançados
- Dificuldade: Médio
- Modelos: Gemini
- Frameworks: -
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: Nenhuma
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🔬 Planeador e Executor de Pesquisa em 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

| Componente | Tecnologia |
|------------|------------|
| **Modelo de Planeamento** | `gemini-3-flash-preview` |
| **Agente de Pesquisa** | `deep-research-pro-preview-12-2025` |
| **Modelo de Síntese** | `gemini-3-pro-preview` |
| **Modelo de Infográfico** | `gemini-3-pro-image-preview` |
| **Framework de UI** | Streamlit |
| **SDK Python** | `google-genai` |

### Como Começar?

1. Clona o repositório do GitHub

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

```markdown
# 2. Instala as dependências necessárias:

```bash
pip install -r requirements.txt
```
```

```bash
pip install -r requirements.txt
```

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

- Regista-te para uma [conta do Google AI Studio](https://ai.google.dev/) e obtém a tua chave de API.

4. Executa a Aplicação Streamlit
```

```bash
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](https://ai.google.dev/gemini-api/docs/interactions)
- [Modelos Gemini](https://ai.google.dev/gemini-api/docs/models)
- [Google AI Studio](https://ai.google.dev/)

## 📄 Licença

Parte da coleção [Awesome LLM Apps](https://github.com/Shubhamsaboo/awesome-llm-apps).

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/research-agent-gemini-interaction-api