Simulador de Batalha de Negociação de IA

Um Confronto em Tempo Real entre Agentes com AG-UI!

Assiste a dois agentes de IA a batalharem numa épica negociação de carros usados! Construído com Google ADK para os agentes de backend e AG-UI + CopilotKit para um frontend reativo de cortar a respiração.

✨ Funcionalidades

• 🤖 Agentes de IA Duais: Comprador vs Vendedor com personalidades e estratégias de negociação distintas
• 🔄 Protocolo AG-UI: Streaming em tempo real das ações dos agentes, chamadas de ferramentas e alterações de estado
• 💅 UI de Cortar a Respiração: Arena de batalha animada com linha do tempo de negociação ao vivo
• 🎭 8 Personalidades Únicas: 4 compradores + 4 vendedores com diferentes estilos de negociação
• 📊 UI Generativa: Componentes React personalizados renderizam chamadas de ferramentas em tempo real
• 🔗 Estado Partilhado: O estado do agente sincroniza bidirecionalmente com o frontend

🏗️ Arquitetura

┌─────────────────────────────────────────────────────────────────┐
│                    Next.js + CopilotKit Frontend                │
│   ┌─────────────┐    ┌──────────────┐    ┌─────────────┐        │
│   │ Battle Arena│    │  VS Display  │    │Chat Sidebar │        │
│   │   Timeline  │    │ Buyer/Seller │    │ (AG-UI)     │        │
│   └──────┬──────┘    └──────────────┘    └──────┬──────┘        │
└──────────┼────────────────────────────────────────┼─────────────┘
           │              AG-UI Events              │
           └────────────────────┬───────────────────┘
                                │
                    ┌───────────▼───────────┐
                    │   CopilotKit Runtime  │
                    │   (/api/copilotkit)   │
                    └───────────┬───────────┘
                                │ HTTP/SSE
                    ┌───────────▼───────────┐
                    │    FastAPI + AG-UI    │
                    │    ADK Middleware     │
                    └───────────┬───────────┘
                                │
                    ┌───────────▼─────────────┐
                    │  ADK Negotiation Agent  │
                    │  (Battle Master)        │
                    │                         │
                    │  Tools:                 │
                    │  • configure_negotiation│
                    │  • start_negotiation    │
                    │  • buyer_make_offer     │
                    │  • seller_respond       │
                    └─────────────────────────┘

🚀 Início Rápido

Pré-requisitos

• Python 3.11+
• Node.js 18+
• Chave da API do Google AI (Obtém uma aqui)

1. Clona e Navega

git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
cd advanced_ai_agents/multi_agent_apps/ai_negotiation_battle_simulator

2. Configurar o Backend

cd backend
pip install -r requirements.txt

# Create .env file
echo "GOOGLE_API_KEY=your_api_key_here" > .env

# Start the backend
python agent.py

O backend irá iniciar em http://localhost:8000

3. Configurar o Frontend

cd frontend
npm install

# Start the frontend
npm run dev

A interface irá iniciar em http://localhost:3000

4. Começa a Negociar! 🎮

Abre http://localhost:3000 e diz ao Mestre da Batalha:

• "Inicia uma negociação por um carro usado"
• "Mostra-me os cenários disponíveis"
• "Usa Desperate Dan como comprador e Shark Steve como vendedor"

🎭 Personalidades

Compradores

Vendedores

📁 Estrutura do Projeto

ai_negotiation_battle_simulator/
├── README.md
├── .env.example
│
├── backend/                    # Python ADK + AG-UI
│   ├── agent.py               # Main agent with tools
│   ├── requirements.txt
│   ├── config/
│   │   ├── personalities.py   # 8 unique personalities
│   │   └── scenarios.py       # 3 negotiation scenarios
│   └── agents/
│       ├── buyer_agent.py
│       ├── seller_agent.py
│       └── orchestrator.py
│
└── frontend/                   # Next.js + CopilotKit
    ├── package.json
    ├── src/
    │   └── app/
    │       ├── layout.tsx     # CopilotKit provider
    │       ├── page.tsx       # Battle Arena UI
    │       ├── globals.css    # Battle animations
    │       └── api/
    │           └── copilotkit/
    │               └── route.ts  # CopilotKit runtime
    └── tailwind.config.js

🎬 Batalha de Amostra

🔔 NEGOTIATION BEGINS: 2019 Honda Civic EX

📋 ASKING PRICE: $15,500

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

😎 COOL-HAND CASEY (Round 1):
"I've seen similar Civics go for less. $11,500 seems fair 
given the market. Cash in hand today."

🦈 SHARK STEVE (Round 1):
"$15,000. This car is pristine. I've got two other 
interested buyers coming this weekend."

😎 COOL-HAND CASEY (Round 2):
"$12,500 is my limit. Take it or I walk."

🦈 SHARK STEVE (Round 2):
*considers* "$14,000. Final offer."

😎 COOL-HAND CASEY (Round 3):
"$13,000. Meet me in the middle."

🦈 SHARK STEVE (Round 3):
"...$13,500 and you've got a deal."

😎 COOL-HAND CASEY (Round 4):
"$13,250. Final answer."

🦈 SHARK STEVE (Round 4):
"Deal. 🤝"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ DEAL CLOSED AT $13,250 🎉
   Buyer saved: $2,250 (14.5% off asking)

🧠 Como Funciona

1. Pedido do Utilizador: Tu dizes ao Battle Master que tipo de negociação realizar
2. Configuração: O agente configura o cenário e as personalidades
3. Chamadas de Ferramenta: O agente alterna entre as ferramentas buyer_make_offer e seller_respond
4. Streaming AG-UI: Cada chamada de ferramenta é transmitida para o frontend através do protocolo AG-UI
5. UI Generativa: Componentes React personalizados apresentam cada oferta/resposta de forma bonita
6. Estado Partilhado: A linha do tempo da negociação é atualizada em tempo real
7. Resultado: O acordo ou não-acordo é celebrado com animações!

📚 Saber Mais

• Documentação do Google ADK
• Documentos do Protocolo AG-UI
• Documentação do CopilotKit

🤝 Contribuições

Sente-te à vontade para adicionar:

• Novos cenários de negociação (salário, apartamento, contratos)
• Tipos de personalidades adicionais
• Efeitos de UI mais dramáticos
• Agentes inter-framework (LangChain, CrewAI via A2A)

Que o melhor negociador vença! 🏆