# RAG Agentic com Pensamento Gemini Flash

> - Processamento de Documentos - Upload e processamento de documentos PDF - Extração de conteúdo de páginas web - Fragmentação automática de texto e embedding - Armazenamento vetorial na nuvem Qdrant.

- Fonte: https://doutorai.pt/apps/gemini-agentic-rag
- Categoria: RAG e Conhecimento
- Dificuldade: Médio
- Modelos: Gemini
- Frameworks: Agno, LangChain
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: GOOGLE_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🤔 Agentic RAG com Gemini Flash Thinking

Um sistema RAG Agentic construído com o novo modelo Gemini 2.0 Flash Thinking e gemini-exp-1206, Qdrant para armazenamento de vetores, e Agno (phidata prev) para orquestração de agentes. Esta aplicação apresenta reescrita inteligente de consultas, processamento de documentos e capacidades de fallback de pesquisa na web para fornecer respostas abrangentes potenciadas por IA.

## Funcionalidades

- **Processamento de Documentos**
  - Upload e processamento de documentos PDF
  - Extração de conteúdo de páginas web
  - Divisão automática de texto e incorporação
  - Armazenamento de vetores na nuvem Qdrant

- **Consulta Inteligente**
  - Reescrita de consultas para melhor recuperação
  - Recuperação de documentos baseada em RAG
  - Pesquisa de similaridade com filtragem por limiar
  - Fallback automático para pesquisa na web
  - Atribuição de fontes para respostas

- **Capacidades Avançadas**
  - Integração de pesquisa web Exa AI
  - Filtragem de domínio personalizado para pesquisa na web
  - Geração de respostas contextualizadas
  - Gestão do histórico de conversas
  - Agente de reformulação de consultas

- **Funcionalidades Específicas do Modelo**
  - Gemini Thinking 2.0 Flash para chat e raciocínio
  - Modelo de Incorporação Gemini para incorporações de vetores
  - Framework Agno Agent para orquestração
  - Interface interativa baseada em Streamlit

## Pré-requisitos

### 1. Chave de API do Google
1. Vai a [Google AI Studio](https://aistudio.google.com/apikey)
2. Regista-te ou faz login na tua conta
3. Cria uma nova chave de API

### 2. Configuração da Nuvem Qdrant
1. Visita [Qdrant Cloud](https://cloud.qdrant.io/)
2. Cria uma conta ou faz login
3. Cria um novo cluster
4. Obtém as tuas credenciais:
   - Chave de API Qdrant: Encontrada na secção de Chaves de API
   - URL Qdrant: A URL do teu cluster (formato: `https://xxx-xxx.cloud.qdrant.io`)

### 3. Chave de API Exa AI (Opcional)
1. Visita [Exa AI](https://exa.ai)
2. Regista-te para uma conta
3. Gera uma chave de API para capacidades de pesquisa na web

## Como Executar

1. Clona o repositório:

```bash
git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd rag_tutorials/gemini_agentic_rag
```

```markdown
# 2. Instalar dependências:

Para instalar as dependências necessárias, executa o seguinte comando:

```bash
npm install
```
```

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

```markdown
# 3. Executa a aplicação:

Para executar a aplicação, utiliza o seguinte comando:

```bash
npm start
```

A aplicação estará disponível em `http://localhost:3000`.

## 3.1. Parar a aplicação

Para parar a aplicação, utiliza `Ctrl + C` no terminal onde a aplicação está a ser executada.

## 3.2. Aceder à aplicação

Abre o teu navegador e vai até `http://localhost:3000` para aceder à aplicação.

## 3.3. Problemas comuns

Se encontrares problemas ao executar a aplicação, verifica os seguintes pontos:

- Certifica-te de que todas as dependências estão instaladas.
- Verifica se a porta 3000 não está a ser utilizada por outra aplicação.
- Consulta os logs do terminal para mensagens de erro.
```

```bash
streamlit run agentic_rag_gemini.py
```

## Utilização

1. Configura as chaves da API na barra lateral:
   - Introduz a tua chave da API do Google
   - Adiciona as credenciais do Qdrant
   - (Opcional) Adiciona a chave do Exa AI para pesquisa na web

2. Carrega documentos:
   - Usa o carregador de ficheiros para PDFs
   - Introduz URLs para conteúdo da web

3. Faz perguntas:
   - Escreve a tua consulta na interface de chat
   - Vê consultas reescritas e fontes
   - Consulta os resultados da pesquisa na web quando relevante

4. Gerir a tua sessão:
   - Limpa o histórico de chat conforme necessário
   - Configura domínios de pesquisa na web
   - Monitoriza documentos processados

## 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/gemini-agentic-rag