================================================================================
SOLUCIÓN: ERROR 404 CON MODELOS GEMINI
================================================================================

## PROBLEMA

Al usar Gemini obtienes este error:

  Error en evaluación de Gemini: 404 NOT_FOUND. 
  {'error': {'code': 404, 'message': 'models/gemini-1.5-flash is not found 
  for API version v1beta'}}

## CAUSA

Los modelos de la serie 1.5 (gemini-1.5-pro, gemini-1.5-flash, etc.) están
DEPRECADOS desde 2025 y ya NO están disponibles en la API de Google.

## SOLUCIÓN

Cambia a los modelos actuales de la serie 2.5 o 3.0.

### OPCIÓN 1: Cambiar en .env (RECOMENDADO)

Edita tu archivo .env y cambia o agrega:

```
GEMINI_JUDGE_MODEL=gemini-2.5-flash
```

Modelos recomendados:
- gemini-2.5-pro → Mejor calidad, más caro
- gemini-2.5-flash → Balance precio-calidad (RECOMENDADO)
- gemini-2.5-flash-lite → Más rápido y barato

### OPCIÓN 2: Cambiar en behave.ini

Edita tu archivo behave.ini:

```ini
[behave.userdata]
GEMINI_API_KEY=tu_api_key_aqui
GEMINI_JUDGE_MODEL=gemini-2.5-flash
```

### OPCIÓN 3: Variable de entorno

En tu terminal (antes de ejecutar tests):

Windows (CMD):
```cmd
set GEMINI_JUDGE_MODEL=gemini-2.5-flash
```

Windows (PowerShell):
```powershell
$env:GEMINI_JUDGE_MODEL="gemini-2.5-flash"
```

Linux/Mac:
```bash
export GEMINI_JUDGE_MODEL=gemini-2.5-flash
```

## MODELOS VÁLIDOS (2025)

### PRODUCCIÓN (Stable)

✅ gemini-2.5-pro
   - Más inteligente
   - Mejor para evaluaciones complejas
   - Costo: Medio-Alto

✅ gemini-2.5-flash (RECOMENDADO)
   - Balance perfecto
   - Rápido y económico
   - Costo: Bajo

✅ gemini-2.5-flash-lite
   - Más rápido
   - Más barato
   - Costo: Muy bajo

### EXPERIMENTAL (Preview)

✅ gemini-3-pro-preview
   - Lo más avanzado
   - Puede cambiar sin aviso
   - Costo: Alto

✅ gemini-3-flash-preview
   - Rápido y avanzado
   - Puede cambiar sin aviso
   - Costo: Medio

### DEPRECADOS (NO USAR)

❌ gemini-1.5-pro → Error 404
❌ gemini-1.5-pro-002 → Error 404
❌ gemini-1.5-flash → Error 404
❌ gemini-1.5-flash-002 → Error 404
❌ gemini-1.5-pro-latest → Error 404

## VERIFICAR QUE FUNCIONA

Después de cambiar el modelo, ejecuta un test simple:

```gherkin
Feature: Test Gemini
  Scenario: Verificar modelo
    Given el contexto de reglas de negocio "test" está cargado desde el archivo "test.txt"
    When establezco la respuesta del SUT como "Esta es una prueba"
    Then el Juez Gemini debe validar la respuesta con un umbral mínimo de 0.5
```

Si ves en la consola:
  🤖 Modelo: gemini-2.5-flash (o el que configuraste)
  
¡Funciona correctamente!

## ACTUALIZACIÓN DEL FRAMEWORK

El framework ya fue actualizado para usar gemini-2.5-pro por defecto.

Si no especificas ningún modelo, automáticamente usará gemini-2.5-pro.

## PREGUNTAS FRECUENTES

P: ¿Por qué Google deprecó los modelos 1.5?
R: Para enfocarse en los modelos más nuevos y eficientes de las series 2.5 y 3.0.

P: ¿Los modelos 2.5 son mejores que los 1.5?
R: Sí, son más rápidos, más inteligentes y más económicos.

P: ¿Necesito cambiar mi código?
R: No, solo cambiar el nombre del modelo en la configuración.

P: ¿Cuánto cuesta gemini-2.5-flash comparado con 1.5-flash?
R: Similar o más barato, con mejor rendimiento.

P: ¿Puedo seguir usando gemini-1.5-pro-002?
R: No, dará error 404. Debes migrar a 2.5 o 3.0.

## REFERENCIAS

- Documentación oficial: https://ai.google.dev/gemini-api/docs/models/gemini
- Precios: https://ai.google.dev/pricing
- Guía de migración: https://ai.google.dev/gemini-api/docs/migrate-to-gemini

================================================================================
Última actualización: Febrero 2025
================================================================================
