O Que e Agentic RAG?
Em um RAG tradicional, o agente sempre busca no vector store. Em um Agentic RAG, o agente tem acesso a multiplas ferramentas (tools) e decide autonomamente qual usar baseado na query do usuario.
RAG Tradicional
- • Query → Sempre busca no Vector Store
- • Caminho fixo de retrieval
- • Nao diferencia tipos de query
- • Pode retornar chunks irrelevantes
Agentic RAG
- • Query → Agente analisa intencao
- • Escolhe: Vector, SQL, API ou File
- • Pode combinar multiplas fontes
- • Respostas mais precisas e economicas
Arquitetura do Agentic RAG
1. Classificador de Intencao
O agente analisa a query e classifica: e uma pergunta sobre documentos (vector), dados estruturados (SQL), arquivos especificos (file) ou informacao externa (API)?
2. Tool Selection
Baseado na classificacao, o agente seleciona a ferramenta apropriada via tool calling. Pode ser: vector_search, sql_query, file_read ou api_call.
3. Execucao Paralela
Para queries complexas, o agente pode chamar multiplas tools em paralelo e agregar os resultados antes de gerar a resposta final.
4. Resposta Contextualizada
Os dados retornados sao combinados com a query original para gerar uma resposta precisa e fundamentada.
Tools Tipicas em Agentic RAG
Vector Search Tool
Para queries semanticas sobre documentos nao estruturados.
description: "Busca semantica em documentos"
parameters:
- query: string
- top_k: number (default: 10)
- filter: object (opcional)
SQL Query Tool
Para queries sobre dados estruturados em banco de dados.
description: "Query SQL em Postgres/MySQL"
parameters:
- query: string (SQL seguro)
- database: string
File Read Tool
Para ler conteudo bruto de arquivos especificos.
description: "Le arquivo do Google Drive/S3"
parameters:
- file_id: string
- format: text|binary
API Call Tool
Para buscar dados externos via APIs REST.
description: "Chama API externa"
parameters:
- endpoint: string
- method: GET|POST
- body: object (opcional)
Casos de Uso Ideais
Enterprise Knowledge
Documentos + CRM + ERP integrados em um unico agente
Analytics Hibrido
Relatorios textuais + metricas SQL em uma resposta
Multi-Sistema
Dados internos + APIs externas combinados
Workflow para Download
Agentic RAG Agent
Workflow completo com agente que decide entre vector store, SQL, arquivos e APIs. Inclui classificador de intencao e tool calling integrado.
- Tool calling com 4 ferramentas
- Classificacao automatica de query
- Supabase como vector store
- Memoria de conversacao