# Agente X vs Agente O: Jogo de Jogo da Velha

> Um jogo interativo de Jogo da Velha onde dois agentes de IA, alimentados por diferentes modelos de linguagem, competem entre si, construído sobre o Agno Agent Framework e Streamlit como interface.

- Fonte: https://doutorai.pt/apps/ai-tic-tac-toe-agent
- Categoria: Agentes de Jogos
- Dificuldade: Avançado
- Modelos: OpenAI, Claude, Gemini, Llama
- Frameworks: Agno, AutoGen/AG2, Ollama (local)
- Corre local?: Sim (Ollama)
- Chaves necessárias: ANTHROPIC_API_KEY, GOOGLE_API_KEY, GROQ_API_KEY, OPENAI_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

# 🎮 Agent X vs Agent O: Jogo do Gato

Um jogo interativo do Gato onde dois agentes de IA alimentados por diferentes modelos de linguagem competem entre si, construído sobre o Agno Agent Framework e Streamlit como interface de utilizador.

Este exemplo mostra como construir um jogo interativo do Gato onde agentes de IA competem entre si. A aplicação demonstra como:
- Coordenar múltiplos agentes de IA num jogo por turnos
- Utilizar diferentes modelos de linguagem para diferentes jogadores
- Criar uma interface web interativa com Streamlit
- Gerir o estado do jogo e a validação de movimentos
- Exibir o progresso do jogo em tempo real e o histórico de movimentos

## Funcionalidades
- Suporte a múltiplos modelos de IA (GPT-4, Claude, Gemini, etc.)
- Visualização do jogo em tempo real
- Rastreio do histórico de movimentos com estados do tabuleiro
- Seleção interativa de jogadores
- Gestão do estado do jogo
- Validação e coordenação de movimentos

## Como Executar? 

1. **Configurar o Ambiente**

```bash
   # Clone the repository
   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd advanced_ai_agents/autonomous_game_playing_agent_apps/ai_tic_tac_toe_agent

   # Install dependencies
   pip install -r requirements.txt
   ```

### 2. Instalar dependências

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

### 3. Configuração das Chaves da API

O jogo suporta múltiplos modelos de IA. Cria um ficheiro `.env` neste diretório e adiciona as tuas chaves da API:

1. **Cria um ficheiro `.env`:**

```bash
   # In the ai_tic_tac_toe_agent directory
   touch .env
   ```

```markdown
2. **Adiciona as tuas chaves de API ao ficheiro `.env`:**
```

```env
   # Required for OpenAI models (gpt-4o, o3-mini)
   OPENAI_API_KEY=your_actual_openai_api_key_here

   # Optional - for additional models
   ANTHROPIC_API_KEY=your_actual_anthropic_api_key_here  # For Claude models
   GOOGLE_API_KEY=your_actual_google_api_key_here        # For Gemini models
   GROQ_API_KEY=your_actual_groq_api_key_here           # For Groq models
   ```

> **Nota:** Substitui os valores de espaço reservado pelas tuas chaves de API reais. A aplicação mostrará mensagens de erro úteis se as chaves necessárias estiverem em falta.

### 4. Executa o Jogo

```shell
streamlit run app.py
```

- Abre [localhost:8501](http://localhost:8501) para ver a interface do jogo

## Como Funciona

O jogo consiste em três agentes:

1. **Agente Principal (Árbitro)**
   - Coordena o jogo
   - Valida os movimentos
   - Mantém o estado do jogo
   - Determina o resultado do jogo

2. **Dois Agentes Jogadores**
   - Fazem movimentos estratégicos
   - Analisam o estado do tabuleiro
   - Seguem as regras do jogo
   - Respondem aos movimentos do oponente

## Modelos Disponíveis

O jogo suporta vários modelos de IA:
- GPT-4o (OpenAI)
- GPT-o3-mini (OpenAI)
- Gemini (Google)
- Llama 3 (Groq)
- Claude (Anthropic)

## Funcionalidades do Jogo

1. **Tabuleiro Interativo**
   - Atualizações em tempo real
   - Rastreio visual dos movimentos
   - Exibição clara do estado do jogo

2. **Histórico de Movimentos**
   - Rastreio detalhado dos movimentos
   - Visualização do estado do tabuleiro
   - Linha do tempo das ações dos jogadores

3. **Controlo do Jogo**
   - Iniciar/Pausar o jogo
   - Reiniciar o tabuleiro
   - Selecionar modelos de IA
   - Ver histórico do jogo

4. **Análise de Desempenho**
   - Tempo dos movimentos
   - Rastreio de estratégias
   - Estatísticas do jogo

## 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/ai-tic-tac-toe-agent