Agent Lupo — Demonstração CrewAI

Projeto didático desenvolvido para a mentoria ao vivo DIO.me + Lupo.
Construímos passo a passo um agente de atendimento ao cliente para franquias Lupo, evoluindo de um agente simples até uma solução completa com guardrails e escalada para humano.

---

O que você vai aprender

Versão	O que faz	Conceitos CrewAI
v1 — Agente Básico	Agente genérico de atendimento no terminal	Agent, Task, Crew
v2 — RAG com Dados Lupo	Personalidade da Lupo + busca em produtos reais	Tools, JSONSearchTool
v3 — Guardrails	Proteção contra tópicos sensíveis e prompt injection	guardrail, segurança
v4 — Escalada para Humano	Supervisor decide quando acionar um atendente real	Multi-agente, HITL

Cada versão é auto-contida: tem seu próprio README.md com tutorial, como rodar e exemplos de conversa.

---

Pré-requisitos

• Python 3.11+
• uv instalado
• Chave de API da OpenAI (obtenha aqui)

---

Instalação

# 1. Clone o repositório
git clone https://github.com/dio-me/agent-lupo-demonstration.git
cd agent-lupo-demonstration

# 2. Instale as dependências
uv sync

# 3. Configure as variáveis de ambiente
cp .env.example .env
# Abra o arquivo .env e preencha com sua OPENAI_API_KEY

---

Como rodar cada versão

# Versão 1 — Agente Básico
cd v1_agente_basico
uv run python main.py

# Versão 2 — RAG com Dados Lupo
cd v2_rag_produtos
uv run python main.py

# Versão 3 — Guardrails
cd v3_guardrails
uv run python main.py

# Versão 4 — Escalada para Humano
cd v4_escalada_humano
uv run python main.py

Dica: Comece pela v1 e avance em ordem. Cada versão constrói sobre a anterior.

---

Estrutura do Projeto

agent-lupo-demonstration/
├── README.md                  ← você está aqui
├── .env.example               ← template de variáveis de ambiente
├── pyproject.toml             ← dependências do projeto
│
├── data/
│   ├── scraper.py             ← scraper do site luposport.com.br
│   ├── produtos.json          ← catálogo de produtos (gerado pelo scraper)
│   └── loja.json              ← informações da loja (endereço, horário, pgto, frete)
│
├── v1_agente_basico/
│   ├── README.md              ← tutorial da v1
│   └── main.py
│
├── v2_rag_produtos/
│   ├── README.md              ← tutorial da v2
│   ├── main.py
│   └── tools.py
│
├── v3_guardrails/
│   ├── README.md              ← tutorial da v3
│   ├── main.py
│   └── guardrails.py
│
└── v4_escalada_humano/
    ├── README.md              ← tutorial da v4
    ├── main.py
    └── escalation.py

---

Sobre o Caso de Uso

A Lupo é uma marca brasileira de roupas íntimas e esportivas com rede de franquias.
As franquias têm equipes pequenas (2 pessoas) e não conseguem oferecer atendimento 24h.

Este projeto simula a primeira camada de atendimento via WhatsApp/Instagram: o agente responde dúvidas comuns (produtos, preços, horário, endereço) e, quando necessário, passa o atendimento para um humano.

---

Tecnologias

• CrewAI — framework de agentes de IA
• OpenAI GPT-4o — modelo de linguagem
• uv — gerenciador de dependências Python

---

Projeto criado para a mentoria ao vivo DIO.me + Lupo.